sillyspec 3.20.2 → 3.20.3

package/.sillyspec/projects/sillyspec.yaml

@@ -0,0 +1,3 @@
+name: sillyspec
+path: .
+status: active

package/README.md

@@ -2,7 +2,7 @@
   <img src="logo.jpg" width="80" />
 </p>
 
-# SillySpec v3.16 — 规范驱动开发工具包
+# SillySpec v3.0 — 规范驱动开发工具包
 
 > 融合 Superpowers + OpenSpec + GSD，从"你说要啥"到"代码能跑"的完整流程。
 > Claude Code / Cursor / Codex / OpenCode / OpenClaw 都能用。
@@ -19,7 +19,7 @@
 npx sillyspec init
 ```
 
-> 📦 首次运行自动安装 CLI，之后 `sillyspec run brainstorm`/`sillyspec progress show` 等命令也可直接使用。
+> 📦 首次运行自动安装 CLI，之后 `sillyspec status`/`sillyspec next` 等命令也可直接使用。
 
 **指定工具：**
 ```bash
@@ -42,8 +42,10 @@ npx sillyspec init --dir /path/to/project
 
 | 工具 | `--tool` 参数 | 输出目录 | 格式 |
 |---|---|---|---|
-| Claude Code | `claude` | `.claude/skills/sillyspec-<name>/` | SKILL.md |
-| Codex | `codex` | `.codex/skills/sillyspec-<name>/` | SKILL.md |
+| Claude Code (commands) | `claude` | `.claude/commands/sillyspec/` | slash commands |
+| Claude Code (skills) | `claude_skills` | `.claude/skills/sillyspec-<name>/` | SKILL.md |
+| Cursor | `cursor` | `.cursor/commands/` | custom commands |
+| Codex | `codex` | `~/.agents/skills/sillyspec-<name>/` | SKILL.md |
 | OpenCode | `opencode` | `.opencode/skills/sillyspec-<name>/` | SKILL.md |
 | OpenClaw | `openclaw` | `.openclaw/skills/sillyspec-<name>/` | SKILL.md |
 
@@ -68,7 +70,7 @@ claude --dangerously-skip-permissions
 
 ```
 绿地：init → brainstorm → plan → execute → [verify] → archive
-棕地：scan → brainstorm → plan → execute → verify → archive
+棕地：scan → brainstorm → plan → execute → [verify] → archive
 大模块：brainstorm(多图) → 拆分 → MASTER.md → stage-1 全流程 → stage-2 全流程 → ... → archive
 ```
 
@@ -110,13 +112,9 @@ claude --dangerously-skip-permissions
 ## CLI 命令
 
 ```bash
-sillyspec run <stage>        执行阶段步骤（brainstorm/plan/execute/verify 等）
-sillyspec run scan           代码扫描
-sillyspec run quick          快速任务
-sillyspec run explore        自由探索
-sillyspec run <stage> --done 完成当前步骤并输出下一步
-sillyspec run <stage> --status 查看阶段进度
-sillyspec progress show      显示当前项目状态
+sillyspec status [--json]    显示当前项目状态
+sillyspec next [--json]      显示下一步命令
+sillyspec check [--json]     检查文档完整性
 sillyspec setup              安装推荐 MCP 工具（交互式）
 sillyspec setup --list       查看已安装 MCP 状态
 sillyspec init               初始化（零交互，自动检测工具）
@@ -169,7 +167,7 @@ SillySpec 不仅仅是 prompt，还有硬校验：
 sillyspec/
 ├── bin/sillyspec.js              # CLI 入口
 ├── src/
-│   ├── index.js                  # CLI 命令入口
+│   ├── index.js                  # status/next/check 命令
 │   ├── init.js                   # init 逻辑 + 工具适配器
 │   └── setup.js                  # MCP 工具安装
 ├── templates/                    # 命令模板（19 个）

package/SKILL.md

@@ -1,46 +1,46 @@
 ---
 name: sillyspec
-description: "规范驱动开发工具包。绿地用 /sillyspec:init，棕地用 /sillyspec:scan，全自动用 /sillyspec:auto。完整流程：scan → brainstorm → plan → execute → verify → archive。支持 TDD、子代理并行、worktree 隔离、E2E 验证。兼容 Claude Code / Cursor / Codex / OpenCode / OpenClaw。"
-version: "3.12.7"
+description: "规范驱动开发工具包 v3.6。绿地项目用 /sillyspec:init，棕地项目用 /sillyspec:scan。可用命令：init、scan、scan-quick、explore、brainstorm、plan、execute、verify、archive、commit、export、status、resume、continue、quick、state、workspace、workspace-sync。"
+version: "3.6.1"
 ---
 
-# SillySpec
+# SillySpec v3.6
 
-从"你说要啥"到"代码能跑"的规范驱动开发工具包。
-Claude Code / Cursor / Codex / OpenCode / OpenClaw 通用。
+融合 Superpowers + OpenSpec + GSD，从"你说要啥"到"代码能跑"的完整流程。
+Claude Code / Cursor / Codex / OpenCode / OpenClaw 都能用。
 
-## 快速开始
+## 入口选择
 
-| 场景 | 命令 |
+| 项目类型 | 首选命令 |
 |---|---|
-| 全自动流程 | `/sillyspec:auto <需求描述>` |
 | 全新项目（空目录） | `/sillyspec:init` |
 | 已有代码的项目 | `/sillyspec:scan` |
 | 多项目工作区 | `/sillyspec:workspace` |
-| 自由思考 | `/sillyspec:explore` |
+| 随时自由思考 | `/sillyspec:explore` |
 
 ## 完整工作流
 
 ```
-绿地：init → brainstorm → plan → execute → verify → archive
-棕地：scan → brainstorm → plan → execute → verify → archive
-全自动：auto（自动推进全部阶段，支持用户确认门控）
+绿地：init → brainstorm → plan → execute → [verify] → archive
+棕地：scan → brainstorm → plan → execute → [verify] → archive
+工作区：workspace → (init/scan per project) → brainstorm → ...
 ```
 
-## 核心命令
+## 19 个命令
+
+### 核心流程
 
 | 命令 | 用途 |
 |---|---|
-| `/sillyspec:auto` | 全自动推进全部流程 |
 | `/sillyspec:init` | 绿地项目初始化 |
-| `/sillyspec:scan` | 棕地项目扫描（生成 7 份文档） |
+| `/sillyspec:scan` | 棕地项目扫描（7 份文档） |
 | `/sillyspec:brainstorm` | 需求探索 + 生成设计文档 |
-| `/sillyspec:plan` | 编写实现计划（Wave 分组 + 拓扑排序） |
+| `/sillyspec:plan` | 编写实现计划（Wave 分组） |
 | `/sillyspec:execute` | TDD 执行 + 子代理并行 |
 | `/sillyspec:verify` | 验证（测试 + 代码审查 + E2E） |
 | `/sillyspec:archive` | 归档变更 |
 
-## 辅助命令
+### 辅助工具
 
 | 命令 | 用途 |
 |---|---|
@@ -49,43 +49,39 @@ Claude Code / Cursor / Codex / OpenCode / OpenClaw 通用。
 | `/sillyspec:explore` | 自由思考模式 |
 | `/sillyspec:quick` | 快速任务，跳过完整流程 |
 | `/sillyspec:resume` | 恢复工作 |
-| `/sillyspec:doctor` | 项目自检 |
+| `/sillyspec:state` | 查看当前工作状态 |
 | `/sillyspec:commit` | 智能提交 |
 | `/sillyspec:export` | 导出成功方案为可复用模板 |
+| `/sillyspec:scan-quick` | 快速扫描（STACK + STRUCTURE） |
 | `/sillyspec:workspace` | 多项目工作区管理 |
+| `/sillyspec:workspace-sync` | 同步工作区子项目状态 |
 
 ## CLI 命令
 
 ```bash
-sillyspec run auto            全自动推进全部流程
-sillyspec run scan            执行代码扫描阶段
-sillyspec run brainstorm      执行需求探索阶段
-sillyspec run plan            执行实现计划阶段
-sillyspec run execute         执行开发阶段（子代理并行 + worktree 隔离）
-sillyspec run verify          执行验证阶段
-sillyspec run archive         执行归档阶段
-sillyspec run quick           快速任务
-sillyspec run explore         自由探索
-sillyspec progress show       显示当前项目状态
-sillyspec setup               安装推荐 MCP 工具
-sillyspec init                初始化（零交互，自动检测工具）
+sillyspec status [--json]    显示当前项目状态
+sillyspec next [--json]      显示下一步命令
+sillyspec check [--json]     检查文档完整性
+sillyspec setup              安装推荐 MCP 工具
+sillyspec setup --list       查看已安装 MCP 状态
+sillyspec init               初始化（零交互，自动检测工具）
+sillyspec init --tool <name> 指定工具安装
+sillyspec init --workspace   工作区模式
+sillyspec init --interactive 交互式引导
 ```
 
-## 核心特性
+## MCP 增强
 
-- **规范驱动** — 所有代码产出先有设计文档支撑，文档是 AI 的记忆
-- **TDD 强制** — execute 阶段强制先写测试再写实现
-- **子代理并行** — 同一 Wave 内任务并行执行，加快交付
-- **Worktree 隔离** — execute 在独立 worktree 中工作，不污染主分支
-- **拓扑排序 Wave** — plan 阶段根据蓝图依赖关系自动重排 Wave 分组
-- **E2E 验证** — 内置 E2E 测试流程，支持 Playwright / 浏览器 MCP
-- **模块文档** — 支持模块级知识库，AI 执行时按需加载相关模块上下文
-- **进度管理** — SQLite 持久化进度，断点恢复
-- **MCP 增强** — 一键安装 Context7、grep.app、Chrome DevTools
+通过 `sillyspec setup` 安装 MCP 工具增强 AI 能力：
 
-## MCP 工具
+- **Context7** — 查询最新库文档和 API 参考
+- **grep.app** — 搜索开源代码实现
+- **Chrome DevTools** — 浏览器自动化，支持 E2E 验证
 
-```bash
-sillyspec setup              安装全部推荐 MCP
-sillyspec setup --list       查看已安装 MCP 状态
+## E2E 测试流程
+
+```
+plan: 识别 UI 功能 → 检测测试框架/浏览器 MCP → 添加 E2E 任务
+execute: 编码完成后编写 E2E 测试（测试文件或 e2e-steps.md）
+verify: 按优先级执行（E2E框架 > 通用测试 > 浏览器MCP）→ 自动修复循环
 ```

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 三选一：重试 / 跳过 / 停止