sillyspec 3.9.0 → 3.10.0

package/.sillyspec/specs/2026-04-05-dashboard-design.md

@@ -1,206 +0,0 @@
-# SillySpec Dashboard 设计
-
-## 概述
-
-为 SillySpec CLI 工具添加可视化仪表盘（`sillyspec dashboard`），用户通过浏览器直观查看和管理项目进度、阶段流程、任务详情和实时日志。
-
-## 目标用户
-
-SillySpec 全部用户（官方功能，随 npm 包发布）。
-
-## 分期计划
-
-### 一期（MVP）
-
-可视化仪表盘 + CLI 命令执行 + 实时日志流。
-
-### 二期（进阶）
-
-Web Terminal（xterm.js）+ 自定义命令 + AI 交互（视需求而定）。
-
-## 架构
-
-```
-sillyspec dashboard
-        │
-        ▼
-  Node.js HTTP Server (localhost:3456)
-        │
-        ├─ chokidar: watch .sillyspec/ 目录
-        ├─ WebSocket: 实时推送状态变更
-        └─ REST API: 项目列表、状态、日志、CLI 执行
-        │
-        ▼
-  Vue 3 SPA (浏览器)
-```
-
-### 文件结构
-
-```
-sillyspec/packages/dashboard/
-├── server/
-│   ├── index.js          # HTTP + WebSocket 服务启动
-│   ├── watcher.js        # chokidar 文件监听 + 增量解析
-│   └── api.js            # REST 路由
-├── src/
-│   ├── App.vue
-│   ├── components/
-│   │   ├── ProjectList.vue     # 左栏：项目列表
-│   │   ├── PipelineView.vue    # 中栏：阶段 pipeline
-│   │   ├── StepCard.vue        # 步骤卡片（可展开折叠）
-│   │   ├── DetailPanel.vue     # 右栏：详情 + 日志
-│   │   ├── LogStream.vue       # 终端风格日志流
-│   │   ├── CommandPalette.vue  # Cmd+K 命令面板
-│   │   └── StageBadge.vue      # 阶段状态标签
-│   ├── composables/
-│   │   ├── useWebSocket.js     # WebSocket 连接管理
-│   │   └── useKeyboard.js      # 键盘快捷键
-│   └── styles/
-│       └── theme.css           # 深色主题变量
-├── package.json
-└── vite.config.js
-```
-
-## 核心页面设计
-
-### 三栏布局
-
-```
-┌──────────┬─────────────────────────┬──────────────────┐
-│ 项目列表  │    Pipeline 视图（中）    │   详情+日志（右） │
-│ (200px)  │     (flex-1)            │    (320px,可收起) │
-│          │                         │                  │
-│ 📁 proj1 │  ✅ brainstorm           │  Step 3 详情     │
-│ 📁 proj2 │  ⏳ plan ← 当前          │  结论：选择React  │
-│ 📁 proj3 │  ⬜ execute              │  决策：...       │
-│          │  ⬜ verify               │  📋 实时日志     │
-└──────────┴─────────────────────────┴──────────────────┘
-```
-
-### 信息分层（三级密度）
-
-1. **低密度（默认）**：阶段名 + 状态图标
-2. **中密度（hover）**：步骤摘要（1-2 句话）
-3. **高密度（点击）**：右侧面板展开完整详情 + 日志
-
-### 异常高亮
-
-失败/阻塞/超时步骤自动标红，视觉上突出，不需用户手动查找。
-
-## 数据源与同步
-
-### 数据文件
-
-| 文件 | 用途 |
-|---|---|
-| `STATE.md` | 当前阶段、状态、下一步命令 |
-| `.runtime/progress.json` | 步骤进度、摘要、时间戳 |
-| `.runtime/user-inputs.md` | 用户输入记录 |
-| `specs/*.md` | 设计文档 |
-| `changes/*/design.md` | 技术方案 |
-
-### 同步方案
-
-- **启动时**：全量读取 `.sillyspec/` 目录，构建初始状态
-- **运行时**：chokidar watch 文件变化 → 解析 → WebSocket 增量推送
-- **不轮询，不做 diff**，文件变化直接读取推送
-
-### CLI 命令执行（一期）
-
-后端通过 `child_process.spawn` 执行 CLI 命令：
-- "下一步"按钮 → `sillyspec next`
-- 阶段切换按钮 → `sillyspec plan` / `sillyspec execute` 等
-- 执行结果通过 WebSocket 实时推送到前端日志面板
-
-## 交互设计
-
-### 键盘快捷键
-
-| 快捷键 | 功能 |
-|---|---|
-| `j/k` | 上下切换步骤 |
-| `Enter` | 展开详情 |
-| `Escape` | 收起面板 |
-| `/` | 搜索日志 |
-| `Cmd/Ctrl+K` | 命令面板 |
-
-### 命令面板功能
-
-- 搜索项目名
-- 跳转到指定阶段
-- 切换深色/浅色主题
-
-### CLI 命令
-
-```bash
-sillyspec dashboard              # 启动 + 自动开浏览器
-sillyspec dashboard --port 8080  # 自定义端口
-sillyspec dashboard --no-open    # 不自动打开浏览器
-```
-
-## 视觉设计
-
-### 配色
-
-| 用途 | 色值 |
-|---|---|
-| 背景 | `#0D1117` |
-| 主色（进行中） | `#00D4AA` |
-| 阻塞 | `#F59E0B` |
-| 失败 | `#F87171` |
-| 未开始 | `#6B7280` |
-
-### 动效
-
-- 阶段完成：脉冲光效（CSS animation，200ms）
-- 日志新行：淡入
-- hover 过渡：100ms
-- 进度条：弹性缓动
-
-## 技术选型
-
-| 层 | 技术 |
-|---|---|
-| 前端框架 | Vue 3 |
-| 构建工具 | Vite |
-| CSS | Tailwind CSS |
-| 后端 | Node.js 原生 http + ws |
-| 文件监听 | chokidar |
-| 数据库 | 无，纯文件系统 |
-
-## 约束和假设
-
-- 用户本地已有 Node.js（SillySpec 前置依赖）
-- 仪表盘为本地工具，不考虑多用户并发
-- 前端构建产物嵌入 npm 包，无需额外 build
-- 不引入 Express、数据库等重依赖
-
-## 状态历史时间线
-
-Pipeline 视图下方展示时间线，记录每个步骤的：
-- 开始时间 / 结束时间 / 耗时
-- 状态变化（进行中 → 完成/阻塞/失败）
-- 可按时间排序，快速定位耗时最长或异常步骤
-
-数据来源：`progress.json` 中的 `summaries` 和时间戳。
-
-## 不在范围内（一期）
-
-- 用户认证/权限
-- 多人协作
-- 数据持久化（纯文件系统）
-- AI 对话交互（二期）
-- Web Terminal（二期）
-
-## 验收标准
-
-- [ ] `sillyspec dashboard` 一键启动，自动打开浏览器
-- [ ] 三栏布局正确渲染，响应式适配
-- [ ] 文件变化后前端实时更新（<1s 延迟）
-- [ ] 步骤卡片三级信息分层（默认/hover/点击）
-- [ ] 实时日志流正常显示，可搜索可过滤
-- [ ] 键盘快捷键可用（j/k/Enter/Escape/Cmd+K）
-- [ ] 命令面板可搜索项目名和阶段
-- [ ] CLI 命令执行按钮可用，结果实时显示
-- [ ] 异常步骤自动高亮
-- [ ] 深色/浅色主题切换

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

@@ -1,30 +0,0 @@
-**当需要用户从多个选项中做出选择时，必须使用 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

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

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

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

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

@@ -1,23 +0,0 @@
-评估需求范围，复杂需求拆分子项目/阶段。
-
-**满足以下任意 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

@@ -1,8 +0,0 @@
-**核心规则：一次只问一个问题。**
-
-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

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

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

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

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

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

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

@@ -1,15 +0,0 @@
-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

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

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

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

package/dist/steps/brainstorm/manifest.yaml

@@ -1,26 +0,0 @@
-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

@@ -1,41 +0,0 @@
-**当需要用户从多个选项中做出选择时，必须使用 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

@@ -1,47 +0,0 @@
-主代理在 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

@@ -1,19 +0,0 @@
-## 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

@@ -1,22 +0,0 @@
-## 执行流程
-
-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

@@ -1,54 +0,0 @@
-子代理 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

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

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

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

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

@@ -1,26 +0,0 @@
-子代理执行任务的验证步骤：运行测试。
-
-按 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

@@ -1,28 +0,0 @@
-如果测试失败或子代理返回 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 三选一：重试 / 跳过 / 停止