sillyspec 3.12.6 → 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.6",
+  "version": "3.12.7",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

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 启动子代理来写每个蓝图，不要自己写。**