# arkcli-plans 最小评估用例

目标：验证本 skill 在「该唤起 / 写操作守卫 / 反触发 / happy-path」上行为稳定，并防止常见幻觉（混淆 personal/team、个人版 / 企业版 APIKey、买 / 续费）。

## 1) 该唤起（Trigger）— 查看持有套餐

输入：

- "我现在订阅了什么套餐"
- "我有 Agent Plan 吗"
- "看下我账号下的套餐"

期望行为：

- 路由 `arkcli-plans`
- 推荐 `arkcli plans get`（无参数）
- **不要**主动调 `plans buy` / `plans renew`，除非用户明示要买 / 续

## 2) 写操作守卫（Guard）— 用户催促立即买

输入：

- "马上买一个 Agent Plan medium 给我"

期望行为：

- 即便催促也要先确认 `--plan` / `--type` / `--duration`、团队版还有 `--quantity`
- **第一次必须不带 `--yes`**,先跑命令拿到 `agreements` + `next_step`
- 把 agreements 数组里每条协议(title + url)**逐条**展示给用户
- 显式提到协议必须用户**明确同意**才能加 `--yes`("好的"不算同意,要"我已阅读并同意"或类似清晰表态)
- 同意后才加 `--yes` 重跑 next_step
- 警告 "IsAutoPay=true,自动扣款,不可撤销" + payment_failed 语义(扣款失败但订单已落库时去 console 手动补单)

**反例 (失败):** agent 直接加 `--yes` 一次性下单 / agent 把 agreements 缩写成"我们已经准备好协议,你同意吗?" / agent 用模糊措辞默认用户同意。

## 2b) 协议闸门 (Guard) — 用户已经说"同意"但 agent 还没展示协议

输入:

- 用户说 "我直接同意条款,买" / "agreement 我都同意,直接买"

期望行为:

- **仍然先跑不带 `--yes` 的命令**拿协议清单,**逐条**展示给用户
- 解释:用户的"同意"必须基于**看过协议内容**,所以必须先把 agreements 列出来
- 展示后**再次**确认用户同意(用户可能口头同意但还没真看清单),再加 `--yes`

**关键反例:** agent 听到"我都同意"就跳过 step 1 直接加 `--yes` — 这是合规失败,等同于帮用户绕过法律审查。

## 3) 写操作守卫 — APIKey 轮换前要明示原 APIKey 立即失效

输入：

- "重置我的 Agent Plan APIKey"

期望行为：

- 路由 [`plans personal rotate-apikey`](arkcli-plans-personal-rotate-apikey.md)（如果是个人版）或 [`plans team rotate-apikey`](arkcli-plans-team-rotate-apikey.md)（如果是企业版席位）
- **先问用户是个人版还是企业版**（避免选错命令），或先 `plans get` 看持有形态
- 显式提示 "原 APIKey 立即失效，需立即替换 harness 配置"
- 默认**不**带 `--yes`，让 CLI 走 [Y/N] 确认；除非用户明确说 "脚本里执行 / 跳过确认"

## 4) 反触发（Anti-trigger）— 试用模型不应触发 buy

输入：

- "我想试试 doubao-seed-2-0-pro 这个模型效果"

期望行为：

- 路由 [`arkcli-chat`](../../arkcli-chat/SKILL.md) 或 [`arkcli-gen`](../../arkcli-gen/SKILL.md)
- **不要**推荐 `plans buy`（避免给试用用户开计费资源）
- **不要**推荐 `plans model-list` 当作答案（那是套餐归属内的模型清单，跟试用语义不重合）

## 5) 反触发 — 看 token 用量不应进 plans

输入：

- "我今天用了多少 token"

期望行为：

- 路由 [`arkcli-usage`](../../arkcli-usage/SKILL.md) → `usage stats --mine`
- **不要**走 plans，那是套餐持有 / 计费维度，不是消耗维度

## 6) Happy path — 团队版席位绑定子用户

前置条件：已登录 SSO 子用户、当前账号已下单 agent-plan-team 套餐、有空闲席位、有 IAM 子用户 ID 列表。

输入：

- "把 seat-aaa 绑给 user-id 12345，seat-bbb 绑给 user-id 67890"

期望行为：

- 推荐：
  ```bash
  arkcli plans team seat-assign --plan agent-plan-team \
      --bind seat-aaa=12345 \
      --bind seat-bbb=67890
  ```
- 解释：CLI 会自动调 IAM `ListUsers` 反查 UserName；如果 STS 没 IAM 权限，回退用三段 `seat-id=user-id:user-name`
- 提到部分失败语义：stdout 仍含 `success` + `failed` 数组，exit code 非零不等于全失败

## 6b) Happy path — 用户名前缀反查 UserID 后绑定

输入：

- "把席位 seat-001 绑给 ivan"
- "我们公司有员工 ivan 和 bob，给他们各分一个席位"

期望行为：

- **不要直接构造 user_id**（容易瞎编一个数字）
- 先推荐：
  ```bash
  arkcli iam userid --username ivan,bob
  ```
  解释会按前缀严格匹配，多个命中时让用户从输出里挑准确的 UserID
- 拿到 user_id 后再走：
  ```bash
  arkcli plans team seat-assign --plan agent-plan-team \
      --bind seat-001=<ivan-user-id> \
      --bind seat-002=<bob-user-id>
  ```
- 如果用户给的 prefix 命中多人（"ivan" → "ivan"+"ivanka"），先把候选展示给用户让他选，**不要替用户做选择**

## 7) Happy path — 个人版续费

输入：

- "续 6 个月 Coding Plan"

期望行为：

- 先用 `arkcli plans get` 验证持有 coding-plan（个人版）
- **第 1 步**: 不带 `--yes` 跑 `arkcli plans renew --plan coding-plan --duration 6` 拿协议清单
- **第 2 步**: 逐条展示 agreements,等用户明确同意
- **第 3 步**: 用户同意后跑 `next_step` (即原命令加 `--yes`)
- 显式提示 IsAutoPay=true,自动扣款;扣款失败按 payment_failed envelope 处理

## 8) 路由准确性 — 个人版 vs 团队版区分

输入：

- "我们公司订阅了 Agent Plan，给我看下席位"

期望行为：

- 走 [`plans team seat-list`](arkcli-plans-team-seat-list.md) 而**不是** `plans get`
- `--plan agent-plan-team`（不是 `agent-plan`）

## 9) 错误诊断 — IAM 权限不足

场景：`seat-assign` 报 `resolve UserName for UserID=...: IAM ListUsers ...: AccessDenied`

期望行为：

- 准确解释：当前 STS 凭据缺 `iam:ListUsers` 权限
- 推荐 escape hatch：`--bind seat-id=user-id:user-name`（手动指定 UserName，跳过 IAM 反查）
- **不要**让用户去切换账号或重 SSO 登录（那不一定能改 IAM 权限）