sillyspec 3.12.5 → 3.12.7

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

@@ -21,6 +21,7 @@ $ARGUMENTS
 1. 运行 `sillyspec run auto --input "<用户需求>"`
 2. 读取 CLI 输出的 step prompt（包含你的角色描述）
 3. 执行 prompt 中的操作
+4. **记录 CLI 输出中显示的 Change 名称**（如 `Change: 2026-06-02-xxx`）
 
 ### 步骤循环
 重复以下循环直到 CLI 输出"全部流程已完成"：
@@ -31,6 +32,9 @@ $ARGUMENTS
    - 纯内部操作 → **直接执行**
 3. **执行 prompt 要求的操作**
 4. **完成后运行** `sillyspec run auto --done --output "<你的摘要>"`
+   - ⚠️ **必须携带 --change <变更名>**，变更名来自启动时 CLI 输出的 `Change:` 字段
+   - 示例：`sillyspec run auto --done --change 2026-06-02-spec-bootstrap-agent-stream-interaction --output "摘要"`
+   - **绝不使用 `--change default`**，除非 CLI 启动时明确显示的 Change 名称就是 `default`
 5. **读取 CLI 输出的下一步 prompt**，回到步骤 1
 
 ### 阶段审核门控
@@ -69,6 +73,7 @@ $ARGUMENTS
 - 不要使用 npx
 - 不要编造不存在的 CLI 子命令
 - 遇到命令报错 → 展示错误，暂停等用户介入
+- **每次调用 `sillyspec run auto --done` 都必须携带 `--change <变更名>`**，变更名 = CLI 首次输出中显示的 Change 名称。如果 CLI 首次运行没有显示 Change 名称，从 progress 或用户输入中确认变更名后再调用
 
 ### 异常处理
 - 命令执行失败 → 展示错误信息，暂停等待用户指示

package/package.json

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

package/src/hooks/worktree-guard.js

@@ -14,7 +14,7 @@ import path from 'path'
 
 // ── 常量 ──
 
-const ALLOWED_STAGES = ['execute', 'quick']
+const WORKTREE_STAGES = ['execute'] // 这些阶段必须在 worktree 里
 
 const WORKTREE_SEGMENT = '.sillyspec/.runtime/worktrees/'
 
@@ -410,14 +410,17 @@ export function shouldBlockWrite(filePath, cwd) {
   const effectiveCwd = cwd || process.cwd()
   const stage = readCurrentStage(effectiveCwd) || '(none)'
 
-  if (!ALLOWED_STAGES.includes(stage)) {
+  if (!['execute', 'quick'].includes(stage)) {
     return {
       blocked: true,
       reason: buildStageHint(stage)
     }
   }
 
-  // 3. 位置门禁
+  // quick 阶段直接放行（不要求 worktree）
+  if (stage === 'quick') return { blocked: false }
+
+  // execute 阶段：位置门禁
   if (isInsideWorktree(absPath)) return { blocked: false }
 
   // noWorktree 模式：无隔离环境，禁止源码写入（降级到更严格）
@@ -464,9 +467,8 @@ export function shouldBlockBash(command, cwd) {
 
   // 阶段门禁（使用 fallback 读取）
   const stage = readCurrentStage(effectiveCwd) || '(none)'
-  const stageOk = ALLOWED_STAGES.includes(stage)
 
-  if (!stageOk) {
+  if (!['execute', 'quick'].includes(stage)) {
     // 非 execute/quick 阶段，只允许只读白名单
     const localConfig = loadLocalConfig(effectiveCwd)
     const extraReadonly = localConfig.worktreeHook?.readonlyCommands || localConfig['worktree-hook']?.readonlyCommands || []
@@ -477,7 +479,16 @@ export function shouldBlockBash(command, cwd) {
     }
   }
 
-  // execute/quick 阶段 + 主工作区
+  // quick 阶段直接放行（不要求 worktree）
+  if (stage === 'quick') {
+    // 危险黑名单仍然拦截
+    if (matchDangerBlacklist(command)) {
+      return { blocked: true, reason: `dangerous command blocked: ${command.trim()}` }
+    }
+    return { blocked: false }
+  }
+
+  // execute 阶段 + 主工作区
   const localConfig = loadLocalConfig(effectiveCwd)
   const extraReadonly = localConfig.worktreeHook?.readonlyCommands || localConfig['worktree-hook']?.readonlyCommands || []
 

package/src/run.js

@@ -213,6 +213,10 @@ async function outputStep(stageName, stepIndex, steps, cwd, changeName, dbProjec
   promptText = promptText.replace(/<now-datetime>/g, nowDatetime)
   promptText = promptText.replace(/<now-timestamp>/g, nowTimestamp)
   promptText = promptText.replace(/<now-date>/g, nowDate)
+  // 替换 <change-name> 占位符
+  if (changeName && promptText.includes('<change-name>')) {
+    promptText = promptText.replace(/<change-name>/g, changeName)
+  }
   console.log(promptText)
   console.log(`\n### ⚠️ 铁律`)
   console.log('- **文档是核心资产，代码是文档的产物。** 没有文档就没有代码——文档是 AI 的记忆，是团队协作的基础，是后续维护的唯一依据。任何代码产出必须先有对应的设计/规范文档支撑。')

package/src/stages/brainstorm.js

@@ -275,6 +275,14 @@ design.md 文件路径 + 自审结果
    - **tasks.md**：任务列表（只列名称和对应文件路径，细节在 plan 阶段展开）
    - \`git add .sillyspec/\` — 暂存规范文件（不要 commit）
 
+所有规范文件头部必须包含 YAML frontmatter：
+\`\`\`\`yaml
+---
+author: <git-user>
+created_at: <now-datetime>
+---
+\`\`\`\`
+
 ### proposal.md 格式要求
 \`\`\`markdown
 # Proposal
@@ -332,6 +340,7 @@ Then 期望结果
    - \`requirements.md\`：从 MASTER.md 中提取该包的需求范围（标记为「待完善」）
    - \`tasks.md\`：创建空任务列表，标记为「待 plan 阶段展开」
 4. \`git add .sillyspec/\` — 暂存所有新增文件（不要 commit）
+5. 后续变更包的骨架文件同样必须包含 \`author: <git-user>\` 和 \`created_at: <now-datetime>\`
 
 ### 输出
 所有规范文件路径（含后续变更包目录列表）

package/src/stages/execute.js

@@ -338,7 +338,7 @@ ${taskSummary}
 ${taskList}
 
 ### 调度要求
-1. 同一 Wave 内任务可并行启动子代理
+1. **同一 Wave 内的任务必须并行启动子代理，禁止串行等待。** Wave 的定义就是"无依赖、可并行"，不要自行分析依赖关系。如果有依赖应该在 plan.md 的不同 Wave 中。
 2. **Reverse Sync**：子代理报告实现与 design.md 不一致时，先检查是代码错了还是文档有遗漏
 3. **不要频繁编译！** 编译很慢，只在以下情况运行：
    - 写了大量代码后需要验证语法正确性

package/src/stages/plan.js

@@ -165,6 +165,32 @@ plan.md 总览内容`,
 
 // 固定后缀步骤
 export const fixedSuffix = [
+  {
+    name: '重排 Wave（基于 depends_on）',
+    prompt: `根据蓝图的 depends_on 字段重排 Wave 分组，更新 plan.md。
+
+### 操作
+1. 读取所有 tasks/task-NN.md 的 frontmatter，提取每个任务的 depends_on 列表
+2. 拓扑排序：无依赖的任务 → Wave 1，依赖 Wave 1 的 → Wave 2，依此类推
+3. 检查是否存在循环依赖，如有则报错暂停
+4. 用重排结果更新 plan.md：
+   - Wave 分组（含 checkbox 列表）
+   - 任务总表的 Wave 列
+   - 依赖关系图（Mermaid）
+   - 关键路径
+5. 如果 Wave 分组与原始 plan.md 一致，只需确认一致即可，不需要重写
+
+### 规则
+- **Wave 是执行单元，同 Wave 内任务必须无依赖（可并行）**
+- 有 depends_on 关系的任务必须在不同的 Wave
+- depends_on 为空的任务放 Wave 1
+- 取决于拓扑排序的最大深度决定 Wave 编号
+
+### 输出
+重排后的 Wave 分组摘要（如果与原 plan.md 一致则说明一致）`,
+    outputHint: 'Wave 重排结果',
+    optional: false
+  },
   {
     name: '审查一致性',
     prompt: `审查所有 task-N.md 的一致性。
@@ -213,6 +239,9 @@ function buildTaskPrompt(taskNum, taskName, changeDir) {
   const num = String(taskNum).padStart(2, '0')
   return `编写任务蓝图 tasks/task-${num}.md
 
+当前时间：<now-datetime>（frontmatter 的 created_at 使用此值）
+当前用户：<git-user>（frontmatter 的 author 使用此值）
+
 ### 任务
 ${taskName}
 
@@ -313,6 +342,8 @@ export function buildCoordinatorStep(changeDir, taskNames) {
 任务编号：task-${num}
 任务名称：${name}
 文件路径：${changeDir}/tasks/task-${num}.md
+当前时间：<now-datetime>（frontmatter 的 created_at 使用此值）
+当前用户：<git-user>（frontmatter 的 author 使用此值）
 
 操作：
 1. 读取 ${changeDir}/design.md 和 ${changeDir}/plan.md 了解上下文
@@ -383,6 +414,10 @@ allowed_paths:
 ## 任务清单
 ${taskList}
 
+## 时间和用户
+当前时间：<now-datetime>
+当前用户：<git-user>
+
 ## 执行方式（必须严格遵守）
 
 **你必须使用 Agent tool 启动子代理来写每个蓝图，不要自己写。**

package/src/stages/quick.js

@@ -40,33 +40,12 @@ export const definition = {
       outputHint: '任务理解',
       optional: false
     },
-    {
-      name: '创建 worktree',
-      prompt: `为本次 quick 任务创建隔离的 git worktree。
-
-### 操作
-1. 确定变更名（change name）：
-   - 如携带 \`--change <变更名>\`，使用该变更名
-   - 否则，生成临时变更名：\`quick-<now-timestamp>\`
-2. 运行 \`sillyspec worktree create <变更名>\`
-3. 记录输出的 worktree 路径（后续步骤需要使用）
-4. 如果创建失败 → 报错并停止（不要在无隔离状态下继续）
-
-### 输出
-worktree 路径 + 变更名 + 分支名`,
-      outputHint: 'worktree 路径',
-      optional: false
-    },
     {
       name: '实现并验证',
-      prompt: `实现任务。
-
-### 工作目录
-你必须在上一步记录的 worktree 路径中工作。
-不要在主工作区修改源码文件。所有代码变更只在 worktree 中进行。
+      prompt: `直接在主工作区实现任务。
 
 ### 操作
-1. 先读后写：调用已有方法前 \`cat\` 源文件确认签名，\`grep\` 确认方法存在（在 worktree 中读取）
+1. 先读后写：调用已有方法前 \`cat\` 源文件确认签名，\`grep\` 确认方法存在
 2. 写代码完成任务
 3. 如涉及逻辑变更，建议写单元测试验证（不强制，纯配置/文档/小改动可跳过）
 4. **不要编译！** 除非用户明确要求或改动量很大
@@ -81,24 +60,6 @@ worktree 路径 + 变更名 + 分支名`,
       outputHint: '实现摘要',
       optional: false
     },
-    {
-      name: 'apply 并 cleanup',
-      prompt: `将 worktree 中的变更应用到主工作区并清理。
-
-### 操作
-1. 运行 \`sillyspec worktree apply --check-only <变更名>\`
-2. 展示 diff 摘要（文件列表 + 变更统计）
-3. 展示检查结果（是否通过文件清单校验）
-4. 用户确认后运行 \`sillyspec worktree apply <变更名>\`
-5. apply 成功 → 自动 cleanup，进入下一步
-6. apply 失败 → 展示错误详情，用户选择重试或手动处理
-7. 如果用户不想 apply → 运行 \`sillyspec worktree cleanup <变更名>\` 丢弃变更
-
-### 输出
-apply 结果 + 下一步建议`,
-      outputHint: 'apply 结果',
-      optional: false
-    },
     {
       name: '暂存和更新记录',
       prompt: `Git 暂存并更新任务记录。

package/src/stages/scan.js

@@ -134,7 +134,7 @@ export const definition = {
 
 ### 每个子代理的共同要求
 - **上下文注入**：主 agent 在启动子代理前，必须将以下信息拼入子代理 prompt：
-  - 项目名（<project>）
+  - 项目名（直接用本次 prompt 中的实际项目名）
   - 断点续扫步骤列出的缺失文档列表（哪些要生成、哪些跳过）
   - 环境探测结果摘要（构建工具、语言框架、关键依赖）
   - _env-detect.md 内容（如存在，直接贴入）

package/src/worktree.js

@@ -106,7 +106,13 @@ export class WorktreeManager {
 
     // 1. 检查 worktree 是否已存在
     if (existsSync(worktreePath)) {
-      throw new Error(`worktree already exists: ${name}. Run cleanup first.`);
+      // 目录在但 meta.json 不存在（幽灵状态），自动清理
+      if (!this.getMeta(name)) {
+        console.log(`⚠️  检测到幽灵 worktree 目录（无 meta.json），自动清理...`);
+        try { rmSync(worktreePath, { recursive: true, force: true }); } catch {}
+      } else {
+        throw new Error(`worktree already exists: ${name}. Run cleanup first.`);
+      }
     }
 
     // 2. 检查分支是否已存在
@@ -223,26 +229,27 @@ export class WorktreeManager {
   cleanup(changeName) {
     const name = validateChangeName(changeName);
     const meta = this.getMeta(name);
+    const worktreePath = this.getWorktreePath(name);
 
-    if (!meta) {
-      throw new Error(`worktree not found: ${name}。meta.json 不存在，可能已被清理或从未创建。`);
+    if (!meta && !existsSync(worktreePath)) {
+      throw new Error(`worktree not found: ${name}。meta.json 不存在，目录也不存在，可能已被清理或从未创建。`);
     }
 
-    const worktreePath = meta.worktreePath || this.getWorktreePath(name);
-    const branch = meta.branch || BRANCH_PREFIX + name;
-
-    // 2. 移除 git worktree
+    // 1. 尝试 git worktree remove
     try {
       git(this.cwd, `worktree remove ${worktreePath} --force`);
     } catch {
       // git worktree remove 失败，尝试直接删除目录
-      try {
-        if (existsSync(worktreePath)) {
-          rmSync(worktreePath, { recursive: true, force: true });
-        }
-      } catch (e) {
-        throw new Error(`清理 worktree 目录失败: ${e.message}`);
+    }
+    const branch = (meta && meta.branch) || BRANCH_PREFIX + name;
+
+    // 2. 确保目录已删除
+    try {
+      if (existsSync(worktreePath)) {
+        rmSync(worktreePath, { recursive: true, force: true });
       }
+    } catch (e) {
+      throw new Error(`清理 worktree 目录失败: ${e.message}`);
     }
 
     // 3. 删除分支（忽略分支不存在的错误）