sillyspec 3.9.1 → 3.10.1

package/src/stages/plan.js

@@ -140,7 +140,6 @@ export const fixedSuffix = [
 
 ### 操作
 1. 确认 plan.md 和所有 tasks/task-NN.md 已存在
-2. \`git add .sillyspec/\` — **不要 commit**
 
 ### 输出
 文件列表 + 下一步命令`,
@@ -218,6 +217,88 @@ ${taskName}
 任务蓝图内容摘要`
 }
 
+/**
+ * 构建任务蓝图协调器步骤（单步，子代理并行写蓝图）
+ */
+export function buildCoordinatorStep(changeDir, taskNames) {
+  const taskList = taskNames.map((name, i) => {
+    const num = String(i + 1).padStart(2, '0')
+    return `- task-${num}: ${name}`
+  }).join('\n')
+
+  const subagentPrompts = taskNames.map((name, i) => {
+    const num = String(i + 1).padStart(2, '0')
+    return `\`\`\`
+任务编号：task-${num}
+任务名称：${name}
+文件路径：${changeDir}/tasks/task-${num}.md
+
+操作：
+1. 读取 ${changeDir}/design.md 和 ${changeDir}/plan.md 了解上下文
+2. 读取相关源文件了解现有代码
+3. 按以下格式编写任务蓝图并保存到 ${changeDir}/tasks/task-${num}.md：
+
+# task-${num}: ${name}
+
+## 修改文件
+- 文件路径列表
+
+## 实现要求
+1. 具体做什么
+
+## 接口定义
+（代码类任务必填）
+
+## 边界处理
+- 异常场景
+
+## 参考
+- 可参考的模式
+
+## TDD 步骤
+1. 写测试 → 2. 确认失败 → 3. 写代码 → 4. 确认通过
+
+## 验收标准
+- [ ] 具体可测试的条件
+
+关键规则：
+- 必须独立完整，execute 子代理只读这一个文件就能干活
+- 不要依赖其他 task-N.md 的内容
+- 接口定义写到"搬砖工照着做"的程度
+- 写完后用 Write tool 保存到文件
+\`\`\``
+  }).join('\n\n')
+
+  return {
+    name: '生成任务蓝图（子代理并行）',
+    prompt: `为 plan.md 中的每个任务生成独立蓝图文件。
+
+## 任务清单
+${taskList}
+
+## 执行方式（必须严格遵守）
+
+**你必须使用 Agent tool 启动子代理来写每个蓝图，不要自己写。**
+
+1. 确认 \`${changeDir}/tasks/\` 目录存在（不存在则创建）
+2. 为每个任务启动一个独立子代理（Agent tool），可并行启动多个
+3. 每个子代理使用对应的 prompt（见下方模板）
+4. 等待所有子代理完成
+5. 验证每个 task-N.md 文件已生成且非空
+
+### 子代理 prompt 模板
+为每个任务使用以下 prompt 启动子代理：
+
+${subagentPrompts}
+
+## 验收
+- 每个 task-N.md 文件存在且非空
+- 包含所有必要章节：修改文件、实现要求、接口定义、边界处理、TDD 步骤、验收标准`,
+    outputHint: '蓝图生成结果',
+    optional: false
+  }
+}
+
 /**
  * 从 plan.md 解析任务名列表
  */
@@ -255,8 +336,7 @@ export function buildPlanSteps(changeDir = null, planContent = null) {
     return [...fixedPrefix, ...fixedSuffix]
   }
 
-  // 动态生成每个任务的蓝图写作步骤
-  // 尝试从 plan.md 解析任务名
+  // 解析任务名
   let taskNames = []
   if (planContent) {
     taskNames = parseTaskNames(planContent)
@@ -267,16 +347,7 @@ export function buildPlanSteps(changeDir = null, planContent = null) {
     }
   }
 
-  const taskSteps = []
-  for (let i = 1; i <= taskCount; i++) {
-    const taskName = taskNames[i - 1] || '（从 plan.md 读取任务名）'
-    taskSteps.push({
-      name: `写任务蓝图 task-${String(i).padStart(2, '0')}`,
-      prompt: `### 注意\n这是第 ${i}/${taskCount} 个任务蓝图。focus 在这一个任务上，不要写其他任务的内容。\n\n${buildTaskPrompt(i, taskName, changeDir)}`,
-      outputHint: `task-${String(i).padStart(2, '0')} 蓝图`,
-      optional: false
-    })
-  }
-
-  return [...fixedPrefix, ...taskSteps, ...fixedSuffix]
+  // 生成单个协调器步骤（子代理并行写蓝图）
+  const coordinatorStep = buildCoordinatorStep(changeDir, taskNames)
+  return [...fixedPrefix, coordinatorStep, ...fixedSuffix]
 }

package/src/stages/quick.js

@@ -47,7 +47,7 @@ export const definition = {
       prompt: `Git 暂存并记录任务。
 
 ### 操作
-1. \`git add -A\` — **不要 commit**，由用户通过统一提交
+1. \`git add -A\` — 暂存改动文件（不要 commit，由用户通过统一提交工具处理）
 2. 记录：
    - 有 \`--change\`：在 \`.sillyspec/changes/<变更名>/tasks.md\` 追加 task 并勾选，记录精确到秒的时间戳
    - 无 \`--change\`：记录到 \`.sillyspec/quicklog/QUICKLOG-<git用户名>.md\`（按 git 用户名隔离）

package/src/stages/scan.js

@@ -10,8 +10,8 @@ export const definition = {
 
 ### 操作
 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\` — 文档行数
+1. \`ls .sillyspec/docs/*/scan/ 2>/dev/null\` — 检查已有文档
+2. \`wc -l .sillyspec/docs/*/scan/*.md 2>/dev/null\` — 文档行数
 3. 已有 3 份 → 建议升级深度扫描；已有 7 份 → 建议刷新或跳过
 5. 显示子项目列表供选择扫描范围
 
@@ -27,7 +27,7 @@ export const definition = {
 ### 操作
 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\`（临时文件，扫描完删除）
+3. 结果保存到 \`.sillyspec/docs/<project>/scan/_env-detect.md\`（临时文件，扫描完删除）
 
 ### 输出
 环境探测结果摘要`,
@@ -56,7 +56,7 @@ export const definition = {
 ### 操作
 1. 用 grep/rg 搜索（\`@Entity\`、\`schema.prisma\`、\`models.py\` 等），**禁止读源码全文**
 2. Schema 只记表名+说明+字段数
-3. 写入 \`docs/<project>/scan/ARCHITECTURE.md\`
+3. 写入 \`.sillyspec/docs/<project>/scan/ARCHITECTURE.md\`
 4. 包含 \`## 技术栈\` \`## 架构概览\` \`## 数据模型（摘要）\`
 
 ### 输出
@@ -75,7 +75,7 @@ ARCHITECTURE.md 路径
 1. 用 grep 搜索拦截器/插件/逻辑删除/基类/审计字段，**禁止读源码全文**
 2. 根据检测到的语言/框架自行决定搜索什么模式
 3. 提取 3-5 个典型示例
-4. 写入 \`docs/<project>/scan/CONVENTIONS.md\`
+4. 写入 \`.sillyspec/docs/<project>/scan/CONVENTIONS.md\`
 5. 包含 \`## 框架隐形规则\` \`## 实体继承规范\` \`## 代码风格\`
 
 ### 输出
@@ -93,8 +93,8 @@ CONVENTIONS.md 路径
 ### 操作
 1. 用 find/ls/tree 和 grep，**禁止读源码全文**
 2. 搜索 API 调用、MQ 配置、缓存、第三方 SDK
-3. 写入 \`docs/<project>/scan/STRUCTURE.md\`（目录树+模块说明）
-4. 写入 \`docs/<project>/scan/INTEGRATIONS.md\`（按类型分组）
+3. 写入 \`.sillyspec/docs/<project>/scan/STRUCTURE.md\`（目录树+模块说明）
+4. 写入 \`.sillyspec/docs/<project>/scan/INTEGRATIONS.md\`（按类型分组）
 
 ### 输出
 STRUCTURE.md 和 INTEGRATIONS.md 路径
@@ -110,15 +110,54 @@ STRUCTURE.md 和 INTEGRATIONS.md 路径
 
 ### 操作
 1. 用 grep 搜索测试文件、TODO/FIXME、过时依赖，**禁止读源码全文**
-2. 写入 \`docs/<project>/scan/TESTING.md\`（测试结构）
-3. 写入 \`docs/<project>/scan/CONCERNS.md\`（按严重程度分组）
-4. 写入 \`docs/<project>/scan/PROJECT.md\`（项目信息）
+2. 写入 \`.sillyspec/docs/<project>/scan/TESTING.md\`（测试结构）
+3. 写入 \`.sillyspec/docs/<project>/scan/CONCERNS.md\`（按严重程度分组）
+4. 写入 \`.sillyspec/docs/<project>/scan/PROJECT.md\`（项目信息）
 
 ### 输出
 TESTING.md、CONCERNS.md、PROJECT.md 路径`,
       outputHint: '三份文档路径',
       optional: false
     },
+    {
+      name: '生成本地配置',
+      prompt: `自动生成 .sillyspec/.runtime/local.yaml 本地配置文件。
+
+### 操作
+1. 检查 .sillyspec/.runtime/local.yaml 是否已存在，已存在则跳过（提示"local.yaml 已存在，跳过生成"）
+2. 根据项目类型生成默认配置：
+   - **Node.js**（有 package.json）：build: "npm run build", test: "npm test", lint: "npm run lint", type: nodejs
+   - **Maven**（有 pom.xml）：build: "mvn compile", test: "mvn test", lint: "mvn checkstyle:check", type: maven
+   - **Gradle**（有 build.gradle）：build: "./gradlew build", test: "./gradlew test", type: gradle
+   - **通用项目**：只写注释模板, type: generic
+3. 确保目录存在：mkdir -p .sillyspec/.runtime
+4. 原子写入（先写 tmp 文件再 rename）
+
+### 文件格式
+\`\`\`yaml
+# SillySpec 本地配置（自动生成，可手动修改）
+project:
+  type: nodejs  # nodejs/maven/gradle/generic
+
+commands:
+  build: "npm run build"
+  test: "npm test"
+  lint: "npm run lint"
+
+# 测试策略：full=全量测试, module=只测变更模块, skip=跳过测试
+test_strategy: module
+
+# 模块测试路径映射（可选）
+# module_paths:
+#   user-service: "user/"
+#   order-service: "order/"
+\`\`\`
+
+### 输出
+local.yaml 生成结果（已存在/已生成）`,
+      outputHint: 'local.yaml 生成状态',
+      optional: false
+    },
     {
       name: '自检和提交',
       prompt: `验证扫描完整性，清理并提交。
@@ -126,8 +165,8 @@ TESTING.md、CONCERNS.md、PROJECT.md 路径`,
 ### 操作
 1. 检查 7 份文档是否全部生成
 2. 自检门控：ARCHITECTURE（技术栈+Schema摘要）、CONVENTIONS（隐形规则+代码风格）、STRUCTURE（目录结构）、INTEGRATIONS（外部依赖）、TESTING（测试现状）、CONCERNS（技术债务）、PROJECT（项目概览）
-3. 清理：\`rm -f docs/<project>/scan/_env-detect.md\`
-4. \`git add .\` — **不要 commit**，由用户通过统一提交工具处理
+3. 清理：\`rm -f .sillyspec/docs/<project>/scan/_env-detect.md\`
+4. \`git add .sillyspec/\` — 暂存扫描结果（不要 commit，由用户通过统一提交工具处理）
 
 ### 输出
 扫描完整性报告

package/src/stages/status.js

@@ -11,7 +11,7 @@ export const definition = {
 ### 操作
 1. \`cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"\`
 2. 获取 project 名
-3. \`ls docs/<project>/scan/ 2>/dev/null | head -10\`
+3. \`ls .sillyspec/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\`
 

package/src/stages/verify.js

@@ -58,9 +58,38 @@ export const definition = {
     },
     {
       name: '对照设计检查',
-      prompt: `对照 design.md 检查实现一致性。**design.md 是唯一 truth source，不符合 design.md 的实现 = Bug。**
-
-### 操作
+      prompt: `先运行自动探针，再对照 design.md 检查实现一致性。**design.md 是唯一 truth source，不符合 design.md 的实现 = Bug。**
+
+### 自动探针（必须先执行）
+在检查前，依次运行以下三个探针，将结果作为验证输入：
+
+**探针 1：未实现标记扫描**
+在项目源码目录中搜索未实现标记：
+\`\`\`bash
+grep -rn "尚未实现\|TODO\|FIXME\|HACK\|XXX" <源码目录>/ --include="*.java" --include="*.js" --include="*.ts" --include="*.jsx" --include="*.tsx" --include="*.py"
+\`\`\`
+记录每个匹配的文件、行号和内容。
+
+**探针 2：设计关键词覆盖探针**
+1. 读取 design.md，从中提取所有能力关键词（如"登录"、"导出"、"批量"、"删除"、"搜索"等动作词）
+2. 对每个关键词，在源码目录中 grep 确认是否有对应的实现代码：
+\`\`\`bash
+grep -rl "<关键词>" <源码目录>/ --include="*.java" --include="*.js" --include="*.ts" --include="*.jsx" --include="*.tsx" --include="*.py"
+\`\`\`
+3. 如果某个关键词在源码中完全没有匹配，标记为 ⚠️ 可能未实现
+
+**探针 3：验收标准测试覆盖探针**
+1. 读取变更目录下的 tasks.md，提取所有 checkbox 任务
+2. 对每个 task，检查对应模块目录下是否存在测试文件（*test*、*spec*、*Test*、*Spec*）
+3. 没有测试文件的 task 标记为 ⚠️ 缺少测试
+
+### 探针结果处理
+- 将三个探针的结果汇总为「探针报告」
+- 如果探针发现问题（未实现标记、关键词缺失、测试缺失），在最终验证报告中明确标注
+- 探针发现的问题不等同于验证失败，但必须在报告中列出
+
+### 设计一致性检查
+基于探针结果，继续检查：
 1. 架构决策是否遵循
 2. 文件变更清单是否一致
 3. 数据模型是否符合
@@ -68,7 +97,7 @@ export const definition = {
 5. **Reverse Sync 检查**：如果发现实现合理但 design.md 未覆盖，先更新 design.md 补充遗漏
 
 ### 输出
-一致性检查结果`,
+探针报告 + 设计一致性检查结果`,
       outputHint: '设计一致性报告',
       optional: false
     },
@@ -126,8 +155,8 @@ export const definition = {
 验证报告 markdown + 下一步命令
 
 ### 注意
-- PASS → 下一步 archive
-- FAIL → 修复后重新 verify`,
+- PASS → 运行 \`sillyspec run archive\` 归档
+- FAIL → 修复后运行 \`sillyspec run verify\` 重新验证`,
       outputHint: '验证报告',
       optional: false
     }

package/.sillyspec/changes/archive/2026-04-08-derive-state/design.md

@@ -1,97 +0,0 @@
-# deriveState 状态推导
-
-author: qinyi
-created_at: 2026-04-08 07:10:00
-
-## 背景
-
-当前 sillyspec 的状态管理依赖 `progress.json` 作为唯一数据源。如果 AI 崩溃或异常中断，progress.json 可能与实际产出不一致（如 artifacts 文件已生成但步骤未标记完成）。
-
-借鉴 GSD v2 的 deriveState 架构，从文件系统反推状态，与 progress.json 交叉校验。
-
-## 需求
-
-1. `--done` 完成步骤时轻量校验当前步骤
-2. `doctor` 自检时全量扫描所有阶段
-3. `progress validate --deep` 支持手动触发全量校验
-4. 安全修复策略：明显正确的情况自动修复，有歧义的不动
-
-## 设计
-
-### 新增文件：`src/derive.js`
-
-纯函数模块，零外部依赖（仅 fs/path）。
-
-```js
-export function deriveState(cwd, options = {}) {
-  // options.mode: 'light' | 'full'（默认 light）
-  // options.fix: boolean（默认 false，只报告不修复）
-  // 返回 { issues: [{type, severity, step, artifact, suggestion}], fixed: number }
-}
-```
-
-#### 扫描逻辑
-
-1. 读取 progress.json，获取所有阶段步骤状态
-2. 扫描 `.sillyspec/.runtime/artifacts/` 目录
-3. 文件名格式：`{stage}-step{N}-{timestamp}.txt`
-4. 解析文件名提取 stage、stepIndex 信息
-5. 对比规则：
-
-| 情况 | 严重度 | 自动修复 |
-|------|--------|----------|
-| artifacts 有文件但 progress 标记未完成 | issue | ✅ 标记为 done |
-| progress 标记已完成但 artifacts 无文件 | warning | ❌ 可能被手动清理 |
-| artifacts 有 step5 但 progress 只到 step3 | issue | ✅ 补齐中间步骤 |
-
-#### 模式
-
-- **light**：只检查 currentStage 的当前步骤和前一步
-- **full**：检查所有阶段所有步骤
-
-### 集成方式
-
-#### 1. run.js — `--done` 轻量校验
-
-在 `completeStep` 末尾：
-```js
-import { deriveState } from './derive.js';
-const result = deriveState(cwd, { mode: 'light', fix: true });
-if (result.fixed > 0) {
-  console.log(`⚠️ 状态修复：${result.fixed} 个步骤已从 artifacts 恢复`);
-}
-```
-
-#### 2. doctor.js — 全量扫描
-
-第一步（SillySpec 内部检查）调用：
-```js
-const result = deriveState(cwd, { mode: 'full', fix: false });
-// 将 issues 加入自检报告
-```
-
-#### 3. progress.js — `validate --deep`
-
-validate 方法支持 deep 参数：
-```js
-validate(cwd, deep = false) {
-  // ...现有校验逻辑...
-  if (deep) {
-    const result = deriveState(cwd, { mode: 'full', fix: true });
-    // 输出校验结果
-  }
-}
-```
-
-CLI：`sillyspec progress validate --deep`
-
-## 改动范围
-
-- 新增：`src/derive.js`（~80 行）
-- 修改：`src/run.js`（2 行）、`src/stages/doctor.js`（3 行）、`src/progress.js`（5 行）、`src/index.js`（parse --deep）
-
-## 不做的事
-
-- 不引入 SQLite 或其他新依赖
-- 不改变 progress.json 的数据结构
-- 不自动删除 progress 中有但 artifacts 无的步骤（可能被手动清理）

package/.sillyspec/changes/archive/2026-04-08-derive-state/plan.md

@@ -1,51 +0,0 @@
-# deriveState 状态推导 — 实现计划
-
-author: qinyi
-created_at: 2026-04-08 07:12:00
-
-## Wave 1（核心，无依赖）
-
-- [ ] 实现 derive.js 核心函数
-  - 新增: `src/derive.js`
-  - 步骤:
-    1. 实现 `deriveState(cwd, options)` 纯函数
-    2. 实现 artifacts 文件名解析（`{stage}-step{N}-{timestamp}.txt`）
-    3. 实现 light/full 模式扫描逻辑
-    4. 实现安全修复策略（issues 分类 + fix 逻辑）
-    5. 验证: 在 sillyspec 项目上手动创建测试 artifacts，运行 `node -e "import('./src/derive.js').then(m => console.log(m.deriveState(process.cwd(), {mode:'full'})))"` 确认输出
-
-## Wave 2（集成，依赖 Wave 1）
-
-- [ ] 集成 run.js --done 轻量校验
-  - 修改: `src/run.js`
-  - 参考: `completeStep` 函数末尾
-  - 步骤:
-    1. 在 completeStep 末尾 import 并调用 deriveState(cwd, {mode:'light', fix:true})
-    2. 有修复时输出警告信息
-    3. 验证: 运行 brainstorm 完成 --done，确认无报错
-
-- [ ] 扩展 validate 支持 --deep
-  - 修改: `src/progress.js`
-  - 参考: `validate()` 方法
-  - 步骤:
-    1. validate 方法加 deep 参数
-    2. deep=true 时调用 deriveState(cwd, {mode:'full', fix:true})
-    3. 验证: `sillyspec progress validate --deep` 确认输出校验结果
-
-- [ ] CLI parse --deep 参数
-  - 修改: `src/index.js`
-  - 参考: progress 子命令的参数解析
-  - 步骤:
-    1. 在 progress validate 命令中解析 --deep flag
-    2. 传递给 validate 方法
-    3. 验证: `sillyspec progress validate --deep` 确认 flag 生效
-
-## Wave 3（集成，依赖 Wave 1）
-
-- [ ] 集成 doctor.js 全量扫描
-  - 修改: `src/stages/doctor.js`
-  - 参考: doctor 第一步（SillySpec 内部检查）的 prompt
-  - 步骤:
-    1. 在第一步 prompt 中加入 deriveState 全量扫描指令
-    2. 将 issues 列表纳入自检报告
-    3. 验证: `sillyspec run doctor` 确认第一步输出包含状态一致性检查

package/.sillyspec/changes/archive/2026-04-08-derive-state/proposal.md

@@ -1,29 +0,0 @@
-# deriveState 状态推导 — 提案
-
-author: qinyi
-created_at: 2026-04-08 07:11:00
-
-## 动机
-
-当前 progress.json 是 sillyspec 唯一的状态数据源。AI 崩溃或异常中断时，progress.json 可能与实际产出不一致（artifacts 已生成但步骤未标记完成）。需要从文件系统反推状态，交叉校验。
-
-## 变更范围
-
-- 新增 `src/derive.js`（状态推导纯函数）
-- 修改 `src/run.js`（--done 轻量校验）
-- 修改 `src/stages/doctor.js`（全量扫描）
-- 修改 `src/progress.js`（validate --deep）
-- 修改 `src/index.js`（parse --deep 参数）
-
-## 不在范围内
-
-- 不改 progress.json 数据结构
-- 不引入新依赖
-- 不自动删除 progress 中有但 artifacts 无的步骤
-
-## 成功标准
-
-1. `--done` 完成步骤时自动校验并修复当前步骤
-2. `doctor` 输出全量状态一致性报告
-3. `sillyspec progress validate --deep` 可手动触发全量校验
-4. 所有校验通过现有测试

package/.sillyspec/changes/archive/2026-04-08-derive-state/requirements.md

@@ -1,34 +0,0 @@
-# deriveState 状态推导 — 需求
-
-author: qinyi
-created_at: 2026-04-08 07:11:00
-
-## 功能需求
-
-### FR1: deriveState 核心函数
-- 从 artifacts 目录扫描文件，解析 `{stage}-step{N}-{timestamp}.txt` 格式
-- 与 progress.json 步骤状态对比
-- 返回 issues 列表和修复计数
-
-### FR2: 轻量模式（light）
-- 只检查 currentStage 的当前步骤和前一步
-- 用于 `--done` 完成时
-
-### FR3: 全量模式（full）
-- 检查所有阶段所有步骤
-- 用于 doctor 和 validate --deep
-
-### FR4: 安全修复策略
-- artifacts 有但 progress 漏记 → 自动修复为 done
-- artifacts 有 step5 但 progress 只到 step3 → 自动补齐
-- progress 有但 artifacts 无 → 只警告，不修复
-
-### FR5: CLI 集成
-- `--done` 时静默调用轻量校验，有修复才输出
-- `doctor` 第一步输出全量报告
-- `sillyspec progress validate --deep` 手动触发
-
-## 非功能需求
-- 零外部依赖（仅 fs/path）
-- 纯函数，易于测试
-- 不改变现有 API 行为

package/.sillyspec/changes/archive/2026-04-08-derive-state/tasks.md

@@ -1,13 +0,0 @@
-# deriveState 状态推导 — 任务
-
-author: qinyi
-created_at: 2026-04-08 07:11:00
-
-## 任务列表
-
-- [x] 实现 derive.js 核心函数 — `src/derive.js`
-- [x] 集成 run.js --done 轻量校验 — `src/run.js`
-- [x] 集成 doctor.js 全量扫描 — `src/stages/doctor.js`
-- [x] 扩展 validate 支持 --deep — `src/progress.js`
-- [x] CLI parse --deep 参数 — `src/index.js`
-- [ ] 测试验证

package/.sillyspec/changes/archive/2026-04-08-derive-state/verify-result.md

@@ -1,43 +0,0 @@
-# derive-state 验证报告
-
-author: qinyi
-created_at: 2026-04-08 07:21:00
-
-## 结论：✅ PASS
-
-## 检查结果
-
-### 1. 规范文件加载
-- ✅ design.md
-- ✅ proposal.md
-- ✅ requirements.md
-- ✅ tasks.md
-- ✅ plan.md
-
-### 2. 任务完成度：5/6 (83%)
-- ✅ 实现 derive.js 核心函数
-- ✅ 集成 run.js --done 轻量校验
-- ✅ 集成 doctor.js 全量扫描
-- ✅ 扩展 validate 支持 --deep
-- ✅ CLI parse --deep 参数
-- ⬜ 测试验证（本项目无自动化测试套件，通过手动验证替代）
-
-### 3. 设计一致性
-- ✅ derive.js 纯函数模块，零外部依赖（仅 fs/path）
-- ✅ light/full 模式
-- ✅ fix 参数 + 安全修复策略
-- ✅ run.js --done 轻量校验集成
-- ✅ doctor.js 全量扫描集成
-- ✅ progress.js validate --deep 支持
-- ✅ index.js CLI --deep 参数
-- ✅ 改动文件范围与 design.md 一致
-
-### 4. 测试和质量
-- ✅ derive.js 模块导入正常
-- ✅ sillyspec progress validate --deep 通过
-- ✅ 无 TODO/FIXME/HACK/XXX 技术债务
-- ✅ sillyspec run quick --status 正常
-- ✅ sillyspec run doctor --status 正常
-
-## 下一步
-sillyspec run archive

package/.sillyspec/changes/auto-mode/design.md

@@ -1,50 +0,0 @@
-# auto mode — 设计文档
-
-author: qinyi
-created_at: 2026-04-08 07:28:00
-
-## 背景
-
-当前 sillyspec 的每个阶段（brainstorm → plan → execute → verify）需要用户手动执行 `sillyspec run <stage>` 和 `sillyspec run <stage> --done`。用户希望一个自动模式，从 brainstorm 一路推进到 verify 完成。
-
-## 需求
-
-1. 用户启动一次，AI 自动循环所有阶段和步骤
-2. 步骤内部的用户确认点保留不变
-3. 不修改 CLI 代码，纯 skill 文件实现
-
-## 设计
-
-### 新增文件：`.claude/skills/sillyspec-auto/SKILL.md`
-
-**核心逻辑：**
-
-1. 读 `$ARGUMENTS` 作为用户需求
-2. 阶段循环（brainstorm → plan → execute → verify）
-3. 每个阶段内步骤循环：
-   - `sillyspec run <stage> --input "需求"` → 读 step prompt
-   - 执行 prompt 中的操作
-   - 需要用户确认的步骤 → 暂停等回复
-   - 完成后自动 `sillyspec run <stage> --done --output "摘要"`
-   - 读下一步 prompt，继续
-4. 当前阶段全部完成 → 自动进入下一阶段
-5. verify 完成 → 输出总结，停止
-6. 命令失败 → 暂停，等用户介入
-
-**确认点保留规则：**
-- prompt 中有"请用户选择""等待用户回答""展示给用户"等字样 → 暂停
-- prompt 中有"自审""检查"等纯内部操作 → 自动完成
-
-### 同步到 npm 包
-
-init.js 已有逻辑复制 `sillyspec-*` skills 到项目 `.claude/skills/`，新 skill 自动生效。
-
-## 改动范围
-
-- 新增：`.claude/skills/sillyspec-auto/SKILL.md`（~60 行）
-
-## 不做的事
-
-- 不修改任何 JS 源码
-- 不改变现有阶段流程
-- 不自动 commit 或发布

package/.sillyspec/changes/auto-mode/proposal.md

@@ -1,19 +0,0 @@
-# auto mode — 提案
-
-author: qinyi
-created_at: 2026-04-08 07:29:00
-
-## 动机
-用户希望一次启动就自动完成 brainstorm → plan → execute → verify 全流程，不需要手动输入 `sillyspec run <stage>` 和 `--done`。
-
-## 变更范围
-新增 `.claude/skills/sillyspec-auto/SKILL.md`
-
-## 不在范围内
-- 不修改 JS 源码
-- 不改变阶段流程
-
-## 成功标准
-1. `/sillyspec:auto "需求"` 能自动推进全流程
-2. 步骤内部确认点正常暂停
-3. 异常时暂停等用户介入