sillyspec 3.12.6 → 3.12.8

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/SKILL.md

@@ -1,46 +1,46 @@
 ---
 name: sillyspec
-description: "规范驱动开发工具包 v3.9。绿地项目用 /sillyspec:init，棕地项目用 /sillyspec:scan。主线：scan、brainstorm、plan、execute、verify、archive。辅助：quick、explore、status、doctor、resume、continue、commit、export、workspace。"
-version: "3.9.1"
+description: "规范驱动开发工具包。绿地用 /sillyspec:init，棕地用 /sillyspec:scan，全自动用 /sillyspec:auto。完整流程：scan → brainstorm → plan → execute → verify → archive。支持 TDD、子代理并行、worktree 隔离、E2E 验证。兼容 Claude Code / Cursor / Codex / OpenCode / OpenClaw。"
+version: "3.12.7"
 ---
 
-# SillySpec v3.9
+# SillySpec
 
-融合 Superpowers + OpenSpec + GSD，从"你说要啥"到"代码能跑"的完整流程。
-Claude Code / Cursor / Codex / OpenCode / OpenClaw 都能用。
+从"你说要啥"到"代码能跑"的规范驱动开发工具包。
+Claude Code / Cursor / Codex / OpenCode / OpenClaw 通用。
 
-## 入口选择
+## 快速开始
 
-| 项目类型 | 首选命令 |
+| 场景 | 命令 |
 |---|---|
+| 全自动流程 | `/sillyspec:auto <需求描述>` |
 | 全新项目（空目录） | `/sillyspec:init` |
 | 已有代码的项目 | `/sillyspec:scan` |
 | 多项目工作区 | `/sillyspec:workspace` |
-| 随时自由思考 | `/sillyspec:explore` |
+| 自由思考 | `/sillyspec:explore` |
 
 ## 完整工作流
 
 ```
-绿地：init → brainstorm → plan → execute → [verify] → archive
+绿地：init → brainstorm → plan → execute → verify → archive
 棕地：scan → brainstorm → plan → execute → verify → archive
-工作区：workspace → (init/scan per project) → brainstorm → ...
+全自动：auto（自动推进全部阶段，支持用户确认门控）
 ```
 
-## 命令
-
-### 核心流程
+## 核心命令
 
 | 命令 | 用途 |
 |---|---|
+| `/sillyspec:auto` | 全自动推进全部流程 |
 | `/sillyspec:init` | 绿地项目初始化 |
-| `/sillyspec:scan` | 棕地项目扫描（7 份文档） |
+| `/sillyspec:scan` | 棕地项目扫描（生成 7 份文档） |
 | `/sillyspec:brainstorm` | 需求探索 + 生成设计文档 |
-| `/sillyspec:plan` | 编写实现计划（Wave 分组） |
+| `/sillyspec:plan` | 编写实现计划（Wave 分组 + 拓扑排序） |
 | `/sillyspec:execute` | TDD 执行 + 子代理并行 |
 | `/sillyspec:verify` | 验证（测试 + 代码审查 + E2E） |
 | `/sillyspec:archive` | 归档变更 |
 
-### 辅助工具
+## 辅助命令
 
 | 命令 | 用途 |
 |---|---|
@@ -49,44 +49,43 @@ Claude Code / Cursor / Codex / OpenCode / OpenClaw 都能用。
 | `/sillyspec:explore` | 自由思考模式 |
 | `/sillyspec:quick` | 快速任务，跳过完整流程 |
 | `/sillyspec:resume` | 恢复工作 |
-| `/sillyspec:state` | 查看当前工作状态 |
+| `/sillyspec:doctor` | 项目自检 |
 | `/sillyspec:commit` | 智能提交 |
 | `/sillyspec:export` | 导出成功方案为可复用模板 |
-| `/sillyspec:doctor` | 项目自检 |
 | `/sillyspec:workspace` | 多项目工作区管理 |
 
 ## CLI 命令
 
 ```bash
-sillyspec run scan           执行代码扫描阶段
-sillyspec run brainstorm     执行需求探索阶段
-sillyspec run plan           执行实现计划阶段
-sillyspec run execute        执行开发阶段
-sillyspec run verify         执行验证阶段
-sillyspec run archive        执行归档阶段
-sillyspec run quick          快速任务
-sillyspec run explore        自由探索
-sillyspec progress show      显示当前项目状态
-sillyspec setup              安装推荐 MCP 工具
-sillyspec setup --list       查看已安装 MCP 状态
-sillyspec init               初始化（零交互，自动检测工具）
-sillyspec init --tool <name> 指定工具安装
-sillyspec init --workspace   工作区模式
-sillyspec init --interactive 交互式引导
+sillyspec run auto            全自动推进全部流程
+sillyspec run scan            执行代码扫描阶段
+sillyspec run brainstorm      执行需求探索阶段
+sillyspec run plan            执行实现计划阶段
+sillyspec run execute         执行开发阶段（子代理并行 + worktree 隔离）
+sillyspec run verify          执行验证阶段
+sillyspec run archive         执行归档阶段
+sillyspec run quick           快速任务
+sillyspec run explore         自由探索
+sillyspec progress show       显示当前项目状态
+sillyspec setup               安装推荐 MCP 工具
+sillyspec init                初始化（零交互，自动检测工具）
 ```
 
-## MCP 增强
+## 核心特性
 
-通过 `sillyspec setup` 安装 MCP 工具增强 AI 能力：
+- **规范驱动** — 所有代码产出先有设计文档支撑，文档是 AI 的记忆
+- **TDD 强制** — execute 阶段强制先写测试再写实现
+- **子代理并行** — 同一 Wave 内任务并行执行，加快交付
+- **Worktree 隔离** — execute 在独立 worktree 中工作，不污染主分支
+- **拓扑排序 Wave** — plan 阶段根据蓝图依赖关系自动重排 Wave 分组
+- **E2E 验证** — 内置 E2E 测试流程，支持 Playwright / 浏览器 MCP
+- **模块文档** — 支持模块级知识库，AI 执行时按需加载相关模块上下文
+- **进度管理** — SQLite 持久化进度，断点恢复
+- **MCP 增强** — 一键安装 Context7、grep.app、Chrome DevTools
 
-- **Context7** — 查询最新库文档和 API 参考
-- **grep.app** — 搜索开源代码实现
-- **Chrome DevTools** — 浏览器自动化，支持 E2E 验证
+## MCP 工具
 
-## E2E 测试流程
-
-```
-plan: 识别 UI 功能 → 检测测试框架/浏览器 MCP → 添加 E2E 任务
-execute: 编码完成后编写 E2E 测试（测试文件或 e2e-steps.md）
-verify: 按优先级执行（E2E框架 > 通用测试 > 浏览器MCP）→ 自动修复循环
+```bash
+sillyspec setup              安装全部推荐 MCP
+sillyspec setup --list       查看已安装 MCP 状态
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.12.6",
+  "version": "3.12.8",
   "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 启动子代理来写每个蓝图，不要自己写。**