sillyspec 3.9.0 → 3.9.1

package/src/stages/quick.js

@@ -0,0 +1,64 @@
+export const definition = {
+  name: 'quick',
+  title: '快速任务',
+  description: '跳过完整流程，直接做',
+  auxiliary: true,
+  steps: [
+    {
+      name: '理解任务',
+      prompt: `解析任务参数，加载项目上下文。
+
+### 操作
+1. 检查是否携带 \`--change <变更名>\`，确定记录方式
+2. 理解任务：模糊则问一个问题确认
+3. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`（了解项目结构和技术栈）
+4. 加载上下文：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
+5. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、环境变量等）
+6. 如有 \`--change\`，加载设计文档：\`cat .sillyspec/changes/<变更名>/design.md 2>/dev/null\`（理解设计意图）
+7. 如有需要，查询知识库：\`cat .sillyspec/knowledge/INDEX.md 2>/dev/null\`
+
+### 输出
+任务理解 + 上下文摘要`,
+      outputHint: '任务理解',
+      optional: false
+    },
+    {
+      name: '实现并验证',
+      prompt: `实现任务。
+
+### 操作
+1. 先读后写：调用已有方法前 \`cat\` 源文件确认签名，\`grep\` 确认方法存在
+2. 写代码完成任务
+3. 如涉及逻辑变更，建议写单元测试验证（不强制，纯配置/文档/小改动可跳过）
+4. **不要编译！** 除非用户明确要求或改动量很大
+
+### 输出
+实现摘要 + 修改文件列表
+
+### 铁律
+- 不要修改无关文件
+- 不要编造不存在的 CLI 子命令
+- **Reverse Sync**：如果发现 Bug 是 design.md 遗漏导致的，先修 design.md 再修代码`,
+      outputHint: '实现摘要',
+      optional: false
+    },
+    {
+      name: '暂存和记录',
+      prompt: `Git 暂存并记录任务。
+
+### 操作
+1. \`git add -A\` — **不要 commit**，由用户通过统一提交
+2. 记录：
+   - 有 \`--change\`：在 \`.sillyspec/changes/<变更名>/tasks.md\` 追加 task 并勾选，记录精确到秒的时间戳
+   - 无 \`--change\`：记录到 \`.sillyspec/quicklog/QUICKLOG-<git用户名>.md\`（按 git 用户名隔离）
+3. QUICKLOG 轮转：超过 500 行则重命名为 \`QUICKLOG-<USER>-YYYY-MM-DD.md\`
+4. 如果发现项目特有的坑，追加到 \`.sillyspec/knowledge/uncategorized.md\`
+5. 任务比预期复杂 → 建议用完整流程
+
+### 输出
+暂存确认 + 记录路径`,
+      outputHint: '暂存和记录确认',
+      optional: false
+    }
+  ]
+}

package/src/stages/scan.js

@@ -0,0 +1,141 @@
+export const definition = {
+  name: 'scan',
+  title: '代码扫描',
+  description: '分析项目结构、约定和架构',
+  auxiliary: true,
+  steps: [
+    {
+      name: '检查已有扫描文档和子项目列表',
+      prompt: `检查已有扫描文档和子项目列表。
+
+### 操作
+1. \`ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .\` — 检查已有文档
+1. \`ls docs/*/scan/ 2>/dev/null\` — 检查已有文档
+2. \`wc -l docs/*/scan/*.md 2>/dev/null\` — 文档行数
+3. 已有 3 份 → 建议升级深度扫描；已有 7 份 → 建议刷新或跳过
+5. 显示子项目列表供选择扫描范围
+
+### 输出
+已有文档状态 + 扫描建议`,
+      outputHint: '工作区和文档状态',
+      optional: false
+    },
+    {
+      name: '构建环境探测',
+      prompt: `探测项目的构建环境和依赖。
+
+### 操作
+1. \`cat package.json pom.xml build.gradle go.mod Cargo.toml requirements.txt pyproject.toml Gemfile composer.json 2>/dev/null\`
+2. \`find . -maxdepth 2 -name "*.config.*" -not -path "*/node_modules/*" -not -path "*/.git/*" | head -20 | xargs cat 2>/dev/null\`
+3. 结果保存到 \`docs/<project>/scan/_env-detect.md\`（临时文件，扫描完删除）
+
+### 输出
+环境探测结果摘要`,
+      outputHint: '环境探测摘要',
+      optional: false
+    },
+    {
+      name: '断点续扫检测',
+      prompt: `检测已有扫描文档，只生成缺失的。
+
+### 操作
+1. \`PROJECT=$(python3 -c "import sys,json; print(json.load(open('.sillyspec/.runtime/progress.json')).get('project',''))" 2>/dev/null || basename "$(pwd)")\`
+2. 检查 7 份文档是否存在：ARCHITECTURE、STRUCTURE、CONVENTIONS、INTEGRATIONS、TESTING、CONCERNS、PROJECT
+3. 列出已有 ✅ 和缺失 ⬜
+4. 只生成缺失的文档
+
+### 输出
+已有/缺失文档列表`,
+      outputHint: '断点续扫状态',
+      optional: false
+    },
+    {
+      name: '深度扫描 — 技术架构',
+      prompt: `扫描技术栈 + 数据库 Schema + 架构模式。参考 _env-detect.md。
+
+### 操作
+1. 用 grep/rg 搜索（\`@Entity\`、\`schema.prisma\`、\`models.py\` 等），**禁止读源码全文**
+2. Schema 只记表名+说明+字段数
+3. 写入 \`docs/<project>/scan/ARCHITECTURE.md\`
+4. 包含 \`## 技术栈\` \`## 架构概览\` \`## 数据模型（摘要）\`
+
+### 输出
+ARCHITECTURE.md 路径
+
+### 注意
+- 路径用反引号，不编造`,
+      outputHint: 'ARCHITECTURE.md 路径',
+      optional: false
+    },
+    {
+      name: '深度扫描 — 代码约定',
+      prompt: `扫描框架隐形规则 + 实体继承 + 代码风格。参考 _env-detect.md。
+
+### 操作
+1. 用 grep 搜索拦截器/插件/逻辑删除/基类/审计字段，**禁止读源码全文**
+2. 根据检测到的语言/框架自行决定搜索什么模式
+3. 提取 3-5 个典型示例
+4. 写入 \`docs/<project>/scan/CONVENTIONS.md\`
+5. 包含 \`## 框架隐形规则\` \`## 实体继承规范\` \`## 代码风格\`
+
+### 输出
+CONVENTIONS.md 路径
+
+### 注意
+- 路径用反引号，不编造`,
+      outputHint: 'CONVENTIONS.md 路径',
+      optional: false
+    },
+    {
+      name: '深度扫描 — 目录结构和集成',
+      prompt: `扫描目录结构 + 外部集成。参考 _env-detect.md。
+
+### 操作
+1. 用 find/ls/tree 和 grep，**禁止读源码全文**
+2. 搜索 API 调用、MQ 配置、缓存、第三方 SDK
+3. 写入 \`docs/<project>/scan/STRUCTURE.md\`（目录树+模块说明）
+4. 写入 \`docs/<project>/scan/INTEGRATIONS.md\`（按类型分组）
+
+### 输出
+STRUCTURE.md 和 INTEGRATIONS.md 路径
+
+### 注意
+- 路径用反引号，不编造`,
+      outputHint: 'STRUCTURE.md + INTEGRATIONS.md 路径',
+      optional: false
+    },
+    {
+      name: '深度扫描 — 测试和债务',
+      prompt: `扫描测试现状 + 技术债务 + 项目概览。参考 _env-detect.md。
+
+### 操作
+1. 用 grep 搜索测试文件、TODO/FIXME、过时依赖，**禁止读源码全文**
+2. 写入 \`docs/<project>/scan/TESTING.md\`（测试结构）
+3. 写入 \`docs/<project>/scan/CONCERNS.md\`（按严重程度分组）
+4. 写入 \`docs/<project>/scan/PROJECT.md\`（项目信息）
+
+### 输出
+TESTING.md、CONCERNS.md、PROJECT.md 路径`,
+      outputHint: '三份文档路径',
+      optional: false
+    },
+    {
+      name: '自检和提交',
+      prompt: `验证扫描完整性，清理并提交。
+
+### 操作
+1. 检查 7 份文档是否全部生成
+2. 自检门控：ARCHITECTURE（技术栈+Schema摘要）、CONVENTIONS（隐形规则+代码风格）、STRUCTURE（目录结构）、INTEGRATIONS（外部依赖）、TESTING（测试现状）、CONCERNS（技术债务）、PROJECT（项目概览）
+3. 清理：\`rm -f docs/<project>/scan/_env-detect.md\`
+4. \`git add .\` — **不要 commit**，由用户通过统一提交工具处理
+
+### 输出
+扫描完整性报告
+
+### 注意
+- ❌ 修改代码 / 编造路径 / 读源码全文`,
+      outputHint: '自检报告',
+      optional: false
+    }
+  ]
+}

package/src/stages/status.js

@@ -0,0 +1,65 @@
+export const definition = {
+  name: 'status',
+  title: '状态查看',
+  description: '查看项目进度和状态',
+  auxiliary: true,
+  steps: [
+    {
+      name: '项目基础信息',
+      prompt: `收集项目基础信息。
+
+### 操作
+1. \`cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"\`
+2. 获取 project 名
+3. \`ls docs/<project>/scan/ 2>/dev/null | head -10\`
+4. \`cat .sillyspec/REQUIREMENTS.md 2>/dev/null | head -20\`
+5. \`cat .sillyspec/ROADMAP.md 2>/dev/null\`
+
+### 输出
+项目基础信息摘要`,
+      outputHint: '项目基础信息',
+      optional: false
+    },
+    {
+      name: '变更状态',
+      prompt: `检查进行中的变更和归档历史。
+
+### 操作
+1. \`ls .sillyspec/changes/ 2>/dev/null | grep -v archive\`
+2. 对每个进行中的变更：检查 proposal.md ✅/❌、design.md ✅/❌、requirements.md ✅/❌、tasks.md — X/Y 完成
+3. \`ls .sillyspec/changes/archive/ 2>/dev/null | wc -l\`
+4. \`cat .sillyspec/HANDOFF.json 2>/dev/null\`
+
+### 输出
+变更状态列表`,
+      outputHint: '变更状态',
+      optional: false
+    },
+    {
+      name: '输出状态报告',
+      prompt: `生成完整状态报告。
+
+### 输出格式：
+\`\`\`
+📊 SillySpec 状态
+
+📋 项目：xxx（已初始化 / 未初始化）
+📂 代码库：已扫描（7 份文档）/ 未扫描
+
+🔄 进行中：N 个变更
+  - [change-1] Phase 3 (Execute) — tasks 5/8
+
+✅ 已归档：N 个变更
+📝 设计文档：N 份
+📝 实现计划：N 份
+
+💡 下一步：/sillyspec:continue
+\`\`\`
+
+### 注意
+- 不修改任何文件`,
+      outputHint: '状态报告',
+      optional: false
+    }
+  ]
+}

package/src/stages/verify.js

@@ -0,0 +1,135 @@
+export const definition = {
+  name: 'verify',
+  title: '验证确认',
+  description: '对照规范检查 + 测试套件',
+  steps: [
+    {
+      name: '状态检查',
+      prompt: `检查当前状态，确认可以执行 verify。
+
+### 操作
+1. 运行 \`sillyspec progress show\`
+2. 确认 currentStage 为 "verify"
+
+### 输出
+当前状态摘要`,
+      outputHint: '状态摘要',
+      optional: false
+    },
+    {
+      name: '加载规范并锚定',
+      prompt: `加载规范文件并确认。
+
+### 操作
+1. 读取 proposal.md、design.md、tasks.md、requirements.md
+2. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`
+3. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、lint 命令等）
+4. 加载代码规范：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
+5. 标注每个文件的存在/不存在状态
+
+### 输出
+文件加载确认清单`,
+      outputHint: '文件确认清单',
+      optional: false
+    },
+    {
+      name: '逐项检查任务',
+      prompt: `对照 tasks.md 检查每个任务完成状态。
+
+### 操作
+对每个 checkbox：
+1. 检查相关文件是否存在
+2. 检查代码是否实现了描述的功能
+3. 标记：✅ 已完成 / ❌ 未完成 / ⚠️ 部分完成
+
+### 批量模式验证指引
+如果 tasks.md 中有批量特征（引擎/模板/配置/批量生成），采用分层验证：
+- **L1 自动化（100%）**：运行验证脚本（如有），检查所有实例的文件存在、格式正确、Schema 校验通过
+- **L2 AI 抽查（5-10 个）**：选择最复杂的 3 个 + 最简单的 2 个 + 有特殊逻辑的，检查业务逻辑正确性
+- **L3 模式性 bug 检测**：L2 发现 bug → 判断是否为系统性问题 → 系统性 bug 则回退修复引擎并重新生成所有实例
+
+### 输出
+任务完成度列表 + 完成率
+
+### 注意
+- 不修改任何代码，只做检查和报告`,
+      outputHint: '任务完成度报告',
+      optional: false
+    },
+    {
+      name: '对照设计检查',
+      prompt: `对照 design.md 检查实现一致性。**design.md 是唯一 truth source，不符合 design.md 的实现 = Bug。**
+
+### 操作
+1. 架构决策是否遵循
+2. 文件变更清单是否一致
+3. 数据模型是否符合
+4. API 设计是否符合
+5. **Reverse Sync 检查**：如果发现实现合理但 design.md 未覆盖，先更新 design.md 补充遗漏
+
+### 输出
+一致性检查结果`,
+      outputHint: '设计一致性报告',
+      optional: false
+    },
+    {
+      name: '任务蓝图验收',
+      prompt: `检查每个 task-N.md 的验收标准是否全部满足。
+
+### 操作
+1. 检查变更目录下 tasks/ 是否存在
+2. 如果存在：
+   - 逐个读取 tasks/task-NN.md
+   - 检查每个文件的「验收标准」checkbox 是否全部勾选
+   - 未勾选的项列为不通过
+3. 如果不存在：跳过此步骤
+
+### 输出
+验收结果：通过/不通过 + 未通过的项`,
+      outputHint: '验收结果',
+      optional: false
+    },
+    {
+      name: '运行测试和质量扫描',
+      prompt: `运行测试和代码质量扫描。
+
+### 操作
+1. 读取 \`.sillyspec/local.yaml\` 获取构建和测试命令
+2. 如果 local.yaml 有 test 命令，使用它（仅测试变更涉及的模块，非全量）
+3. 如果 local.yaml 无 test 命令，根据项目类型选择：
+   - Maven：\`mvn test -pl <变更模块> -am\`（仅编译变更模块及其依赖）
+   - Gradle：\`./gradlew :<模块>:test\`
+   - npm/pnpm：\`pnpm test --filter=<包名>\` 或 \`npm test -- --testPathPattern=<相关文件>\`
+   - Python：\`pytest <变更模块路径>/\`
+4. 记录通过/失败数量，分析失败原因
+5. 搜索技术债务：grep TODO/FIXME/HACK/XXX（仅限变更文件）
+6. 如果 local.yaml 有 lint 命令，运行 lint 检查
+
+### 注意
+- 不要全量编译/测试整个项目，只测变更涉及的模块
+- 如果变更模块不确定，优先使用 local.yaml 中的命令
+
+### 输出
+测试结果 + 技术债务标记`,
+      outputHint: '测试结果 + 技术债务',
+      optional: false
+    },
+    {
+      name: '输出验证报告',
+      prompt: `生成完整验证报告。
+
+### 操作
+1. 汇总以上所有检查结果
+2. 给出结论：PASS / PASS WITH NOTES / FAIL
+
+### 输出
+验证报告 markdown + 下一步命令
+
+### 注意
+- PASS → 下一步 archive
+- FAIL → 修复后重新 verify`,
+      outputHint: '验证报告',
+      optional: false
+    }
+  ]
+}

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。
-
-追加铁律：**参照已有测试风格编写新测试，不要凭记忆写测试。**