sillyspec 3.20.5 → 3.20.7

package/.claude/CLAUDE.md

@@ -0,0 +1,23 @@
+# Claude Code 指引
+
+# SillySpec工具定位
+1. SillySpec 是给 Agent 调用的 CLI 工具，不是给人类直接使用的产品
+2. SillySpec 是管理 Agent 工作流的 CLI 工具，不是处理业务逻辑的工具
+3. 你是 Agent。SillySpec 是你的流程控制器。你通过 CLI 命令告诉它"我在哪"，它告诉你"下一步该做什么"。你执行步骤，它校验产出、推进状态。人类用户只在关键决策点介入审批
+
+## 文件生命周期文档同步
+每次修改 `src/stages/` 下的阶段定义（prompt、步骤、输出文件名等）或 `src/run.js`、`src/progress.js` 等影响文件生命周期的代码后，**必须同步更新** `docs/sillyspec/file-lifecycle.md`，确保文档与代码一致。
+
+### 触发更新的典型改动
+- 新增/删除/重命名阶段步骤
+- 修改步骤 prompt 中的输出文件名（如 verify-result.md）
+- 修改阶段间的流转逻辑（如 archive 归档方式）
+- 新增/删除运行时文件类型（如 gate-status.json）
+- 修改 ProgressManager 的数据存储方式（如 SQLite 表结构变更）
+
+### 更新检查清单
+- [ ] 文件名引用一致（prompt 输出的文件名 == validateFileLocations 期望的文件名）
+- [ ] 阶段步骤描述与 `src/stages/*.js` 一致
+- [ ] 归档/清理流程描述与实际代码逻辑一致
+- [ ] 数据库 Schema 描述与 `src/db.js` 一致
+- [ ] 更新文档头部 `updated_at` 时间戳

package/.claude/skills/sillyspec-archive/SKILL.md

@@ -1,21 +1,86 @@
----
-name: sillyspec:archive
-description: 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。
----
-
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run archive` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run archive --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:archive
+description: 用于归档已验证完成的变更。适合用户说"归档、archive、收尾这个变更"。执行模块影响分析 + 同步模块文档 + 移动到 archive 目录 + 更新 ROADMAP。
+---
+
+## 何时使用
+
+- 用户说"归档、archive、收尾这个变更"
+- verify 已通过，把变更包归档沉淀
+- 5 步：任务完成度检查 → 模块影响分析 → 同步模块文档 → 确认归档 → 更新路线图
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec archive` 是 `sillyspec run archive` 的顶层别名，两者等价。
+
+```bash
+sillyspec run archive                          # 输出当前步骤 prompt
+sillyspec run archive --done --output "摘要"   # 完成当前步骤
+sillyspec run archive --status                 # 查看阶段进度
+sillyspec run archive --skip                   # 跳过可选步骤
+sillyspec run archive --reset                  # 重置阶段（从头开始）
+sillyspec run archive --reopen --from-step N   # 重新打开已完成阶段修订（N=序号或名称）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
+| `--json` | 输出 JSON（程序化读取） |
+
+## archive 特有
+
+### `--confirm`（确认归档步骤必填）
+
+第 4 步「确认归档」由 CLI 执行目录移动，**必须带 `--confirm`**：
+
+```bash
+sillyspec run archive --done --confirm --output "确认归档"
+```
+
+不带 `--confirm` 时 CLI 回退步骤为 pending 并提示，不会误归档。
+
+### 归档前硬校验
+
+CLI 移动目录前会校验 `plan.md` 存在——缺失则 `exit(1)` 阻断（目录尚未移动，可补全后重试）。移动后校验 `design.md` / `module-impact.md`（缺失只告警，因目录已移动）。
+
+### 模块文档同步（第 3 步）
+
+第 3 步「sync-module-docs」会更新 `_module-map.yaml` + 模块卡片，**必须暂停等用户确认**：
+
+```bash
+sillyspec run archive --wait --reason "等待用户确认模块文档同步" --options "确认写入,跳过同步" --output "diff 摘要"
+sillyspec run archive --continue --answer "确认写入"
+```
+
+只有用户 `--continue --answer "确认写入"` 后才写入文件。
+
+### 归档结果
+
+归档后变更目录从 `changes/<名>/` 移到 `changes/archive/YYYY-MM-DD-<名>/`，并从活跃列表注销。后续用 `/sillyspec:commit` 提交。
+
+## 阶段流转
+
+```
+verify → archive → git commit
+```
+
+archive 完成后，运行 `/sillyspec:commit` 提交归档结果（`git add .sillyspec/changes/`）。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 不要用 `mv`/`rename` 重命名变更目录，必须由 CLI 的「确认归档」步骤移动
+- 归档不可逆——确认前核对变更名、文件列表、module-impact.md
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

package/.claude/skills/sillyspec-auto/SKILL.md

@@ -1,83 +1,98 @@
----
-name: sillyspec:auto
-description: 自动模式 — 全流程自动推进（通用版）
-argument-hint: "<需求描述>"
----
-
-## 用法
-- /sillyspec:auto 实现用户登录功能
-- /sillyspec:auto 修复搜索结果的排序问题
-
-## 任务
-$ARGUMENTS
-
----
-
-## 执行流程
-
-你是全流程编排器，按 brainstorm → plan → execute → verify 顺序自动推进。
-
-### 启动
-1. 运行 `sillyspec run auto --input "<用户需求>"`
-2. 读取 CLI 输出的 step prompt（包含你的角色描述）
-3. 执行 prompt 中的操作
-4. **记录 CLI 输出中显示的 Change 名称**（如 `Change: 2026-06-02-xxx`）
-
-### 步骤循环
-重复以下循环直到 CLI 输出"全部流程已完成"：
-
-1. **读取 CLI 输出的 step prompt**
-2. **判断是否需要用户确认：**
-   - prompt 中包含"请用户选择""等待用户回答""展示给用户""用户确认" → **暂停，等用户回复**
-   - 纯内部操作 → **直接执行**
-3. **执行 prompt 要求的操作**
-4. **完成后运行** `sillyspec run auto --done --output "<你的摘要>"`
-   - ⚠️ **必须携带 --change <变更名>**，变更名来自启动时 CLI 输出的 `Change:` 字段
-   - 示例：`sillyspec run auto --done --change 2026-06-02-spec-bootstrap-agent-stream-interaction --output "摘要"`
-   - **绝不使用 `--change default`**，除非 CLI 启动时明确显示的 Change 名称就是 `default`
-5. **读取 CLI 输出的下一步 prompt**，回到步骤 1
-
-### 阶段审核门控
-
-**brainstorm 完成后：**
-评估需求复杂度（基于 design.md 中的模块拆分、批量操作、多角色交互等特征），根据复杂度决定：
-
-| 复杂度 | 审核策略 |
-|--------|---------|
-| 简单（无拆分、无批量） | 不审核，直接进入 plan |
-| 中等（有拆分或批量） | 启动 1 个审核子代理（QA 视角）审查 design.md |
-| 复杂（拆分 + 批量/多角色） | 启动 2-3 个审核子代理多角度审查 |
-
-多角度审核子代理分工：
-- **架构师** — 审查设计合理性、技术选型 trade-off、模块划分
-- **安全专家** — 审查安全隐患、权限设计、数据校验
-- **QA 专家** — 审查需求覆盖率、边界场景遗漏、验收标准
-
-审核流程：
-1. 暂停，提示用户当前复杂度等级和建议审核策略
-2. 用户确认后，启动审核子代理（读取 design.md + requirements.md + tasks.md）
-3. 子代理输出问题清单
-4. 汇总问题，询问用户"是否需要修改后再继续"
-5. 需要修改 → 修复后重新审核；不需要 → 进入下一阶段
-
-**plan 完成后：**
-同样评估复杂度，启动审核子代理审查 plan.md：
-- **项目经理** — 审查任务拆解粒度、依赖关系、优先级
-- **工程师** — 审查任务可行性、工作量评估是否合理
-- **QA** — 审查验收标准是否具体可测试
-
-### 关键规则
-- 不要跳过任何步骤
-- 不要手动修改进度数据（SQLite 数据库）
-- 不要自动 commit，只 git add
-- 不要使用 npx
-- 不要编造不存在的 CLI 子命令
-- 遇到命令报错 → 展示错误，暂停等用户介入
-- **每次调用 `sillyspec run auto --done` 都必须携带 `--change <变更名>`**，变更名 = CLI 首次输出中显示的 Change 名称。如果 CLI 首次运行没有显示 Change 名称，从 progress 或用户输入中确认变更名后再调用
-
-### 异常处理
-- 命令执行失败 → 展示错误信息，暂停等待用户指示
-- 用户说"停止"或"暂停" → 立即停止，报告当前进度
-
-### 完成条件
-CLI 输出"全部流程已完成"后，输出完整流程总结，提示用户提交改动。
+---
+name: sillyspec:auto
+description: 自动模式 — 全流程自动推进（通用版）
+argument-hint: "<需求描述>"
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
+
+## 用法
+
+- `/sillyspec:auto 实现用户登录功能`
+- `/sillyspec:auto 修复搜索结果的排序问题`
+
+## 任务
+$ARGUMENTS
+
+---
+
+## 执行流程
+
+你是全流程编排器，按 brainstorm → plan → execute → verify 顺序自动推进。
+
+### 启动
+
+```bash
+sillyspec run auto --input "<用户需求>" [--mode <模式>]
+```
+
+2. 读取 CLI 输出的 step prompt（含角色描述）
+3. 执行 prompt 中的操作
+4. **记录 CLI 输出中显示的 Change 名称**（如 `Change: 2026-06-02-xxx`）
+
+### 步骤循环
+
+重复以下循环直到 CLI 输出"全部流程已完成"：
+
+1. **读取 CLI 输出的 step prompt**
+2. **判断是否需要用户确认：**
+   - prompt 含"请用户选择 / 等待用户回答 / 展示给用户 / 用户确认" → **暂停，等用户回复**
+   - 纯内部操作 → **直接执行**
+3. **执行 prompt 要求的操作**
+4. **完成后运行：**
+   ```bash
+   sillyspec run auto --done --change <变更名> --output "<你的摘要>"
+   ```
+   - ⚠️ **必须携带 `--change <变更名>`**，变更名来自启动时 CLI 输出的 `Change:` 字段
+   - **绝不使用 `--change default`**，除非 CLI 启动时明确显示的 Change 名称就是 `default`
+5. **读取 CLI 输出的下一步 prompt**，回到步骤 1
+
+### auto 参数
+
+| 参数 | 说明 |
+|---|---|
+| `--input "<需求>"` | 启动时传入用户需求 |
+| `--mode <模式>` | 显式指定流程模式（默认按复杂度自动分类） |
+| `--done --change <名> --output "..."` | 完成当前步骤（必带 --change） |
+| `--spec-dir <path>` | 指定规范目录 |
+| `--non-interactive` | CI/脚本下禁用交互 |
+
+## 阶段审核门控
+
+**brainstorm 完成后**，评估需求复杂度（基于 design.md 的模块拆分、批量操作、多角色交互特征）：
+
+| 复杂度 | 审核策略 |
+|--------|---------|
+| 简单（无拆分、无批量） | 不审核，直接进入 plan |
+| 中等（有拆分或批量） | 启动 1 个审核子代理（QA 视角）审查 design.md |
+| 复杂（拆分 + 批量/多角色） | 启动 2-3 个审核子代理多角度审查 |
+
+多角度审核子代理分工：
+- **架构师** — 设计合理性、技术选型 trade-off、模块划分
+- **安全专家** — 安全隐患、权限设计、数据校验
+- **QA 专家** — 需求覆盖率、边界场景、验收标准
+
+审核流程：暂停提示复杂度 → 用户确认 → 启动子代理读 design/requirements/tasks → 汇总问题 → 询问是否修改 → 需要则修复重审，不需要则进下一阶段。
+
+**plan 完成后**，同样评估复杂度启动审核（项目经理审拆解粒度、工程师审可行性、QA 审验收标准）。
+
+## 关键规则
+
+- 不要跳过任何步骤
+- 不要手动修改进度数据（SQLite 数据库）
+- 不要自动 commit，只 `git add`
+- 不要使用 npx
+- 不要编造不存在的 CLI 子命令
+- 遇到命令报错 → 展示错误，暂停等用户介入
+- **每次 `sillyspec run auto --done` 都必须携带 `--change <变更名>`**（= CLI 首次输出的 Change 名）
+
+## 异常处理
+
+- 命令执行失败 → 展示错误信息，暂停等待用户指示
+- 用户说"停止"/"暂停" → 立即停止，报告当前进度
+
+## 完成条件
+
+CLI 输出"全部流程已完成"后，输出完整流程总结，提示用户提交改动（`/sillyspec:commit`）。

package/.claude/skills/sillyspec-brainstorm/SKILL.md

@@ -1,44 +1,78 @@
----
-name: sillyspec:brainstorm
-description: 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案，但不直接写代码。
----
-
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run brainstorm` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run brainstorm --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 特殊步骤：requiresWait
-
-某些步骤（如"对话式探索"）需要等待用户输入。AI agent 可以：
-
-- **方式一（推荐）**：通过自己的对话工具与用户交互，完成后直接 `--done --answer "用户回答"` 一步完成
-- **方式二**：先 `--wait` 记录等待状态，再 `--continue --answer "用户回答"`，最后 `--done`
-
-```bash
-# 一步完成 wait + done（AI agent 已自行与用户交互）
-sillyspec run brainstorm --done --change <变更名> --answer "信息够了，进入方案讨论" --output "需求已澄清"
-
-# 分步完成
-sillyspec run brainstorm --wait --change <变更名> --reason "等待用户回答" --output "探索问题"
-sillyspec run brainstorm --continue --answer "用户回答" --change <变更名>
-sillyspec run brainstorm --done --change <变更名> --output "需求已澄清"
-```
-
-## 注意
-- 推荐指定 `--change <变更名>`（格式：`YYYY-MM-DD-<简短描述>`），不指定时自动生成
-- 步骤 prompt 由 CLI 管理，不需要手动读取
-- 依赖 scan 阶段完成，CLI 会自动提醒
-- brainstorm 完成后，运行 `sillyspec run plan --change <变更名>` 进入实现计划
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:brainstorm
+description: 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。
+---
+
+## 交互规范
+
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。** 不要用编号列表让用户手动输入数字。
+
+## 何时使用
+
+- 用户提出新功能、新模块、架构调整、复杂改造
+- 用户说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"
+- 产出：`design.md` + `proposal.md` + `requirements.md` + `tasks.md`（四件套），不写代码
+
+## 多变更说明
+
+项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录）时，所有 `sillyspec run` 命令需加 `--change <变更名>` 指定操作目标；只有一个变更时可省略（CLI 自动检测）。建议变更名格式：`YYYY-MM-DD-<简短描述>`。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec brainstorm` 是 `sillyspec run brainstorm` 的顶层别名，两者等价。
+
+```bash
+sillyspec run brainstorm                       # 输出当前步骤 prompt
+sillyspec run brainstorm --done --output "摘要"     # 完成当前步骤（--input "用户原话" 记录输入）
+sillyspec run brainstorm --status              # 查看阶段进度
+sillyspec run brainstorm --skip                # 跳过可选步骤
+sillyspec run brainstorm --reset               # 重置阶段（从头开始）
+sillyspec run brainstorm --reopen --from-step N     # 重新打开已完成阶段修订（N=序号或名称）
+sillyspec run brainstorm --wait --reason "..." --options "A,B"   # 暂停等用户决策
+sillyspec run brainstorm --continue --answer "..."               # 恢复等待中的步骤
+sillyspec run brainstorm --done --answer "..." --output "..."    # 一步完成 wait+done
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--change <名>` | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--interactive` | 强制交互（即便 stdin 非 TTY） |
+| `--skip-approval` | 跳过审批/校验门控（需明确意图） |
+| `--json` | 输出 JSON（程序化读取） |
+
+## brainstorm 特有：requiresWait 步骤
+
+某些步骤（如"对话式探索"）需要用户输入。两种方式：
+
+- **方式一（推荐）**：AI 自行与用户交互后，一步完成：
+  ```bash
+  sillyspec run brainstorm --done --change <名> --answer "用户回答" --output "需求已澄清"
+  ```
+- **方式二**：分步——先 `--wait` 记录等待，再 `--continue --answer`，最后 `--done`：
+  ```bash
+  sillyspec run brainstorm --wait --change <名> --reason "等待用户回答" --output "探索问题"
+  sillyspec run brainstorm --continue --answer "用户回答" --change <名>
+  sillyspec run brainstorm --done --change <名> --output "需求已澄清"
+  ```
+
+## 阶段流转
+
+```
+scan → brainstorm → plan
+```
+
+brainstorm 完成后（四件套齐 + 自审通过），运行 `sillyspec run plan --change <变更名>` 进入实现计划。
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- 只做当前步骤 prompt 描述的操作，不跳过、不自行扩展
+- 产物写入 CLI 输出的 `changeDir` 目录（如 `<changeDir>/design.md`），不要自己拼路径
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS

package/.claude/skills/sillyspec-doctor/SKILL.md

@@ -1,31 +1,61 @@
----
-name: sillyspec:doctor
-description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
----
-
-## 前置检查
-
-**在执行任何检查之前，先确认 SillySpec CLI 是否可用：**
-
-1. 运行 `sillyspec --version`
-2. 如果失败：
-   - 输出：❌ SillySpec CLI 未安装
-   - 给出安装命令：`npm install -g sillyspec`
-   - 停止，不要继续后续步骤
-
-## 多变更说明
-
-如果项目有多个活跃变更（`.sillyspec/changes/` 下有多个目录），所有 `sillyspec run` 命令需要加 `--change <变更名>`。只有一个变更时可省略（CLI 自动检测）。
-
-## 执行
-
-**CLI 可用后，使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run doctor` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run doctor --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS
+---
+name: sillyspec:doctor
+description: 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性，修复进度数据与实际产出不匹配的问题。
+---
+
+## 何时使用
+
+- 用户说"检查下状态、修复 progress、doctor、状态不对"
+- 进度数据与实际产出不匹配时自检修复
+- 5 步：环境检查 → 项目配置 → 数据库完整性 → 状态一致性 → 修复建议
+
+## 前置检查
+
+**执行任何步骤前，先确认 SillySpec CLI 可用：**
+
+```bash
+sillyspec --version
+```
+
+失败则提示 `❌ SillySpec CLI 未安装` + 安装命令 `npm install -g sillyspec`，停止。
+
+## 步骤生命周期（所有阶段通用）
+
+> `sillyspec doctor` 是 `sillyspec run doctor` 的顶层别名，两者等价。
+
+```bash
+sillyspec run doctor                           # 输出当前步骤 prompt
+sillyspec run doctor --done --output "摘要"    # 完成当前步骤
+sillyspec run doctor --status                  # 查看阶段进度
+sillyspec run doctor --reset                   # 重置阶段（从头开始）
+```
+
+## 通用参数（所有阶段适用）
+
+| 参数 | 说明 |
+|---|---|
+| `--spec-dir <path>` | 指定规范目录（默认 `<项目>/.sillyspec`） |
+| `--non-interactive` | CI/脚本下禁用交互式 prompt |
+| `--json` | 输出 JSON（程序化读取） |
+
+## doctor 特有
+
+doctor 是辅助阶段，用于诊断而非推进流程。配套的轻量诊断命令（不经 run）：
+
+```bash
+sillyspec progress show                        # 查看当前进度
+sillyspec progress check                       # 状态一致性检查（只报告，不修复）
+sillyspec progress repair                      # 修复状态元数据（dry-run）
+sillyspec progress repair --apply              # 真正修复
+sillyspec progress validate                    # 校验并修复
+sillyspec worktree doctor [--fix]              # worktree 健康检查 + 修复
+```
+
+## 铁律
+
+- **必须用 exec 工具（shell）执行 CLI，不要自己编造流程**
+- doctor 只诊断和建议，修复操作要让用户确认
+- 完成后立即 `--done`，不跳过
+
+## 用户指令
+$ARGUMENTS