sillyspec 3.8.7 → 3.9.0

package/dist/steps/brainstorm/01-load-context.md

@@ -0,0 +1,30 @@
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+## 核心约束（必须遵守）
+- ❌ 写实现代码（任何语言）
+- ❌ 修改任何源代码文件
+- ❌ 安装依赖或执行构建命令
+- ❌ 创建数据库迁移脚本
+- ❌ 跳过 brainstorm 直接进入 execute/plan
+- ❌ 在 checklist 未完成前开始写设计文档
+- ❌ 编造不存在的表名、字段名、API 端点
+- ❌ 一次性抛出多个问题（必须逐个等待回答）
+- ❌ 用户确认前自行推进到 plan 或任何后续阶段
+
+**终态：** brainstorm 完成后唯一出口是 plan 阶段。不允许直接进入 execute 或任何代码操作。
+
+## 加载项目上下文
+
+```bash
+ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
+```
+
+**工作区模式：** AskUserQuestion 选子项目，**cd 到子项目目录执行**，加载子项目上下文 + 共享规范 + 工作区概览，设计文档保存到子项目 `.sillyspec/docs/<project>/changes/`。修改在子项目目录中暂存。
+
+**单项目模式：**
+```bash
+cat .sillyspec/{PROJECT,REQUIREMENTS,ROADMAP}.md 2>/dev/null
+cat .sillyspec/docs/<project>/scan/{STRUCTURE,CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
+ls .sillyspec/changes/ 2>/dev/null | grep -v archive
+ls .sillyspec/knowledge/ 2>/dev/null
+```

package/dist/steps/brainstorm/02-reuse-check.md

@@ -0,0 +1,6 @@
+检查已有变更和可复用模板，避免冲突和重复劳动。
+
+- **同名变更：** `ls .sillyspec/changes/ | grep -v archive` — 有相关变更则提示避免冲突
+- **全局模板：** `ls ~/.sillyspec/templates/ 2>/dev/null` — 有匹配模板则建议复用
+
+无匹配则跳过，不输出。

package/dist/steps/brainstorm/03-prototype-analysis.md

@@ -0,0 +1,11 @@
+**如有图片则必做。无图片则跳过此步骤。**
+
+**不要只看描述文字，图片包含布局、字段、交互等视觉信息。**
+
+对每张图逐页分析（先主页面后子页面）：
+1. **页面结构** — 识别搜索区、操作栏、表格、表单等区块
+2. **表单字段** — 字段名、类型、必填、选项
+3. **交互流程** — 页面跳转、按钮行为、流程线
+4. **标注备注** — 业务规则、状态说明、权限说明
+
+展示分析结果，问用户确认有无遗漏。

package/dist/steps/brainstorm/04-module-split.md

@@ -0,0 +1,23 @@
+评估需求范围，复杂需求拆分子项目/阶段。
+
+**满足以下任意 2 条就建议拆分：**
+- 3+ 个可独立交付的功能模块
+- 3+ 种角色有不同权限和视图
+- 跨页面状态流转（审批流、多步表单）
+- brainstorm 提问发现需求范围过大
+
+确认拆分后生成 MASTER.md：
+
+```bash
+mkdir -p .sillyspec/changes/<变更名>/stages
+```
+
+`MASTER.md` 内容：概述、拆分计划表（阶段/范围/状态）、整体技术方向、阶段间依赖、原型分析摘要、经验记录。
+
+```bash
+git add .sillyspec/changes/<变更名>/MASTER.md
+```
+
+提示用户：对子阶段执行 brainstorm，读取 MASTER.md + 前序阶段经验 + 对应原型，设计文档保存到 `.sillyspec/changes/<变更名>/stages/<stage-N>/`。
+
+不需要拆分则跳过此步骤。

package/dist/steps/brainstorm/05-dialog-explore.md

@@ -0,0 +1,8 @@
+**核心规则：一次只问一个问题。**
+
+1. 从最核心的问题开始（用户到底想做什么？）
+2. 等待回答，根据信息量决定追问还是进入方案讨论
+3. 探索顺序按需：目的 → 约束 → 边界 → 成功标准
+4. **大多数 brainstorm 2-3 轮就应进入方案讨论**
+
+探索阶段可使用项目已配置的 MCP 工具或 web search 调研技术方案和 API 用法，不要凭记忆写方案。检测可用工具：`cat .claude/mcp.json .cursor/mcp.json 2>/dev/null`

package/dist/steps/brainstorm/06-propose-approaches.md

@@ -0,0 +1,3 @@
+提出 2-3 种方案。
+
+每种方案列优劣，给出推荐和理由。

package/dist/steps/brainstorm/07-present-design.md

@@ -0,0 +1,3 @@
+分段展示设计，逐段确认。
+
+简单项目几句话；复杂项目每段 200-300 字逐段确认。

package/dist/steps/brainstorm/08-write-design.md

@@ -0,0 +1,21 @@
+写设计文档并保存到 `.sillyspec/changes/<变更名>/design.md`：
+
+```markdown
+# [Feature Name] 设计
+
+## 动机与范围
+（为什么做、范围边界、成功标准）
+
+## 功能需求
+（需求场景、验收标准）
+- [ ] 标准 1
+
+## 技术方案
+## 约束和假设
+## 不在范围内
+## 文件变更
+## 代码风格参照
+（参考已有源文件，标注返回值类型、异常类型、注解风格）
+```
+
+**注意：** 引用的表名必须来自 `.sillyspec/docs/<project>/scan/ARCHITECTURE.md` 数据模型或明确标注"新增"。必须先读取该文件。

package/dist/steps/brainstorm/09-self-review.md

@@ -0,0 +1,15 @@
+AI 自审（必须执行）。
+
+对照 `.sillyspec/changes/<变更名>/design.md` 检查：
+
+- 需求覆盖：是否完整覆盖对话式探索确认的需求点？
+- 约束一致性：技术方案是否与 `.sillyspec/docs/<project>/scan/ARCHITECTURE.md`、`.sillyspec/docs/<project>/scan/CONVENTIONS.md` 一致？
+- 表名/字段真实性：是否来自真实 schema？
+- 范围控制：是否包含不必要功能（YAGNI）？
+- 验收标准：是否具体、可测试？
+- 变更冲突：是否与复用检查阶段检测到的已有变更冲突？
+- 缺口：模糊表述（"适当的"/"必要时"等）是否已明确化
+- 缺口：隐含假设（登录态、数据量、并发预期）是否已显式写出
+- 缺口：边界场景（空数据、并发、服务不可用）是否已考虑
+
+发现问题 → 修改文档，重新自审。不确定的标注「⚠️ 自审存疑」让用户判断。

package/dist/steps/brainstorm/10-user-confirm.md

@@ -0,0 +1,3 @@
+⛔ 门禁步骤。
+
+展示设计方案，使用 AskUserQuestion 让用户三选一：确认 / 需要修改 / 推翻重来。

package/dist/steps/brainstorm/11-output-spec.md

@@ -0,0 +1,7 @@
+用户确认后，确认 `.sillyspec/changes/<变更名>/design.md` 已包含完整内容（动机、需求、方案、文件变更、代码风格参照）。如上一步已保存则无需重复。
+
+## 关键原则
+- YAGNI — 无情砍掉不需要的功能
+- 总是探索替代方案
+- 设计可以很短，但必须存在
+- "简单"的项目更需要设计——未检视的假设造成最大浪费

package/dist/steps/brainstorm/manifest.yaml

@@ -0,0 +1,26 @@
+phase: brainstorm
+description: 需求探索与方案设计
+requires: [scan]
+steps:
+  - file: 01-load-context.md
+    name: 加载项目上下文
+  - file: 02-reuse-check.md
+    name: 协作与复用检查
+  - file: 03-prototype-analysis.md
+    name: 原型/设计图分析
+  - file: 04-module-split.md
+    name: 大模块拆分
+  - file: 05-dialog-explore.md
+    name: 对话式探索
+  - file: 06-propose-approaches.md
+    name: 提出方案
+  - file: 07-present-design.md
+    name: 分段展示设计
+  - file: 08-write-design.md
+    name: 写设计文档
+  - file: 09-self-review.md
+    name: AI 自审
+  - file: 10-user-confirm.md
+    name: 用户确认
+  - file: 11-output-spec.md
+    name: 输出技术方案

package/dist/steps/execute/01-load-context.md

@@ -0,0 +1,41 @@
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+## 核心约束（必须遵守）
+- ❌ 跳步执行（不允许跳过 plan 直接 execute）
+- ❌ 先写代码后补测试
+- ❌ 编造不存在的方法/注解/路径/类/字段
+- ❌ 自行补全缺失的接口/方法（应报告 BLOCKED）
+- ❌ 意外修改了计划外的文件却不报告
+
+**所有任务通过子代理执行，主代理负责调度和记录。**
+
+## 加载上下文
+
+```bash
+ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
+```
+
+**工作区模式：** 根据计划 Task 标注确定子项目，额外加载共享规范 + `.sillyspec/workspace/CODEBASE-OVERVIEW.md`。所有代码修改、测试运行在子项目目录中执行。
+
+```bash
+PLAN=$(ls -t .sillyspec/changes/*/tasks.md 2>/dev/null | head -1); cat "$PLAN"
+LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
+cat "$LATEST"/{tasks,design}.md 2>/dev/null
+cat .sillyspec/docs/<project>/scan/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
+cat .sillyspec/local.yaml 2>/dev/null
+```
+
+**知识库查询（强制步骤）：**
+```bash
+cat .sillyspec/knowledge/INDEX.md 2>/dev/null
+```
+根据当前 task 描述中的关键词匹配 INDEX.md 条目。命中时读取对应 knowledge 文件，注入子代理 prompt。未命中则跳过。
+
+## 确认频率
+
+用 AskUserQuestion 询问用户选择：
+- **每个 Wave 确认** — 每个 Wave 完成后展示结果，等用户确认后继续下一 Wave
+- **AI 自主判断** — AI 在遇到 BLOCKED 或计划外变更时才询问，其余自动推进
+- **全自动** — 全部自动执行，不在中途打断用户
+
+如果 `$ARGUMENTS` 指定范围（如 `wave-1`、`task-3`），只执行对应部分。

package/dist/steps/execute/02-scan-conventions.md

@@ -0,0 +1,47 @@
+主代理在 dispatch 子代理前执行以下扫描。
+
+## 编码规范扫描
+
+```bash
+for f in .eslintrc .eslintrc.js .eslintrc.cjs .eslintrc.json .eslintrc.yml \
+         .prettierrc .prettierrc.js .prettierrc.json .prettierrc.yml \
+         tsconfig.json tsconfig.base.json \
+         .editorconfig \
+         .tailwind.config.js .tailwind.config.ts \
+         .stylelintrc .stylelintrc.js .stylelintrc.json \
+         CONTRIBUTING.md CODE_STYLE.md; do
+  [ -f "$f" ] && echo "=== $f ===" && cat "$f"
+done
+cat package.json 2>/dev/null | grep -A5 '"lint\|"format\|"typecheck\|"type-check'
+```
+
+扫描后生成**编码规范摘要**（提炼关键约束，非原文粘贴），格式：
+
+```
+## 编码规范约束（自动扫描）
+### ESLint
+{关键规则}
+### Prettier
+{格式化规则}
+### TypeScript
+{严格模式设置}
+### Import / 命名约定
+{导入排序、命名风格}
+### 框架约定
+{框架特定约定}
+```
+
+注入到子代理 prompt，追加铁律：**遵守编码规范：如规范与任务描述冲突，优先遵守规范并报告。**
+
+## 测试模式扫描（E2E/测试任务时执行）
+
+```bash
+cat package.json 2>/dev/null | grep -E "playwright|cypress|jest|vitest|mocha"
+find . -name "*.spec.ts" -o -name "*.test.ts" -o -name "*.spec.tsx" -o -name "*.spec.js" \
+     -o -name "playwright.config.*" -o -name "vitest.config.*" -o -name "jest.config.*" \
+  2>/dev/null | grep -v node_modules | head -10
+```
+
+读取 1-2 个已有测试文件作为风格参考，生成测试模式摘要（框架、断言风格、Fixtures、文件组织、配置要点），注入到 E2E/测试子代理 prompt。
+
+追加铁律：**参照已有测试风格编写新测试，不要凭记忆写测试。**

package/dist/steps/execute/03-skill-mcp.md

@@ -0,0 +1,19 @@
+## Skill 扫描
+
+```bash
+for skill_dir in .claude/skills/*/SKILL.md .cursor/skills/*/SKILL.md .opencode/skills/*/SKILL.md; do
+  [ -f "$skill_dir" ] && echo "=== $skill_dir ===" && cat "$skill_dir"
+done
+```
+
+根据任务关键词匹配 skill，匹配到的 SKILL.md 全文注入子代理 prompt。
+
+## MCP 能力检测
+
+检查当前可用工具列表中是否存在以下 MCP 工具：
+- Context7 / 文档查询工具
+- 数据库工具（postgres/sqlite/mysql/redis）
+- 浏览器工具（browser/chrome/playwright/devtools）
+
+有 Context7 → 提示子代理用 MCP 查文档；无 → 提示用 web search。
+有数据库 MCP → 在子代理 prompt 注入数据操作可用。

package/dist/steps/execute/04-assign-task.md

@@ -0,0 +1,22 @@
+## 执行流程
+
+1. 解析 tasks.md，按 Wave 分组
+2. 同一 Wave 内的任务**并行启动**子代理，不同 Wave **串行等待**
+3. 每个 Wave 完成后，根据用户选择的确认频率决定是否暂停
+4. 子代理返回结果后，主代理勾选 tasks.md、更新 STATE.md
+
+## 子代理 Prompt 模板
+
+主代理 dispatch 子代理前，必须准备以下 prompt（所有内容**内联**，不让子代理自己读文件）。prompt 格式见 `04b-prompt-template.md`。
+
+需要注入的变量：
+- `{任务描述}` — tasks.md 中当前 task 的完整内容（包括步骤字段）
+- `{CONVENTIONS.md 全文}` — 来自 `.sillyspec/docs/<project>/scan/CONVENTIONS.md`
+- `{编码规范约束}` — 02-scan-conventions 步骤生成的规范摘要
+- `{测试模式参考}` — 仅 E2E/测试任务注入，02-scan-conventions 步骤生成
+- `{ARCHITECTURE.md 全文}` — 来自 `.sillyspec/docs/<project>/scan/ARCHITECTURE.md`
+- `{构建命令}` — `.sillyspec/local.yaml` 中的 build 命令
+- `{工作目录}` — 子项目目录路径
+- `{相关知识}` — knowledge/ 中匹配到的内容，未命中则删除此段
+- `{文档查询指引}` — MCP 检测结果动态注入
+- `{本地 Skills}` — 匹配到的 SKILL.md 全文，无匹配则省略

package/dist/steps/execute/04b-prompt-template.md

@@ -0,0 +1,54 @@
+子代理 Prompt 模板（供 04-assign-task.md 引用，dispatch 时所有变量需内联）：
+
+```
+你正在执行任务：
+
+## 任务描述
+{任务描述}
+
+## 项目约定
+{CONVENTIONS.md 全文}
+
+## 编码规范约束（自动扫描）
+{编码规范约束}
+
+## 测试模式参考（仅 E2E/测试任务注入）
+{测试模式参考}
+
+## 项目架构
+{ARCHITECTURE.md 全文}
+
+## 构建命令 / 工作目录
+{构建命令}
+{工作目录}
+
+## 相关知识 / 文档查询指引 / 本地 Skills
+{相关知识}
+{文档查询指引}
+{本地 Skills}
+
+## 数据操作
+⛔ 任何 DML/DDL 操作必须暂停并报告给用户确认。新建表不受此限制。
+
+## 铁律
+1. **先读后写：** 先 cat 要修改的文件和参考文件，确认风格后再写
+2. **grep 确认：** 调用已有方法前必须 grep 确认存在，grep 不到 → BLOCKED
+3. **不编造：** 不编造不存在的方法/注解/类/字段
+4. **不自行补全：** 缺失接口/方法 → BLOCKED
+5. **TDD 不跳步：** 按任务步骤逐步执行，每步必须运行测试并确认结果
+6. **测试直接通过 = 测了已有行为，重写测试**
+7. **E2E 任务：** 先 cat 相关代码，参考测试模式，查阅用法文档，写完立即跑确认通过
+8. **Lint 校验：** 完成后运行 lint，自动修复可修复的问题
+9. **暂存：** lint 通过后 git add -A（不要 commit）
+10. **遵守编码规范：** 规范与任务描述冲突时，优先遵守规范并报告
+11. **参照已有测试风格，不要凭记忆写测试**
+12. **先 grep 项目中类似功能的已有代码，照着现有模式写**
+
+## 完成后报告（严格格式）
+- **Status:** DONE / DONE_WITH_CONCERNS / BLOCKED
+- **改动文件：** {列表}
+- **测试结果：** {通过/失败/跳过及原因}
+- **Commit:** {hash 或 "无"}
+- **问题：** {BLOCKED 原因 / DONE_WITH_CONCERNS 描述 / 无}
+- **发现的坑：** {项目特有规律/陷阱/约定，无则写"无"}
+```

package/dist/steps/execute/05-write-test.md

@@ -0,0 +1,7 @@
+子代理执行任务的第一步：写测试。
+
+按 tasks.md 中当前 task 的「步骤」字段第 1 步执行：写测试。
+
+- 运行测试确认失败（TDD 红）
+- 如果测试直接通过 → 重新写测试（测了已有行为）
+- 纯配置/数据/文档类任务跳过此步骤

package/dist/steps/execute/06-write-code.md

@@ -0,0 +1,8 @@
+子代理执行任务的核心步骤：写代码。
+
+按 tasks.md 中当前 task 的「步骤」字段第 3 步执行：写代码实现。
+
+- 必须先 cat 要修改的文件和参考文件
+- grep 确认调用的方法存在
+- 遵守编码规范约束
+- 纯配置/数据/文档类任务直接执行实现步骤

package/dist/steps/execute/07-run-test.md

@@ -0,0 +1,26 @@
+子代理执行任务的验证步骤：运行测试。
+
+按 tasks.md 中当前 task 的「步骤」字段第 4 步执行：运行测试确认通过。
+
+- 运行全部测试，确认通过
+- 运行 lint，自动修复可修复的问题
+- lint 通过后 git add -A
+
+## 子代理结果处理
+
+子代理返回后，主代理：
+
+1. **DONE** → 勾选 tasks.md，记录精确到秒的时间戳
+2. **DONE_WITH_CONCERNS** → 勾选 tasks.md，记录问题到报告
+3. **BLOCKED** → 不勾选，报告给用户，AskUserQuestion 三选一：
+   - 重试（重新 dispatch 同一任务）
+   - 跳过（勾选并标注 SKIPPED）
+   - 停止（暂停执行，用户处理后继续）
+
+**知识库写入：** 如果子代理报告中「发现的坑」不为"无"，追加到 `.sillyspec/knowledge/uncategorized.md`：
+```markdown
+### [待确认] {简短标题}
+> 来源：{变更名} / {task 编号} | {时间戳}
+
+{坑的具体描述}
+```

package/dist/steps/execute/08-fix-issues.md

@@ -0,0 +1,28 @@
+如果测试失败或子代理返回 BLOCKED，主代理处理修复。
+
+**测试失败修复循环：**
+
+```
+ROUND = 1
+MAX_ROUNDS = 5
+
+while ROUND <= MAX_ROUNDS:
+    1. 运行失败测试，捕获完整输出
+    2. 全部通过 → 跳出循环，标记 ✅
+    3. 对每个失败测试：
+       a. 读取 .sillyspec/local.yaml 中当前变更的 fixAttempts
+       b. fixAttempts >= MAX_ROUNDS → 跳过，标记 ❌ MAX_REACHED
+       c. 否则 → 重新 dispatch 子代理修复，prompt 包含：
+          - 失败的测试文件路径和测试名
+          - 完整错误信息（含期望值 vs 实际值）
+          - 相关源文件路径
+          - "只修复这个测试失败，不要改其他代码"
+       d. 修复后重跑确认
+       e. 通过 → fixAttempts 不变；仍失败 → fixAttempts + 1
+    4. 写入 .sillyspec/local.yaml
+    5. ROUND++
+    6. 本轮无任何修复 → 跳出循环
+```
+
+**BLOCKED 处理：**
+- AskUserQuestion 三选一：重试 / 跳过 / 停止

package/dist/steps/execute/09-next-task.md

@@ -0,0 +1,33 @@
+当前任务完成后，推进到下一个任务。
+
+1. 检查当前 Wave 是否还有未完成任务 → 继续分配
+2. 当前 Wave 完成 → 根据确认频率决定是否暂停
+3. 所有 Wave 完成 → 执行以下收尾
+
+## 任务勾选自检（必须执行）
+
+```bash
+cat .sillyspec/changes/*/tasks.md 2>/dev/null
+```
+
+逐条验证：
+1. 所有返回 DONE/DONE_WITH_CONCERNS 的任务是否已勾选 `- [x]`？
+2. 勾选的任务是否都记录了精确到秒的时间戳 `[YYYY-MM-DD HH:MM:SS]`？
+3. tasks.md 中是否还有未勾选 `- [ ]` 的已完成任务？
+
+发现遗漏 → 立即补勾选 + 补时间戳。
+
+## 知识库审阅
+
+```bash
+grep -c '^\### \[待确认\]' .sillyspec/knowledge/uncategorized.md 2>/dev/null
+```
+
+如果有待确认条目，提示用户审阅 `.sillyspec/knowledge/uncategorized.md`。
+
+## 下一步
+
+用 AskUserQuestion 询问用户：
+1. **验证** — 执行 verify 全面验证
+2. **归档** — 跳过 verify，执行 archive
+3. **继续开发** — 不结束当前阶段

package/dist/steps/execute/manifest.yaml

@@ -0,0 +1,28 @@
+phase: execute
+description: 任务执行
+requires: [plan]
+loop:
+  start: 5
+  end: 9
+  description: 写测试→写代码→跑测试→修复→下一个任务，循环直到所有任务完成
+steps:
+  - file: 01-load-context.md
+    name: 加载上下文
+  - file: 02-scan-conventions.md
+    name: 规范扫描
+  - file: 03-skill-mcp.md
+    name: Skill/MCP 检测
+  - file: 04-assign-task.md
+    name: 分配任务
+  - file: 04b-prompt-template.md
+    name: 子代理 Prompt 模板
+  - file: 05-write-test.md
+    name: 写测试
+  - file: 06-write-code.md
+    name: 写代码
+  - file: 07-run-test.md
+    name: 运行测试
+  - file: 08-fix-issues.md
+    name: 修复问题
+  - file: 09-next-task.md
+    name: 下一个任务

package/dist/steps/plan/01-load-context.md

@@ -0,0 +1,22 @@
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+## 核心约束（必须遵守）
+- ❌ 写实现代码（只写计划中的代码示例）
+- ❌ 每个步骤缺验证命令和预期输出
+- ❌ 编造表名、字段名（必须来自 ARCHITECTURE.md 或 design.md）
+
+## 加载上下文
+
+```bash
+ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
+```
+
+**工作区模式：** 加载 `.sillyspec/workspace/CODEBASE-OVERVIEW.md` + 共享规范 + 子项目的 CONVENTIONS/ARCHITECTURE/STACK + `.sillyspec/REQUIREMENTS.md`。
+
+**单项目模式：**
+```bash
+LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
+cat "$LATEST"/{design,tasks}.md 2>/dev/null
+cat .sillyspec/docs/<project>/scan/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
+cat .sillyspec/REQUIREMENTS.md 2>/dev/null
+```

package/dist/steps/plan/02-anchor-confirm.md

@@ -0,0 +1 @@
+确认实际存在的文件（design / tasks），不存在的标注跳过。

package/dist/steps/plan/03-expand-tasks.md

@@ -0,0 +1,33 @@
+把 tasks.md 每个 checkbox **保留 `- [ ]` 格式**并展开为任务描述，按 Wave 分组组织。工作区模式下每个 Task 标注所属项目。
+
+**输出格式要求（必须严格遵守）：**
+
+```markdown
+### Wave 1（并行，无依赖）
+- [ ] 添加用户创建接口
+  - 修改: `UserController.java`、`UserService.java`
+  - 参考: `RoleController.createRole`
+  - 步骤:
+    1. 写测试 UserControllerTest.testCreateUser
+    2. 运行测试确认失败
+    3. 写 UserController.createUser
+    4. 运行测试确认通过
+
+- [ ] 添加角色创建接口
+  - ...
+```
+
+**每个 Task 必须保留 `- [ ]` checkbox，这是 execute 阶段勾选完成状态的依据。** 禁止写成纯文本列表。
+
+**每个 Task 必须包含「步骤」字段，列出 TDD 执行顺序：**
+- 1. 写测试 → 2. 运行确认失败 → 3. 写代码 → 4. 运行确认通过
+
+**纯配置/数据/文档类任务可跳过 TDD，步骤简化为：1. 实现 → 2. 验证**
+
+**注意：不需要写精确方法签名和代码示例。** 方法签名和代码风格由 execute 阶段先读后写确认。plan 专注"做什么"和"执行顺序"。
+
+**每个 Task 包含：**
+- 精确文件路径（修改哪个文件）
+- 任务描述（做什么，一两句话说清楚）
+- 涉及已有类调用时，标注参考文件（如"参考 `RoleController.createRole`）
+- 依赖关系

package/dist/steps/plan/04-mark-order.md

@@ -0,0 +1,15 @@
+按 Wave 分组，标注依赖关系：
+
+```markdown
+### Wave 1（并行，无依赖）
+- [ ] 添加用户创建接口
+  - 修改: `UserController.java`、`UserService.java`
+  - 参考: `RoleController.createRole`
+
+- [ ] 添加角色创建接口
+  - ...
+
+### Wave 2（依赖 Wave 1）
+- [ ] 添加用户列表查询（依赖用户创建完成）
+  - ...
+```

package/dist/steps/plan/05-e2e-planning.md

@@ -0,0 +1,17 @@
+识别 design.md 中是否有 UI 交互功能（页面跳转、表单提交、按钮操作等），如有则：
+
+**检测测试能力（按优先级）：**
+```bash
+# 优先级 1：专业 E2E 框架
+cat package.json 2>/dev/null | grep -E "playwright|cypress" ; ls node_modules/playwright node_modules/cypress 2>/dev/null
+# 优先级 2：通用测试框架
+cat package.json 2>/dev/null | grep -E "jest|vitest|mocha" ; ls node_modules/jest node_modules/vitest 2>/dev/null
+# 优先级 3：浏览器 MCP
+cat .claude/mcp.json .cursor/mcp.json 2>/dev/null | grep -i "browser\|chrome\|devtools"
+```
+
+- **有 E2E/测试框架** → tasks.md 中添加 E2E 测试任务（同波次，编码后编写）
+- **无框架但有浏览器 MCP** → tasks.md 中添加"编写 e2e-steps.md 测试步骤"任务
+- **什么都没有** → 提示用户运行 `sillyspec setup` 安装 MCP 工具，或手动安装测试框架
+
+纯后端/无 UI 的变更跳过此步骤。

package/dist/steps/plan/06-self-check.md

@@ -0,0 +1,16 @@
+自检门控：
+
+- [ ] 每个 task 有具体文件路径？
+- [ ] 标注了 Wave 和依赖关系？
+- [ ] 涉及 UI 的任务是否有对应的 E2E 测试任务？
+- [ ] **design.md 中的每个功能点是否都在 tasks.md 中有对应任务？**
+
+### 设计完整性对照（必须完成）
+
+逐条检查 design.md 中的功能描述，确保每个功能点都有对应的 task。特别关注：
+
+1. **逐功能点扫描：** 将 design.md 中描述的每个功能点（含子功能）列出，与 tasks.md 逐条对照
+2. **前后端覆盖检查：** 涉及前后端协作的功能，确认前端和后端各有独立 task
+3. **遗漏项处理：** 发现未覆盖的功能点 → 追加 task 到对应 Wave，并提示用户确认
+
+发现遗漏时用 AskUserQuestion 确认追加内容，用户确认后再写入 tasks.md。

package/dist/steps/plan/07-save.md

@@ -0,0 +1 @@
+**直接覆盖** `.sillyspec/changes/<变更名>/tasks.md`。不再生成单独的 plan.md 文件。

package/dist/steps/plan/manifest.yaml

@@ -0,0 +1,18 @@
+phase: plan
+description: 任务分解与执行计划
+requires: [brainstorm]
+steps:
+  - file: 01-load-context.md
+    name: 加载上下文
+  - file: 02-anchor-confirm.md
+    name: 锚定确认
+  - file: 03-expand-tasks.md
+    name: 逐任务展开
+  - file: 04-mark-order.md
+    name: 标注执行顺序
+  - file: 05-e2e-planning.md
+    name: E2E 测试规划
+  - file: 06-self-check.md
+    name: 自检门控
+  - file: 07-save.md
+    name: 保存