sillyspec 3.8.5 → 3.8.6

package/src/stages/execute.js

@@ -1,259 +0,0 @@
-import { existsSync, readFileSync } from 'fs'
-import path from 'path'
-
-export const definition = {
-  name: 'execute',
-  title: '波次执行',
-  description: '子代理并行 + 强制 TDD + 两阶段审查',
-  steps: [] // 动态构建，由 buildExecuteSteps() 生成
-}
-
-// 固定前缀步骤定义
-const fixedPrefix = [
-  {
-    name: '状态检查',
-    prompt: `检查当前状态，确认可以执行 execute。
-
-### 操作
-1. 运行 \`sillyspec progress show\`
-2. 确认 currentStage 为 execute
-3. 如果不是 → 检查是否有未完成的 tasks.md
-4. 确认执行范围（$ARGUMENTS 指定 wave/task 或全部）
-
-### 输出
-当前状态 + 执行范围确认`,
-    outputHint: '当前状态 + 执行范围',
-    optional: false
-  },
-  {
-    name: '加载上下文',
-    prompt: `加载计划、设计和代码库上下文。
-
-### 操作
-1. 读取 tasks.md（执行计划）
-2. 读取 design.md（技术方案）
-3. 读取 CONVENTIONS.md、ARCHITECTURE.md
-4. 读取 local.yaml（构建命令）
-5. 加载 CODEBASE-OVERVIEW.md
-
-### 输出
-已加载的上下文摘要`,
-    outputHint: '上下文摘要',
-    optional: false
-  },
-  {
-    name: '确认执行范围',
-    prompt: `解析任务，确认执行范围和确认模式。
-
-### 操作
-1. 从 plan 中解析 Wave 分组和任务列表
-2. 根据任务描述关键词为每个 Task 建议模型：
-   - 架构/复杂推理 → 最强模型
-   - 常规实现 → 中等模型
-   - 简单修改 → 快速模型
-   - 文档/写作 → 写作模型
-3. 用户在 tasks.md 中的 [model:xxx] 标签优先
-4. 询问用户执行确认频率：
-   - 每个 Wave 确认 — 每个 Wave 完成后展示结果
-   - AI 自主判断 — BLOCKED 或计划外变更时才询问
-   - 全自动 — 全部自动执行
-5. 查询知识库：读取 \`.sillyspec/knowledge/INDEX.md\`，根据 Task 关键词匹配
-
-### 输出
-Wave 分组 + 模型分配 + 确认模式 + 知识库匹配结果
-
-### 注意
-- 默认推荐"每个 Wave 确认"`,
-    outputHint: 'Wave 分组 + 模型分配',
-    optional: false
-  }
-]
-
-// 固定后缀步骤定义
-const fixedSuffix = [
-  {
-    name: '知识库审阅',
-    prompt: `检查本轮执行产生的新知识。
-
-### 操作
-1. 检查 \`.sillyspec/knowledge/uncategorized.md\` 中待确认条目
-2. 如有 → 提示用户审阅
-3. 用户确认后改为 [已确认]，可归类到专题文件
-
-### 输出
-新知识条目数量 + 审阅提示（或"无新知识"）`,
-    outputHint: '知识条目数量',
-    optional: true
-  },
-  {
-    name: '完成确认',
-    prompt: `所有任务完成后的收尾。
-
-### 操作
-1. 询问用户下一步：
-   - 验证 → sillyspec run verify
-   - 归档 → /sillyspec:archive
-   - 继续开发
-2. 提示 git add 暂存变更
-
-### 输出
-用户选择 + 下一步命令
-
-### 注意
-- 完成后运行 \`sillyspec run execute --done\` 即可自动推进阶段`,
-    outputHint: '用户选择',
-    optional: false
-  }
-]
-
-/**
- * 从 plan 文件解析 Wave 分组
- */
-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) 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()
-      }
-    }
-  }
-
-  return waves
-}
-
-/**
- * 为 Wave 生成 prompt
- */
-function buildWavePrompt(wave, waveIndex, changeDir) {
-  const taskList = wave.tasks.map((t, ti) => {
-    const taskNum = String(t.index || (ti + 1)).padStart(2, '0')
-    const taskFile = changeDir ? `${changeDir}/tasks/task-${taskNum}.md` : ''
-    const taskFileExists = taskFile && existsSync(taskFile)
-    let s = `- [ ] ${t.name}`
-    if (t.file) s += ` (${t.file})`
-    if (taskFileExists) {
-      const taskContent = readFileSync(taskFile, 'utf8').trim()
-      s += `
-\n### 📋 任务蓝图（task-${taskNum}.md）\n${taskContent}`
-    }
-    if (t.reference) s += `\n  参考: ${t.reference}`
-    if (t.steps) s += `\n  步骤: ${t.steps}`
-    return s
-  }).join('\n')
-  const { join } = path
-const hasTaskBlueprints = changeDir && existsSync(join(changeDir, 'tasks'))
-  const taskBlueprintRule = hasTaskBlueprints
-    ? '每个任务有独立的 task-N.md 蓝图——只做蓝图里写的事，不要实现蓝图之外的功能。如果蓝图有问题，**停下来反馈**，不要自己改。问题归因：实现困难 → task 蓝图没写好 → plan 没做好 → design 有缺陷。'
-    : '如果发现 plan 不合理，**停下来反馈**，不要自己改方案。问题归因：实现困难 → plan 没做好 → design 有缺陷。'
-  return `## Wave ${waveIndex}: 执行以下任务
-
-### Wave 开始前
-1. 读取 design.md 的「编码铁律」章节（如果存在），严格遵守
-2. 读取 plan.md 了解全局任务划分和依赖关系
-2. 确认本 Wave 的输入/输出契约（前置 Wave 产出了什么，本 Wave 需要消费什么）
-3. 检查前置 Wave 的产出是否完整（文件是否存在、测试是否通过）
-4. **上下文分层加载**：
-   - 🔥 热上下文：design.md 编码铁律 + 当前 Wave 任务（必须加载）
-   - 🌡️ 温上下文：CONVENTIONS.md + ARCHITECTURE.md（需要时加载）
-   - ❄️ 冷上下文：其他变更的 design.md、历史 plan.md（不要主动加载，除非明确需要）
-
-### 本 Wave 任务
-${taskList}
-
-### 执行要求
-1. 按任务顺序执行，同一 Wave 内任务可并行
-2. 铁律：先读后写、grep 确认方法存在、不编造、TDD
-3. **禁止发散思维**：你是代码搬运工，严格按任务描述执行，不增不减不改。${taskBlueprintRule}
-4. **Reverse Sync**：发现 Bug 或实现与 design.md/task-N.md 不一致时，先检查是代码错了还是文档有遗漏，有遗漏则先修文档再修代码。
-3. **不要频繁编译！** 编译很慢，只在以下情况运行：
-   - 写了大量代码后需要验证语法正确性
-   - 最后一个 Wave 完成后做一次全量编译验证
-   - 用户明确要求编译时
-4. 单个任务完成后只跑**对应模块的单元测试**（TDD 绿灯确认），不要跑全量编译
-5. 每个任务完成后：
-   - 勾选 task-N.md 中的验收标准 checkbox
-   - 勾选 plan.md / tasks.md 中对应任务的 checkbox
-   - 记录改动文件和测试结果
-6. 遇到 BLOCKED → 记录原因，选择：重试/跳过/停止
-
-### 完成后
-运行 sillyspec run execute --done --input "用户原始反馈" --output "Wave ${waveIndex} 结果摘要"`
-}
-
-/**
- * 动态构建 execute 步骤列表
- * @param {string|null} planFilePath - plan 文件路径，null 则用默认 3 Wave
- * @returns {Array} 步骤列表
- */
-export function buildExecuteSteps(planFilePath = null) {
-  let waves
-  let changeDir = null
-
-  if (planFilePath && existsSync(planFilePath)) {
-    const planContent = readFileSync(planFilePath, 'utf8')
-    waves = parseWavesFromPlan(planContent)
-    // 从 planFilePath 推导 changeDir: .sillyspec/changes/<name>/plan.md
-    changeDir = path.dirname(planFilePath)
-  }
-
-  // 如果没解析出 Wave，生成默认 3 个
-  if (!waves || waves.length === 0) {
-    waves = []
-    for (let i = 1; i <= 3; i++) {
-      waves.push({ index: i, tasks: [{ name: `默认任务 ${i}`, file: 'TBD' }] })
-    }
-  }
-
-  const waveSteps = waves.map((wave, i) => ({
-    name: `Wave ${i + 1} 执行`,
-    prompt: buildWavePrompt(wave, i + 1, changeDir),
-    outputHint: `Wave ${i + 1} 执行结果`,
-    optional: false
-  }))
-
-  return [...fixedPrefix, ...waveSteps, ...fixedSuffix]
-}

package/src/stages/index.js

@@ -1,35 +0,0 @@
-import { definition as brainstorm } from './brainstorm.js'
-import { definition as propose } from './propose.js'
-import { definition as plan } from './plan.js'
-import { definition as execute } from './execute.js'
-import { definition as verify } from './verify.js'
-import { definition as scan } from './scan.js'
-import { definition as quick } from './quick.js'
-import { definition as archive } from './archive.js'
-import { definition as status } from './status.js'
-import { definition as doctor } from './doctor.js'
-
-export const stageRegistry = {
-  brainstorm,
-  propose,
-  plan,
-  execute,
-  verify,
-  scan,
-  quick,
-  archive,
-  status,
-  doctor
-}
-
-// 流程阶段顺序，用于 getNextStage
-const stageOrder = ['brainstorm', 'plan', 'execute', 'verify']
-
-export function getNextStage(currentStage) {
-  const index = stageOrder.indexOf(currentStage)
-  if (index === -1 || index >= stageOrder.length - 1) return null
-  return stageOrder[index + 1]
-}
-
-// 辅助命令（不影响流程阶段推进）
-export const auxiliaryStages = ['scan', 'quick', 'archive', 'status', 'doctor']

package/src/stages/plan.js

@@ -1,259 +0,0 @@
-import { existsSync, readFileSync } from 'fs'
-import path from 'path'
-
-export const definition = {
-  name: 'plan',
-  title: '实现计划',
-  description: '编写实现计划 — 按 Wave 分组，每个任务独立文档',
-  steps: null // 动态生成
-}
-
-// 固定前缀步骤
-const fixedPrefix = [
-  {
-    name: '状态检查',
-    prompt: `检查当前状态，确认可以执行 plan。
-
-### 操作
-1. 运行 \`sillyspec progress show\`
-2. 确认 currentStage 为 "plan"
-
-### 输出
-当前状态摘要`,
-    outputHint: '状态摘要',
-    optional: false
-  },
-  {
-    name: '加载上下文',
-    prompt: `加载所有规范文件和代码库上下文。
-
-### 操作
-1. 读取 CODEBASE-OVERVIEW.md + 各子项目上下文
-2. 读取 proposal.md、design.md、requirements.md、tasks.md
-3. 读取 CONVENTIONS.md、ARCHITECTURE.md、STACK.md
-4. 读取 local.yaml 获取构建/测试命令
-
-### 输出
-已加载的文件清单`,
-    outputHint: '文件清单',
-    optional: false
-  },
-  {
-    name: '锚定确认',
-    prompt: `确认已读取的文件。
-
-### 操作
-列出已读取的文件，标注存在/不存在。
-
-### 输出
-文件加载确认清单`,
-    outputHint: '文件确认清单',
-    optional: false
-  },
-  {
-    name: '展开任务并分组',
-    prompt: `把 tasks.md 每个 checkbox 展开为任务描述，按 Wave 分组，产出 plan.md 总览。
-
-### plan.md 格式（轻量总览，PM 视角）
-\`\`\`markdown
-# 实现计划
-
-## Wave 1（并行，无依赖）
-- [ ] task-01: 添加用户创建接口
-- [ ] task-02: 添加角色创建接口
-
-## Wave 2（依赖 Wave 1）
-- [ ] task-03: 用户创建接口联调
-
-## 全局验收标准
-- [ ] 所有单元测试通过
-\`\`\`
-
-### 关键规则
-- plan.md 只放任务列表 + Wave 划分 + 全局验收标准，**不放实现细节**
-- 实现细节写到后续的 tasks/task-NN.md 中
-- 每个任务编号格式：task-01、task-02 ...
-
-### 批量模式指引
-如果 design.md 或需求中包含批量特征（关键词：批量/模板/引擎/N个相似），按以下原则规划：
-❌ 不要列出每个实例作为独立任务
-❌ 不要在文档中嵌入数据
-✅ 设计通用架构，Wave 1 聚焦架构
-✅ 数据转换用脚本完成，单独一个 Wave
-✅ 总任务数控制在 10 个以内
-
-### 操作
-1. 读取 tasks.md 获取任务列表
-2. 读取 design.md 获取文件变更清单
-3. 逐个展开为任务描述
-4. 分析依赖关系，按 Wave 分组
-5. 保存到 \`.sillyspec/changes/<变更名>/plan.md\`
-
-### 输出
-plan.md 总览内容`,
-    outputHint: 'plan.md 总览',
-    optional: false
-  },
-  {
-    name: '自检总览',
-    prompt: `自检 plan.md 总览质量。
-
-### 操作
-检查以下各项：
-- [ ] 每个 task 有编号（task-01、task-02 ...）
-- [ ] 每个 task 有 checkbox
-- [ ] 已标注 Wave 分组和依赖关系
-- [ ] 有全局验收标准
-- [ ] 没有实现细节（接口定义、代码示例等不应该在 plan.md 里）
-- [ ] plan.md 与 design.md 的文件变更清单一致
-
-### 输出
-自检通过/不通过`,
-    outputHint: '自检结果',
-    optional: false
-  }
-]
-
-// 固定后缀步骤
-const fixedSuffix = [
-  {
-    name: '审查一致性',
-    prompt: `审查所有 task-N.md 的一致性。
-
-### 操作
-1. 读取所有 tasks/task-NN.md
-2. 检查：
-   - 文件路径有没有冲突（两个任务改同一个文件）
-   - 依赖关系和 plan.md 的 Wave 分组是否一致
-   - 验收标准和 plan.md 的全局标准是否矛盾
-   - 接口定义是否自洽
-3. 发现问题 → 列出问题清单，暂停等用户决定是否修复
-
-### 输出
-一致性审查结果`,
-    outputHint: '审查结果',
-    optional: false
-  },
-  {
-    name: '保存并更新进度',
-    prompt: `确认所有文件已保存，更新进度。
-
-### 操作
-1. 确认 plan.md 和所有 tasks/task-NN.md 已存在
-2. \`git add .sillyspec/\` — **不要 commit**
-
-### 输出
-文件列表 + 下一步命令`,
-    outputHint: '文件列表',
-    optional: false
-  }
-]
-
-/**
- * 解析 plan.md 获取任务数量
- */
-function parseTaskCount(planContent) {
-  const matches = planContent.match(/^[-*]\s*\[[ x]\]\s*task-\d+/gm)
-  return matches ? matches.length : 0
-}
-
-/**
- * 生成单个任务的蓝图写作 prompt
- */
-function buildTaskPrompt(taskNum, taskName, changeDir) {
-  return `编写任务蓝图 tasks/task-${String(taskNum).padStart(2, '0')}.md
-
-### 任务
-${taskName}
-
-### 文件路径
-\`.sillyspec/changes/<变更名>/tasks/task-${String(taskNum).padStart(2, '0')}.md\`
-
-### 格式要求（必须严格遵守）
-\`\`\`markdown
-# task-${String(taskNum).padStart(2, '0')}: ${taskName}
-
-## 修改文件
-- 具体文件路径列表
-
-## 实现要求
-1. 具体做什么，写清楚
-2. ...
-
-## 接口定义
-（代码类任务必填，写方法签名、数据结构）
-
-## 边界处理
-- 异常场景列表
-
-## 参考
-- 已有代码可参考的模式
-- 相关的 CONVENTIONS.md 条目
-
-## TDD 步骤
-1. 写测试 ...
-2. 运行 <test-cmd> 确认失败
-3. 写代码 ...
-4. 运行 <test-cmd> 确认通过
-（纯配置/文档类任务简化为：1. 实现 2. 验证）
-
-## 验收标准
-- [ ] 具体可测试的验收条件
-\`\`\`
-
-### 关键规则
-- task-N.md 必须独立完整，execute 子代理只读这一个文件就能干活
-- 不要依赖其他 task-N.md 的内容
-- 接口定义写到"搬砖工照着做"的程度
-- 写完后保存到文件
-
-### 操作
-1. 读取 design.md 和 plan.md 了解上下文
-2. 读取相关源文件了解现有代码
-3. 编写任务蓝图
-4. 保存到 tasks/task-${String(taskNum).padStart(2, '0')}.md
-
-### 输出
-任务蓝图内容摘要`
-}
-
-/**
- * 动态构建 plan 步骤列表
- * @param {string|null} changeDir - 变更目录路径
- * @param {string|null} planContent - plan.md 内容（可选，用于解析任务数）
- * @returns {Array} 步骤列表
- */
-export function buildPlanSteps(changeDir = null, planContent = null) {
-  let taskCount = 0
-
-  // 尝试从 plan.md 解析任务数
-  if (planContent) {
-    taskCount = parseTaskCount(planContent)
-  } else if (changeDir) {
-    const planFile = path.join(changeDir, 'plan.md')
-    if (existsSync(planFile)) {
-      taskCount = parseTaskCount(readFileSync(planFile, 'utf8'))
-    }
-  }
-
-  // 没有任务数则用固定步骤（兼容旧流程）
-  if (taskCount === 0) {
-    return [...fixedPrefix, ...fixedSuffix]
-  }
-
-  // 动态生成每个任务的蓝图写作步骤
-  const taskSteps = []
-  for (let i = 1; i <= taskCount; i++) {
-    taskSteps.push({
-      name: `写任务蓝图 task-${String(i).padStart(2, '0')}`,
-      prompt: `### 注意
-这是第 ${i}/${taskCount} 个任务蓝图。focus 在这一个任务上，不要写其他任务的内容。
-
-${buildTaskPrompt(i, '（从 plan.md 读取任务名）', changeDir)}`,
-      outputHint: `task-${String(i).padStart(2, '0')} 蓝图`,
-      optional: false
-    })
-  }
-
-  return [...fixedPrefix, ...taskSteps, ...fixedSuffix]
-}

package/src/stages/propose.js

@@ -1,115 +0,0 @@
-export const definition = {
-  name: 'propose',
-  title: '方案设计',
-  description: '生成结构化规范 — proposal + design + tasks',
-  steps: [
-    {
-      name: '状态检查',
-      prompt: `检查当前状态，确认可以执行 propose。
-
-### 操作
-1. 运行 \`sillyspec progress show\`
-2. 确认 currentStage 为 "propose"
-3. 如果没有设计文档 → 提示先运行 brainstorm
-
-### 输出
-当前状态摘要`,
-      outputHint: '状态摘要',
-      optional: false
-    },
-    {
-      name: '加载上下文',
-      prompt: `加载所有相关规范和代码库上下文。
-
-### 操作
-1. 加载 CODEBASE-OVERVIEW.md 和子项目上下文
-2. 读取最新设计文档、需求文档、代码库约定
-3. 如果是子阶段变更，读取 MASTER.md 和前序阶段设计
-
-### 输出
-已加载的文件列表`,
-      outputHint: '文件列表',
-      optional: false
-    },
-    {
-      name: '锚定确认',
-      prompt: `确认已读取的文件。
-
-### 操作
-1. 列出已读取的文件，标注存在/不存在
-2. 格式：\`[x] 文件名 — 说明\` 或 \`[ ] 文件名 — 不存在（正常）\`
-
-### 输出
-文件加载确认清单
-
-### 注意
-- 文件不存在不是错误，正常标注即可`,
-      outputHint: '文件确认清单',
-      optional: false
-    },
-    {
-      name: '探索现有代码',
-      prompt: `理解相关模块的当前实现，识别影响范围。
-
-### 操作
-1. 根据设计文档中的文件变更清单，读取相关源码
-2. 识别现有接口、方法签名、数据结构
-3. 记录可能受影响的模块
-
-### 输出
-影响范围分析（涉及模块、需修改的文件、风险点）`,
-      outputHint: '影响范围分析',
-      optional: false
-    },
-    {
-      name: '生成规范文件',
-      prompt: `在 \`.sillyspec/changes/<变更名>/\` 下生成四个文件。
-
-### 操作
-1. 生成 proposal.md：动机、变更范围、不在范围内、成功标准
-2. 生成 requirements.md：功能需求、用户场景（Given/When/Then）、非功能需求
-3. 生成 design.md：架构决策、文件变更清单、数据模型、API 设计、代码风格参照
-4. 生成 tasks.md：任务列表（只列名称，不展开步骤）
-
-### 输出
-四个文件路径
-
-### 注意
-- 表名/字段名必须来自真实 schema 或标注"新增"
-- 用户场景必须用 Given/When/Then 格式
-- tasks.md 只列任务名，细节在 plan 阶段展开`,
-      outputHint: '四个文件路径',
-      optional: false
-    },
-    {
-      name: '自检门控',
-      prompt: `自检生成的规范文件。
-
-### 操作
-检查以下各项：
-- [ ] proposal.md 有动机、变更范围、不在范围内、成功标准
-- [ ] design.md 有文件变更清单表格
-- [ ] requirements.md 有 Given/When/Then 用户场景
-- [ ] tasks.md 每个 task 有文件路径
-
-任何不通过 → 修正后重新检查。
-
-### 输出
-自检通过/不通过`,
-      outputHint: '自检结果',
-      optional: false
-    },
-    {
-      name: '展示并更新进度',
-      prompt: `展示规范给用户，更新进度。
-
-### 操作
-1. 展示 proposal.md 和 design.md 摘要
-
-### 输出
-展示结果 + 下一步命令`,
-      outputHint: '展示结果',
-      optional: false
-    }
-  ]
-}