sillyspec 3.7.29 → 3.7.31

package/.claude/skills/sillyspec-doctor/SKILL.md

@@ -8,10 +8,9 @@ description: 项目自检 — 检查 CLI、配置、构建环境和外部依赖
 **在执行任何检查之前，先确认 SillySpec CLI 是否可用：**
 
 1. 运行 `sillyspec --version`
-2. 如果失败，运行 `npx sillyspec --version`
-3. 如果都失败：
-   - 输出：❌ SillySpec CLI 未安装，后续检查无法执行
-   - 给出安装命令：`npm install -g sillyspec`（生产环境）或 `npx sillyspec`（临时使用）
+2. 如果失败：
+   - 输出：❌ SillySpec CLI 未安装
+   - 给出安装命令：`npm install -g sillyspec`
    - 停止，不要继续后续步骤
 
 ## 执行

package/.claude/skills/sillyspec-init/SKILL.md

@@ -148,7 +148,6 @@ ls -la
 ```bash
 git init
 git add .
-git commit -m "chore: sillyspec init - project initialized"
 ```
 
 ### 最后说：

package/fix-input.js

@@ -0,0 +1,15 @@
+const fs = require('fs');
+const p = 'src/run.js';
+let c = fs.readFileSync(p, 'utf8');
+
+const old = `- 输出：${outputText}\n\``;
+const rep = `${inputText ? `- 输入：${inputText}\n` : ''}- 输出：${outputText}\n\``;
+
+const count = c.split(old).length - 1;
+console.log(`Found ${count} occurrences`);
+
+if (count > 0) {
+  c = c.replaceAll(old, rep);
+  fs.writeFileSync(p, c);
+  console.log('Replaced');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.7.29",
+  "version": "3.7.31",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/src/progress.js

@@ -17,12 +17,11 @@ const PROGRESS_FILE = 'progress.json';
 const BACKUP_FILE = 'progress.json.bak';
 
 const CURRENT_VERSION = 2;
-const VALID_STAGES = ['brainstorm', 'propose', 'plan', 'execute', 'verify', 'scan', 'quick', 'archive', 'status', 'doctor'];
+const VALID_STAGES = ['brainstorm', 'plan', 'execute', 'verify', 'scan', 'quick', 'archive', 'status', 'doctor'];
 const VALID_STATUSES = ['pending', 'in-progress', 'completed', 'failed', 'blocked'];
 
 const STAGE_LABELS = {
   brainstorm: '🧠 需求探索',
-  propose: '📋 方案设计',
   plan: '📐 实现计划',
   execute: '⚡ 波次执行',
   verify: '🔍 验证确认',

package/src/run.js

@@ -106,11 +106,13 @@ function outputStep(stageName, stepIndex, steps, cwd) {
   console.log(`\n### ⚠️ 铁律`)
   console.log('- 只做本步骤描述的操作，不得自行扩展或跳过')
  console.log('- 不要回头修改已完成的步骤')
+  console.log('- 不要使用 npx 命令，直接使用 sillyspec（已全局安装）')
+  console.log('- 不要编造不存在的 CLI 子命令')
   console.log('- 完成后立即执行 --done 命令，不得跳过')
   console.log('- 生成的文件头部必须包含 author（git 用户名）和 created_at（精确到秒）')
   console.log('- 执行构建/测试前必须先读 local.yaml，优先使用其中配置的命令、路径和环境变量；未配置时才使用默认值')
   console.log(`\n### 完成后执行`)
-  console.log(`sillyspec run ${stageName} --done --output "你的摘要"`)
+  console.log(`sillyspec run ${stageName} --done --input "用户原始需求/反馈" --output "你的摘要"`)
 }
 
 /**
@@ -139,6 +141,13 @@ export async function runCommand(args, cwd) {
     outputText = flags[outputIdx + 1]
   }
 
+  // 解析 --input
+  let inputText = null
+  const inputIdx = flags.indexOf('--input')
+  if (inputIdx !== -1 && flags[inputIdx + 1]) {
+    inputText = flags[inputIdx + 1]
+  }
+
   // 解析 --change <name>
   let changeName = null
   const changeIdx = flags.indexOf('--change')
@@ -193,7 +202,7 @@ export async function runCommand(args, cwd) {
 
   // --done
   if (isDone) {
-    return await completeStep(pm, progress, stageName, cwd, outputText)
+    return await completeStep(pm, progress, stageName, cwd, outputText, inputText)
   }
 
   // 默认：输出当前步骤
@@ -267,7 +276,7 @@ function validateMetadata(cwd, stageName) {
   }
 }
 
-async function completeStep(pm, progress, stageName, cwd, outputText) {
+async function completeStep(pm, progress, stageName, cwd, outputText, inputText = null) {
   const stageData = progress.stages[stageName]
   if (!stageData || !stageData.steps) {
     console.error(`❌ 阶段 ${stageName} 未初始化`)
@@ -323,7 +332,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText) {
     // Append to user-inputs.md
     if (outputText) {
       const inputsPath = join(cwd, '.sillyspec', '.runtime', 'user-inputs.md')
-      const entry = `\n## ${new Date().toLocaleString('zh-CN',{hour12:false})} | ${stageName}: ${steps[currentIdx].name}\n- 输出：${outputText}\n`
+      const entry = `\n## ${new Date().toLocaleString('zh-CN',{hour12:false})} | ${stageName}: ${steps[currentIdx].name}\n${inputText ? "- 输入：" + inputText + "\n" : ""}- 输出：${outputText}\n`
       appendFileSync(inputsPath, entry)
     }
 
@@ -345,7 +354,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText) {
   // Append to user-inputs.md
   if (outputText) {
     const inputsPath = join(cwd, '.sillyspec', '.runtime', 'user-inputs.md')
-    const entry = `\n## ${new Date().toLocaleString('zh-CN',{hour12:false})} | ${stageName}: ${steps[currentIdx].name}\n- 输出：${outputText}\n`
+    const entry = `\n## ${new Date().toLocaleString('zh-CN',{hour12:false})} | ${stageName}: ${steps[currentIdx].name}\n${inputText ? "- 输入：" + inputText + "\n" : ""}- 输出：${outputText}\n`
     appendFileSync(inputsPath, entry)
   }
 

package/src/stages/archive.js

@@ -35,7 +35,7 @@ export const definition = {
     },
     {
       name: '更新路线图和提交',
-      prompt: `更新路线图并 Git 提交。
+      prompt: `更新路线图并暂存变更。
 
 ### 操作
 1. 如果 \`.sillyspec/ROADMAP.md\` 存在，标记对应 Phase 为已完成

package/src/stages/brainstorm.js

@@ -164,8 +164,9 @@ export const definition = {
       prompt: `撰写 design 文档并进行 AI 自审。
 
 ### 操作
-1. 将确认的设计写入 \`.sillyspec/changes/<变更名>/design.md\`
-2. 自审检查：
+1. 确认变更目录存在：\`mkdir -p .sillyspec/changes/<变更名>\`（Windows 用 \`mkdir .sillyspec\\changes\\<变更名>\` 或 PowerShell \`New-Item -ItemType Directory -Force -Path .sillyspec/changes/<变更名>\`）
+2. 将确认的设计写入 \`.sillyspec/changes/<变更名>/design.md\`
+3. 自审检查：
    - 需求覆盖：是否完整覆盖 Step 6 确认的需求
    - 约束一致性：是否与 CONVENTIONS.md、ARCHITECTURE.md 一致
    - 真实性：表名/字段名来自真实 schema 或标注"新增"
@@ -184,25 +185,30 @@ design.md 文件路径 + 自审结果
       optional: false
     },
     {
-      name: '用户确认并输出技术方案',
-      prompt: `用户确认设计方案，生成最终技术方案。
+      name: '用户确认并生成规范文件',
+      prompt: `用户确认设计方案，生成规范文件。
 
 ### 操作
 1. 展示 design.md 摘要给用户
 2. 请用户选择：✅ 确认 / ✏️ 修改 / ❌ 推翻重来
-3. 确认后：
-   - 将技术方案写入 \`.sillyspec/changes/<变更名>/design.md\`
-   - 包含：架构决策、文件变更清单、数据模型、API 设计、代码风格参照
-   - Git 提交
+3. 确认后，在 \`.sillyspec/changes/<变更名>/\` 下生成所有规范文件：
+   - **design.md**：架构决策、文件变更清单、数据模型、API 设计、代码风格参照
+   - **proposal.md**：动机、变更范围、不在范围内、成功标准
+   - **requirements.md**：功能需求、用户场景（Given/When/Then 格式）、非功能需求
+   - **tasks.md**：任务列表（只列名称和对应文件路径，细节在 plan 阶段展开）
+   - \`git add .sillyspec/\` — **不要 commit**
 
 ### 输出
-最终 design.md 路径 + Git commit hash
+所有规范文件路径
 
 ### 注意
 - 必须等待用户明确确认
 - 禁止在确认前推进到后续阶段
-- 推翻重来回到 Step 6`,
-      outputHint: '最终 design.md 路径 + commit hash',
+- 禁止自动 commit
+- 推翻重来回到 Step 6
+- 表名/字段名必须来自真实 schema 或标注"新增"
+- tasks.md 只列任务名，细节在 plan 阶段展开`,
+      outputHint: '规范文件路径',
       optional: false
     }
   ]

package/src/stages/doctor.js

@@ -281,7 +281,7 @@ timeout 5 which docker 2>/dev/null && echo "✅ Docker 可用" || echo "ℹ️ D
 根据问题类型给出具体可操作的修复命令：
 
 **常见问题及修复：**
-- CLI 未安装 → \`npm install -g sillyspec\` 或 \`npx sillyspec\`
+- CLI 未安装 → \`npm install -g sillyspec\`
 - 缺少 local.yaml → \`sillyspec init\` 重新生成，或手动创建
 - local.yaml 缺少 build/test → 补充对应命令
 - 缺少 STACK.md → \`sillyspec run scan\` 重新扫描

package/src/stages/execute.js

@@ -93,7 +93,7 @@ const fixedSuffix = [
    - 验证 → sillyspec run verify
    - 归档 → /sillyspec:archive
    - 继续开发
-2. 提示 git 提交
+2. 提示 git add 暂存变更
 
 ### 输出
 用户选择 + 下一步命令
@@ -112,23 +112,51 @@ function parseWavesFromPlan(planContent) {
   const waves = []
   const lines = planContent.split('\n')
   let currentWave = null
+  let currentTask = null
 
   for (const line of lines) {
     const waveMatch = line.match(/^#+\s*Wave\s+(\d+)/i)
     if (waveMatch) {
       currentWave = { index: parseInt(waveMatch[1]), tasks: [] }
+      currentTask = null
       waves.push(currentWave)
       continue
     }
 
-    if (currentWave) {
-      const taskMatch = line.match(/^[-*]\s*\[[ x]\]\s*(.+)/)
-      if (taskMatch) {
-        const fileMatch = taskMatch[1].match(/\(([^)]+)\)/)
-        currentWave.tasks.push({
-          name: taskMatch[1].replace(/\([^)]+\)/, '').trim(),
-          file: fileMatch ? fileMatch[1] : '未知'
-        })
+    if (!currentWave) continue
+
+    const taskMatch = line.match(/^[-*]\s*\[[ x]\]\s*(.+)/)
+    if (taskMatch) {
+      currentTask = {
+        name: taskMatch[1].trim(),
+        file: '',
+        steps: '',
+        reference: ''
+      }
+      // 兼容旧格式：任务名后跟 (文件路径)
+      const fileMatch = taskMatch[1].match(/\(([^)]+)\)$/)
+      if (fileMatch) {
+        currentTask.file = fileMatch[1]
+        currentTask.name = taskMatch[1].replace(/\([^)]+\)$/, '').trim()
+      }
+      currentWave.tasks.push(currentTask)
+      continue
+    }
+
+    // 解析子行信息（修改/参考/步骤）
+    if (currentTask) {
+      const modMatch = line.match(/^\s+-\s*修改:\s*(.+)/)
+      if (modMatch) { currentTask.file = modMatch[1].trim(); continue }
+
+      const refMatch = line.match(/^\s+-\s*参考:\s*(.+)/)
+      if (refMatch) { currentTask.reference = refMatch[1].trim(); continue }
+
+      const stepMatch = line.match(/^\s+-\s*步骤:/)
+      if (stepMatch) { currentTask.steps = line.replace(/^\s+-\s*步骤:\s*/, '').trim(); continue }
+
+      // 步骤续行（数字开头的子步骤）
+      if (currentTask.steps && line.match(/^\s+\d+\./)) {
+        currentTask.steps += '\n' + line.trim()
       }
     }
   }
@@ -140,7 +168,13 @@ function parseWavesFromPlan(planContent) {
  * 为 Wave 生成 prompt
  */
 function buildWavePrompt(wave, waveIndex) {
-  const taskList = wave.tasks.map(t => `- [ ] ${t.name} (${t.file})`).join('\n')
+  const taskList = wave.tasks.map(t => {
+    let s = `- [ ] ${t.name}`
+    if (t.file) s += ` (${t.file})`
+    if (t.reference) s += `\n  参考: ${t.reference}`
+    if (t.steps) s += `\n  步骤: ${t.steps}`
+    return s
+  }).join('\n')
   return `## Wave ${waveIndex}: 执行以下任务
 
 ### 本 Wave 任务
@@ -149,15 +183,18 @@ ${taskList}
 ### 执行要求
 1. 按任务顺序执行，同一 Wave 内任务可并行
 2. 铁律：先读后写、grep 确认方法存在、不编造、TDD
-3. 读取 \`.sillyspec/local.yaml\` 获取构建和测试命令
-4. 编译/测试仅限变更涉及的模块（使用 \`-pl\`、\`--filter\` 或指定路径）
-3. 每个任务完成后：
+3. **不要频繁编译！** 编译很慢，只在以下情况运行：
+   - 写了大量代码后需要验证语法正确性
+   - 最后一个 Wave 完成后做一次全量编译验证
+   - 用户明确要求编译时
+4. 单个任务完成后只跑**对应模块的单元测试**（TDD 绿灯确认），不要跑全量编译
+5. 每个任务完成后：
    - 勾选 tasks.md 中对应 checkbox
    - 记录改动文件和测试结果
-4. 遇到 BLOCKED → 记录原因，选择：重试/跳过/停止
+6. 遇到 BLOCKED → 记录原因，选择：重试/跳过/停止
 
 ### 完成后
-运行 sillyspec run execute --done --output "Wave ${waveIndex} 结果摘要"`
+运行 sillyspec run execute --done --input "用户原始反馈" --output "Wave ${waveIndex} 结果摘要"`
 }
 
 /**

package/src/stages/index.js

@@ -23,7 +23,7 @@ export const stageRegistry = {
 }
 
 // 流程阶段顺序，用于 getNextStage
-const stageOrder = ['brainstorm', 'propose', 'plan', 'execute', 'verify']
+const stageOrder = ['brainstorm', 'plan', 'execute', 'verify']
 
 export function getNextStage(currentStage) {
   const index = stageOrder.indexOf(currentStage)

package/src/stages/plan.js

@@ -1,7 +1,7 @@
 export const definition = {
   name: 'plan',
   title: '实现计划',
-  description: '编写实现计划 — 2-5 分钟粒度，精确到文件路径和代码',
+  description: '编写实现计划 — 按 Wave 分组，TDD 步骤，精确到文件路径',
   steps: [
     {
       name: '状态检查',
@@ -22,8 +22,9 @@ export const definition = {
 
 ### 操作
 1. 读取 CODEBASE-OVERVIEW.md + 各子项目上下文
-2. 读取 proposal.md、design.md、tasks.md、requirements.md
+2. 读取 proposal.md、design.md、requirements.md
 3. 读取 CONVENTIONS.md、ARCHITECTURE.md、STACK.md
+4. 读取 local.yaml 获取构建/测试命令
 
 ### 输出
 已加载的文件清单`,
@@ -43,46 +44,84 @@ export const definition = {
       optional: false
     },
     {
-      name: '逐任务展开',
-      prompt: `把 tasks.md 中每个 checkbox 展开为详细步骤。
+      name: '展开任务并分组',
+      prompt: `把 tasks.md 每个 checkbox 展开为任务描述，按 Wave 分组组织。
 
-### 操作
-对每个 Task：
-1. 标注精确文件路径（新建/修改/测试）
-2. 每个步骤 2-5 分钟可完成
-3. 包含完整可运行的代码示例
-4. 包含验证命令和预期输出
-5. 频繁 commit，每个任务独立提交
-6. 引用已有代码的方法签名（从 CONVENTIONS.md 或源码获取）
+### 输出格式要求（必须严格遵守）
 
-### 输出
-展开后的详细计划
-
-### 注意
-- 假设执行者是熟练开发者但对你项目零上下文
-- 不要写"添加验证逻辑"这种模糊描述
-- 要写"在 UserController.java 添加方法：public Result<UserVO> createUser(...)"
-- 调用已有方法前必须 grep 确认存在`,
-      outputHint: '详细计划',
-      optional: false
-    },
-    {
-      name: '标注执行顺序',
-      prompt: `按依赖关系分组，标注执行顺序。
+每个 Task 必须保留 \`- [ ]\` checkbox，这是 execute 阶段勾选完成状态的依据。禁止写成纯文本列表。
 
-### 操作
+每个 Task 必须包含「步骤」字段，列出 TDD 执行顺序：
+1. 写测试 → 2. 运行确认失败 → 3. 写代码 → 4. 运行确认通过
+
+纯配置/数据/文档类任务可跳过 TDD，步骤简化为：1. 实现 → 2. 验证
+
+注意：不需要写精确方法签名和代码示例。方法签名和代码风格由 execute 阶段先读后写确认。plan 专注"做什么"和"执行顺序"。
+
+### 示例
+
+\`\`\`markdown
+### Wave 1（并行，无依赖）
+
+- [ ] 添加用户创建接口
+  - 修改: \`UserController.java\`、\`UserService.java\`
+  - 参考: \`RoleController.createRole\`
+  - 步骤:
+    1. 写测试 UserControllerTest.testCreateUser
+    2. 运行 <test-cmd> 确认失败
+    3. 写 UserController.createUser
+    4. 运行 <test-cmd> 确认通过
+
+- [ ] 添加角色创建接口
+  - 修改: \`RoleController.java\`
+  - 步骤:
+    1. 写测试 RoleControllerTest.testCreateRole
+    2. 运行 <test-cmd> 确认失败
+    3. 写 RoleController.createRole
+    4. 运行 <test-cmd> 确认通过
+
+### Wave 2（依赖 Wave 1）
+
+- [ ] 用户创建接口联调
+  - 修改: \`UserController.java\`
+  - 依赖: Wave 1 的用户创建接口 + 角色创建接口
+  - 步骤:
+    1. 写集成测试 UserControllerTest.testCreateUserIntegration
+    2. 运行 <test-cmd> 确认失败
+    3. 补充联调逻辑
+    4. 运行 <test-cmd> 确认通过
+
+### Wave 3（纯配置）
+
+- [ ] 配置用户创建接口路由
+  - 修改: \`application.yml\`
+  - 步骤:
+    1. 实现路由配置
+    2. 验证: 运行 <test-cmd> 确认通过
+\`\`\`
+
+### 每个 Task 必须包含
+- 精确文件路径（修改哪个文件）
+- 任务描述（做什么，一两句话说清楚）
+- 涉及已有类调用时，标注参考文件（如"参考 \`RoleController.createRole\`"）
+- 依赖关系（无依赖可省略）
+
+### 分组规则
 1. 分析 Task 间依赖
 2. 无依赖的 Task 归入同一 Wave（可并行）
 3. 有依赖的 Task 按顺序排列
+4. Wave 编号从 1 开始
 
-### 输出
-Wave 分组列表 + 依赖说明
+### 操作
+1. 读取 tasks.md 获取任务列表
+2. 读取 design.md 获取文件变更清单
+3. 逐个展开为详细任务描述
+4. 分析依赖关系，按 Wave 分组
+5. 每个任务独立 \`git add\` 暂存，不 commit
 
-### 示例
-Wave 1（并行）：Task 1 + Task 2
-Wave 2（依赖 Wave 1）：Task 3
-Wave 3（依赖 Wave 2）：Task 4`,
-      outputHint: 'Wave 分组和依赖关系',
+### 输出
+按 Wave 分组的完整计划`,
+      outputHint: 'Wave 分组计划',
       optional: false
     },
     {
@@ -91,10 +130,13 @@ Wave 3（依赖 Wave 2）：Task 4`,
 
 ### 操作
 检查以下各项：
-- [ ] 每个 task 有具体文件路径
-- [ ] 每个 task 有验证命令和预期输出
-- [ ] 已标注 Wave 和执行顺序
+- [ ] 每个 task 有 \`- [ ]\` checkbox
+- [ ] 每个 task 有精确文件路径
+- [ ] 代码类 task 有 TDD 步骤（写测试→确认失败→写代码→确认通过）
+- [ ] 配置/文档类 task 步骤简化为（实现→验证）
+- [ ] 已标注 Wave 分组和依赖关系
 - [ ] plan 与 design.md 的文件变更清单一致
+- [ ] 没有写精确方法签名和代码示例
 
 ### 输出
 自检通过/不通过`,
@@ -106,7 +148,9 @@ Wave 3（依赖 Wave 2）：Task 4`,
       prompt: `保存计划文件，更新进度。
 
 ### 操作
-1. 保存到 \`.sillyspec/changes/<变更名>/plan.md\`
+1. 确认变更目录存在：\`mkdir -p .sillyspec/changes/<变更名>\`
+2. 保存到 \`.sillyspec/changes/<变更名>/plan.md\`
+3. \`git add .sillyspec/\` — **不要 commit**
 
 ### 输出
 计划文件路径 + 下一步命令`,

package/src/stages/scan.js

@@ -130,11 +130,11 @@ TESTING.md、CONCERNS.md、PROJECT.md 路径`,
 4. \`git add .\` — **不要 commit**，由用户通过统一提交工具处理
 
 ### 输出
-扫描完整性报告 + commit hash
+扫描完整性报告
 
 ### 注意
 - ❌ 修改代码 / 编造路径 / 读源码全文`,
-      outputHint: '自检报告 + commit hash',
+      outputHint: '自检报告',
       optional: false
     }
   ]