dev-playbooks-cn 1.0.19 → 1.1.0

package/README.md

@@ -27,22 +27,7 @@ AI 编码助手很强大，但往往**不可预测**：
 - **基于证据的完成**：完成由测试/构建/证据定义，而非 AI 自我评估
 - **强制角色隔离**：Test Owner 与 Coder 必须在独立对话中工作
 - **多重质量闸门**：Green 证据检查、任务完成率、角色边界检查
-- **21 个 Skills**：覆盖提案、设计、对辩、评审、熵度量、联邦分析等
-
----
-
-## DevBooks 对比一览
-
-| 维度 | DevBooks | OpenSpec | spec-kit | 无规格 |
-|------|----------|----------|----------|--------|
-| 规格驱动工作流 | 是 | 是 | 是 | 否 |
-| 变更产物的可追溯性 | 变更包集中存档（proposal/design/spec/tasks/verification/evidence） | 主要以变更目录/文件组织为主 | 以文档+任务编排为主 | 无 |
-| 角色与职责边界 | **强制隔离**（Test Owner / Coder） | 约定为主（不强制） | 约定为主（不强制） | 无 |
-| 完成判据（DoD） | **证据驱动 + 闸门**（测试/构建/审计） | 人工定义/人工检查 | 人工定义/人工检查 | 常依赖主观判断 |
-| 代码质量保障 | 守门 + 指标（熵度量/热点）+ Review 角色 | 依赖外部工具/人工 review | 依赖外部工具/人工 review | 不稳定 |
-| 影响面分析 | CKB 图基能力（可降级 Grep） | 文本搜索/人工推导 | 文本搜索/人工推导 | 容易漏改 |
-| 存量项目起步 | 自动生成基线规格/术语表/最小验证锚点 | 手动补齐 | 有限 | - |
-| 自动化覆盖面 | 21 个 Skills（提案→实现→归档闭环） | 3 个核心命令 | 工具包（偏 0→1） | - |
+- **18 个 Skills**：覆盖提案、设计、评审、熵度量等完整工作流
 
 ---
 
@@ -174,7 +159,6 @@ DevBooks 使用两个目录根：
 | `devbooks-impact-analysis` | 跨模块影响分析 |
 | `devbooks-proposal-challenger` | 质疑和挑战提案 |
 | `devbooks-proposal-judge` | 裁决提案 |
-| `devbooks-proposal-debate-workflow` | 三角对辩（Author/Challenger/Judge） |
 | `devbooks-design-doc` | 创建设计文档 |
 | `devbooks-spec-contract` | 定义规格与契约 |
 | `devbooks-implementation-plan` | 创建实现计划 |
@@ -206,9 +190,7 @@ DevBooks 使用两个目录根：
 | Skill | 说明 |
 |-------|------|
 | `devbooks-entropy-monitor` | 系统熵度量 |
-| `devbooks-federation` | 跨仓库联邦分析 |
 | `devbooks-brownfield-bootstrap` | 存量项目初始化 |
-| `devbooks-index-bootstrap` | 生成 SCIP 索引 |
 
 ---
 
@@ -216,54 +198,55 @@ DevBooks 使用两个目录根：
 
 ### vs. OpenSpec
 
-[OpenSpec](https://github.com/Fission-AI/OpenSpec) 是轻量级规格驱动框架，用三个核心命令（proposal/apply/archive）对齐人与 AI，按功能文件夹分组变更。
-
-**DevBooks 新增：**
-- **角色隔离**：Test Owner 与 Coder 硬边界（必须独立对话）
-- **质量闸门**：5+ 验证闸门拦截伪完成
-- **21 个 Skills**：覆盖提案、对辩、评审、熵度量、联邦分析
-- **基于证据的完成**：测试/构建定义"完成"，而非 AI 自评
+[OpenSpec](https://github.com/Fission-AI/OpenSpec) 是轻量级规格驱动框架，用三个核心命令（proposal/apply/archive）对齐人与 AI。
 
-**选择 OpenSpec**：简单规格驱动变更，需要轻量工作流。
+**OpenSpec 的局限**：
+- 缺乏角色隔离，AI 可能自我验证"已完成"
+- 无质量闸门，伪完成难以拦截
+- 只有 3 个命令，复杂变更覆盖不足
 
-**选择 DevBooks**：大型变更、需要角色分离和质量验证。
+**DevBooks 解决方案**：
+- **强制角色隔离**：Test Owner 与 Coder 必须独立对话，杜绝自我验证
+- **5+ 质量闸门**：Green 证据检查、任务完成率、角色边界检查
+- **18 个 Skills**：覆盖提案→实现→归档完整闭环
 
 ### vs. spec-kit
 
-[GitHub spec-kit](https://github.com/github/spec-kit) 提供规格驱动开发工具包，有 constitution 文件、多步骤细化和结构化规划。
-
-**DevBooks 新增：**
-- **存量优先**：自动为现有代码库生成基线规格
-- **角色隔离**：测试编写与实现强制分离
-- **质量闸门**：运行时验证，不只是工作流引导
-- **原型模式**：安全实验不污染主 src/
+[GitHub spec-kit](https://github.com/github/spec-kit) 提供规格驱动开发工具包，有 constitution 文件和结构化规划。
 
-**选择 spec-kit**：0→1 绿地项目，使用支持的 AI 工具。
+**spec-kit 的局限**：
+- 偏向 0→1 绿地项目，存量项目支持有限
+- 无强制角色隔离，测试与实现可能混淆
+- 依赖人工检查，缺乏运行时验证
 
-**选择 DevBooks**：存量项目或需要强制质量闸门。
+**DevBooks 解决方案**：
+- **存量优先**：`devbooks-brownfield-bootstrap` 自动生成基线规格
+- **强制角色隔离**：测试编写与实现物理分离
+- **运行时闸门**：自动验证，不依赖人工检查
 
 ### vs. Kiro.dev
 
-[Kiro](https://kiro.dev/) 是 AWS 的代理式 IDE，用三阶段工作流（EARS 格式需求、设计、任务），但规格与实现产物分开存储。
+[Kiro](https://kiro.dev/) 是 AWS 的代理式 IDE，用三阶段工作流（需求、设计、任务）。
 
-**DevBooks 差异：**
-- **变更包**：每个变更包含 proposal/design/spec/plan/verification/evidence，整个生命周期可在一个位置追溯
-- **角色隔离**：Test Owner 与 Coder 强制分离
-- **质量闸门**：通过闸门验证，不只是任务完成
+**Kiro 的局限**：
+- 规格与实现产物分开存储，追溯困难
+- 无强制角色隔离
+- 依赖特定 IDE 环境
 
-**选择 Kiro**：想要集成 IDE 体验和 AWS 生态。
-
-**选择 DevBooks**：想要变更包捆绑所有产物并强制角色边界。
+**DevBooks 解决方案**：
+- **变更包**：proposal/design/spec/plan/verification/evidence 集中存储，完整追溯
+- **强制角色隔离**：Test Owner 与 Coder 硬边界
+- **工具无关**：支持 Claude Code、Codex CLI、Cursor 等多种工具
 
 ### vs. 无规格
 
 没有规格时，AI 从模糊提示生成代码，导致不可预测的输出、范围蔓延和"幻觉式完成"。
 
 **DevBooks 带来：**
-- 实现前商定规格
-- 验证真实完成的质量闸门
-- 防止自我验证的角色隔离
-- 每个变更的证据链
+- 实现前商定规格，范围清晰可控
+- 质量闸门验证真实完成
+- 角色隔离防止自我验证
+- 每个变更的完整证据链
 
 ---
 
@@ -349,12 +332,6 @@ DevBooks 跟踪四维系统熵：
 
 </details>
 
-<details>
-<summary><strong>跨仓库联邦</strong></summary>
-
-多仓库分析用 `devbooks-federation`，分析跨仓库边界的契约和依赖，支持协调变更。
-
-</details>
 
 <details>
 <summary><strong>MCP 自动检测</strong></summary>
@@ -380,19 +357,21 @@ DevBooks Skills 支持 MCP（Model Context Protocol）优雅降级：在没有 M
 - 超时/失败 → 静默降级到基础模式，不阻塞执行
 - 无需手动选择"基础/增强"模式
 
-如需启用增强能力：按 `docs/推荐MCP.md` 配置 CKB，并运行 `devbooks-index-bootstrap` 生成 `index.scip`。
+如需启用增强能力：按 `docs/推荐MCP.md` 配置 CKB，并手动生成 `index.scip`。
 
 </details>
 
 <details>
-<summary><strong>提案对辩工作流</strong></summary>
+<summary><strong>提案审查流程</strong></summary>
+
+严格提案审查使用独立对话的 Challenger 和 Judge：
 
-严格提案审查用三角对辩 `devbooks-proposal-debate-workflow`：
+三个角色（必须独立对话）：
+1. **Author**：创建并捍卫提案（使用 `devbooks-proposal-author`）
+2. **Challenger**：质疑假设、发现缺口、识别风险（使用 `devbooks-proposal-challenger`）
+3. **Judge**：做最终决定、记录理由（使用 `devbooks-proposal-judge`）
 
-三个角色：
-1. **Author**：创建并捍卫提案
-2. **Challenger**：质疑假设、发现缺口、识别风险
-3. **Judge**：做最终决定、记录理由
+**重要**：三个角色必须在**独立对话**中工作，以避免角色混淆和自我验证。
 
 决定结果：`Approved`、`Revise`、`Rejected`
 

package/bin/devbooks.js

@@ -247,6 +247,23 @@ function copyDirSync(src, dest) {
   return count;
 }
 
+function pruneRemovedSkills(skillsDestDir, allowedSkillNames) {
+  if (!fs.existsSync(skillsDestDir)) return 0;
+  let removedCount = 0;
+  const entries = fs.readdirSync(skillsDestDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (!entry.name.startsWith('devbooks-')) continue;
+    if (allowedSkillNames.has(entry.name)) continue;
+
+    fs.rmSync(path.join(skillsDestDir, entry.name), { recursive: true, force: true });
+    removedCount++;
+  }
+
+  return removedCount;
+}
+
 function getSkillsSupportLabel(level) {
   switch (level) {
     case SKILLS_SUPPORT.FULL:
@@ -391,6 +408,7 @@ function installSkills(toolIds, update = false) {
         .filter(name => fs.statSync(path.join(skillsSrcDir, name)).isDirectory());
 
       if (skillDirs.length === 0) continue;
+      const skillNames = new Set(skillDirs);
 
       fs.mkdirSync(skillsDestDir, { recursive: true });
 
@@ -420,7 +438,15 @@ function installSkills(toolIds, update = false) {
         installedCount++;
       }
 
-      results.push({ tool: tool.name, type: 'skills', count: installedCount, total: skillDirs.length });
+      const removedCount = update ? pruneRemovedSkills(skillsDestDir, skillNames) : 0;
+
+      results.push({
+        tool: tool.name,
+        type: 'skills',
+        count: installedCount,
+        total: skillDirs.length,
+        removed: removedCount
+      });
     }
 
     // Qoder: 创建 agents 目录结构（但不复制 Skills，因为格式不同）
@@ -915,6 +941,9 @@ async function updateCommand(projectDir) {
     if (result.count > 0) {
       console.log(chalk.green('✓') + ` ${result.tool} ${result.type}: 更新了 ${result.count}/${result.total} 个`);
     }
+    if (result.removed && result.removed > 0) {
+      console.log(chalk.green('✓') + ` ${result.tool} ${result.type}: 清理了 ${result.removed} 个已删除的技能`);
+    }
   }
 
   // 更新 Rules（项目目录）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-playbooks-cn",
-  "version": "1.0.19",
+  "version": "1.1.0",
   "description": "AI-driven spec-based development workflow",
   "keywords": [
     "devbooks",

package/skills/Skills/344/275/277/347/224/250/350/257/264/346/230/216.md

@@ -115,26 +115,6 @@
 
 ---
 
-## `devbooks-proposal-debate-workflow`（Proposal Debate Workflow）
-
-- 作用：把“提案-质疑-裁决”跑成一套三角对辩流程（Author/Challenger/Judge 角色隔离），并确保 Decision Log 状态明确。
-- 使用场景：
-  - 你想强制三角色对抗来提高提案质量
-  - 团队里经常“风险没说清就开工”
-- 使用话术：
-  ```text
-  你现在是 Proposal Debate Orchestrator。请点名使用 `devbooks-proposal-debate-workflow`。
-  先读：`dev-playbooks/project.md`
-  约束：Author/Challenger/Judge 必须独立对话/独立实例；如果我无法提供独立对话，你就停止并说明原因。
-  目标：最终 `dev-playbooks/changes/<change-id>/proposal.md` 的 Decision Log 状态必须为 Approved/Revise/Rejected（禁止 Pending）。
-  请你按工作流逐步告诉我：每一个独立对话里我要复制粘贴的指令是什么，以及每一步需要我把什么结果贴回当前对话。
-
-  我的需求是：
-  <一句话需求 + 背景 + 约束>
-  ```
-
----
-
 ## `devbooks-design-doc`（Design Owner / Design Doc）
 
 - 作用：产出 `design.md`，只写 What/Constraints + AC-xxx（禁止写实现步骤），作为测试与计划的黄金真理。
@@ -364,61 +344,16 @@
 
 ---
 
-## `devbooks-index-bootstrap`（Index Bootstrapper）【新】
+## `devbooks-test-reviewer`（Test Reviewer）【新】
 
-- 作用：自动检测项目语言栈并生成 SCIP 索引，激活图基代码理解能力（调用图、影响分析、符号引用等）。
-- **触发条件**：
-  - 用户说"初始化索引/建立代码图谱/激活图分析"
-  - `mcp__ckb__getStatus` 返回 SCIP 后端 `healthy: false`
-  - 进入新项目且 `index.scip` 不存在
+- 作用：以 Test Reviewer 角色评审 tests/ 测试质量（覆盖、边界、可读性、可维护性），只输出评审意见，不修改代码。
 - 使用场景：
-  - 想使用 `devbooks-impact-analysis` 的图基分析模式
-  - 想在 `devbooks-coder`/`devbooks-code-review` 中获得热点感知
-  - CKB MCP 工具报错"SCIP 后端不可用"
+  - Test Owner 完成测试后，需要独立评审测试质量
+  - 想发现测试覆盖盲区、边界条件遗漏、测试可维护性问题
 - 使用话术：
   ```text
-  请点名使用 `devbooks-index-bootstrap`。
-  目标：检测项目语言栈，生成 SCIP 索引，激活图基代码理解能力。
-  项目根目录：$(pwd)
-  ```
-- 手动生成索引（无需 Skill）：
-  ```bash
-  # TypeScript/JavaScript
-  npm install -g @anthropic-ai/scip-typescript
-  scip-typescript index --output index.scip
-
-  # Python
-  pip install scip-python
-  scip-python index . --output index.scip
-
-  # Go
-  go install github.com/sourcegraph/scip-go@latest
-  scip-go --output index.scip
-  ```
-
----
-
-## `devbooks-federation`（Federation Analyst）【新】
-
-- 作用：跨仓库联邦分析与契约同步。检测契约变更、分析跨仓库影响、通知下游消费者。
-- **触发条件**：
-  - 用户说"跨仓库影响/联邦分析/契约同步/上下游依赖/多仓库"
-  - 变更涉及 `federation.yaml` 中定义的契约文件
-- 使用场景：
-  - 多仓库项目，需要分析变更对下游的影响
-  - 对外 API/契约变更，需要通知消费者
-  - 想建立跨仓库的影响追溯
-- 前置条件：
-  - 项目根目录存在 `.devbooks/federation.yaml`（从 `skills/devbooks-federation/templates/federation.yaml` 复制）
-- 使用话术：
-  ```text
-  请点名使用 `devbooks-federation`。
-  目标：分析本次变更的跨仓库影响，检测契约变更，生成影响报告。
-  项目根目录：$(pwd)
-  变更文件：<变更的文件列表>
-  ```
-- 脚本支持：
-  ```bash
-  # 检查联邦契约变更
-  bash ~/.claude/skills/devbooks-federation/scripts/federation-check.sh --project-root "$(pwd)"
+  你现在是 Test Reviewer。请点名使用 `devbooks-test-reviewer`。
+  请只做测试质量评审（覆盖率/边界条件/可读性/可维护性），不修改代码。
+  输入：`tests/**` + `dev-playbooks/changes/<change-id>/verification.md`（如有）
+  输出：覆盖盲区 / 边界条件遗漏 / 可维护性风险 / 改进建议。
   ```

package/skills/_shared/mcp-enhancement-template.md

@@ -48,7 +48,7 @@
 
 ```
 ⚠️ CKB 不可用（超时或未配置），使用基础模式执行。
-如需启用增强功能，请运行 devbooks-index-bootstrap skill 生成索引。
+如需启用增强功能，请手动生成 SCIP 索引。
 ```
 ```
 
@@ -65,7 +65,6 @@
 - devbooks-proposal-author（纯文档生成）
 - devbooks-proposal-challenger（纯评审）
 - devbooks-proposal-judge（纯裁决）
-- devbooks-proposal-debate-workflow（流程编排）
 - devbooks-design-backport（文档回写）
 - devbooks-spec-gardener（文件整理）
 - devbooks-test-reviewer（测试评审）
@@ -88,8 +87,6 @@
 | devbooks-code-review | mcp__ckb__getHotspots | 热点文件高亮 |
 | devbooks-impact-analysis | mcp__ckb__analyzeImpact, findReferences | 精确影响分析 |
 | devbooks-brownfield-bootstrap | mcp__ckb__* | COD 模型生成 |
-| devbooks-index-bootstrap | mcp__ckb__getStatus | 索引状态检测 |
-| devbooks-federation | mcp__ckb__*, mcp__github__* | 跨仓库分析 |
 | devbooks-router | mcp__ckb__getStatus | 索引可用性检测 |
 | devbooks-spec-contract | mcp__ckb__findReferences | 引用检测 |
 | devbooks-entropy-monitor | mcp__ckb__getHotspots | 热点趋势分析 |

package/skills/_shared/workflow-next-steps.md

@@ -0,0 +1,111 @@
+# DevBooks 工作流下一步参考
+
+本文档定义了每个 skill 的标准下一步推荐。所有 skill 应引用此文件以确保一致的工作流指导。
+
+## 工作流顺序
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                     提案阶段 (PROPOSAL)                          │
+│  proposal-author → impact-analysis → design-doc → spec-contract │
+│                                          ↓                       │
+│                                implementation-plan               │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│                     实施阶段 (APPLY)                             │
+│      test-owner (会话A) ←→ coder (会话B)                        │
+│      (必须在不同会话中进行)                                      │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│                     评审阶段 (REVIEW)                            │
+│                      code-review                                 │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│                     归档阶段 (ARCHIVE)                           │
+│                     spec-gardener                                │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## 下一步矩阵
+
+| 当前 Skill | 下一步 | 条件 |
+|------------|--------|------|
+| `devbooks-proposal-author` | `devbooks-impact-analysis` | 如果跨模块影响不明确 |
+| `devbooks-proposal-author` | `devbooks-design-doc` | 如果影响明确 |
+| `devbooks-proposal-author` | `devbooks-proposal-challenger` | 如果高风险（可选） |
+| `devbooks-impact-analysis` | `devbooks-design-doc` | 始终 |
+| `devbooks-proposal-challenger` | `devbooks-proposal-judge` | 始终 |
+| `devbooks-proposal-judge` | `devbooks-design-doc` | 如果 Approved/Revise |
+| `devbooks-design-doc` | `devbooks-spec-contract` | 如果有外部行为/契约变更 |
+| `devbooks-design-doc` | `devbooks-implementation-plan` | 如果无外部契约变更 |
+| `devbooks-spec-contract` | `devbooks-implementation-plan` | 始终（绝不直接推荐 test-owner/coder） |
+| `devbooks-implementation-plan` | `devbooks-test-owner` | 始终（必须单独会话） |
+| `devbooks-test-owner` | `devbooks-coder` | Red 基线后（必须单独会话） |
+| `devbooks-coder` | `devbooks-code-review` | 所有任务完成后 |
+| `devbooks-code-review` | `devbooks-spec-gardener` | 如果有 spec deltas |
+| `devbooks-code-review` | 归档完成 | 如果无 spec deltas |
+| `devbooks-test-reviewer` | `devbooks-coder` | 如果发现测试问题，交回 |
+| `devbooks-design-backport` | `devbooks-implementation-plan` | 设计更新后重跑计划 |
+| `devbooks-spec-gardener` | 归档完成 | 始终 |
+
+## 关键约束
+
+### 提案阶段流程
+```
+proposal-author → [impact-analysis] → design-doc → [spec-contract] → implementation-plan
+```
+- 如果有外部行为/契约变更，`spec-contract` 是必需的
+- 对于跨模块变更，推荐使用 `impact-analysis`
+- **绝不从 spec-contract 或 design-doc 直接跳到 test-owner/coder**
+
+### 实施阶段流程
+```
+implementation-plan → test-owner (会话A) ←→ coder (会话B)
+```
+- Test Owner 和 Coder **必须在不同会话中**
+- Test Owner 先产出 Red 基线
+- Coder 按 tasks.md 实现，让闸门变绿
+
+### 角色隔离规则
+- Author、Challenger、Judge：辩论需在不同会话
+- Test Owner、Coder：不同会话（硬性要求）
+- Coder **不能修改** `tests/**`
+
+## 标准下一步输出格式
+
+推荐下一步时，使用此格式：
+
+```markdown
+## 推荐的下一步
+
+根据当前产物，推荐的下一个 skill 是：
+
+**下一步：`devbooks-<skill-name>`**
+
+原因：<为什么这个 skill 是工作流中的下一步>
+
+### 如何调用
+```
+运行 devbooks-<skill-name> skill 处理变更 <change-id>
+```
+
+### 替代路径（如适用）
+- 如果 <条件>：改用 `devbooks-<alternative-skill>`
+```
+
+## 常见错误避免
+
+1. **在 spec-contract 后直接推荐 test-owner/coder**
+   - 正确：spec-contract → implementation-plan → test-owner
+
+2. **在 design-doc 后直接推荐 coder**
+   - 正确：design-doc → [spec-contract] → implementation-plan → test-owner → coder
+
+3. **在同一会话中推荐 test-owner 和 coder**
+   - 正确：始终提醒"必须在不同会话中"
+
+4. **跳过 implementation-plan**
+   - implementation-plan 在实施阶段前是必需的

package/skills/devbooks-brownfield-bootstrap/SKILL.md

@@ -272,5 +272,5 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 ```
 ⚠️ CKB 不可用，使用传统分析方法生成项目画像。
-如需更精确的架构分析，请运行 devbooks-index-bootstrap skill 生成索引。
+如需更精确的架构分析，请手动生成 SCIP 索引。
 ```

package/skills/devbooks-brownfield-bootstrap/scripts/cod-update.sh

@@ -182,7 +182,7 @@ EOF
     echo "" >> "$temp_file"
     echo "---" >> "$temp_file"
     echo "" >> "$temp_file"
-    echo "> 提示：运行 \`devbooks-index-bootstrap\` 生成 SCIP 索引以获得更精确的依赖分析" >> "$temp_file"
+    echo "> 提示：手动生成 SCIP 索引以获得更精确的依赖分析（参考 docs/推荐MCP.md）" >> "$temp_file"
 
     # 只在内容变化时更新
     if [ -f "$output" ]; then

package/skills/devbooks-code-review/SKILL.md

@@ -136,6 +136,39 @@ override dispose() {
 
 ---
 
+## 下一步推荐
+
+**参考**：`skills/_shared/workflow-next-steps.md`
+
+完成 code-review 后，下一步取决于具体情况：
+
+| 条件 | 下一个 Skill | 原因 |
+|------|--------------|------|
+| 有 spec deltas | `devbooks-spec-gardener` | 归档前合并规格到真理 |
+| 无 spec deltas | 归档完成 | 无需其他 skill |
+| 发现重大问题 | 交回 `devbooks-coder` | 归档前修复问题 |
+
+### 输出模板
+
+完成 code-review 后，输出：
+
+```markdown
+## 推荐的下一步
+
+**下一步：`devbooks-spec-gardener`**（如果有 spec deltas）
+或
+**归档完成**（如果无 spec deltas）
+
+原因：代码评审已完成。下一步是[合并 spec deltas 到真理 / 完成归档]。
+
+### 如何调用（如果有 spec deltas）
+```
+运行 devbooks-spec-gardener skill 处理变更 <change-id>
+```
+```
+
+---
+
 ## MCP 增强
 
 本 Skill 支持 MCP 运行时增强，自动检测并启用高级功能。

package/skills/devbooks-coder/SKILL.md

@@ -245,6 +245,48 @@ fi
 
 ---
 
+## 下一步推荐
+
+**参考**：`skills/_shared/workflow-next-steps.md`
+
+完成 coder（所有任务完成，闸门变绿）后，下一步是：
+
+| 条件 | 下一个 Skill | 原因 |
+|------|--------------|------|
+| 所有任务已完成 | `devbooks-code-review` | 评审可读性/一致性 |
+| 需要修改测试 | 交回 `devbooks-test-owner` | Coder 不能修改测试 |
+
+**关键**：
+- Coder **不能修改** `tests/**`
+- 如发现测试问题，交回 Test Owner（单独会话）
+- 工作流顺序是：
+```
+coder → code-review → spec-gardener (如有 spec deltas) → 归档
+```
+
+### 输出模板
+
+完成 coder（所有闸门变绿）后，输出：
+
+```markdown
+## 推荐的下一步
+
+**下一步：`devbooks-code-review`**
+
+原因：所有任务已完成，闸门已变绿。下一步是代码评审，检查可读性、一致性和可维护性。
+
+### 如何调用
+```
+运行 devbooks-code-review skill 处理变更 <change-id>
+```
+
+### 评审后
+- 如有 spec deltas：`devbooks-spec-gardener` 合并到真理
+- 如无 spec deltas：归档完成
+```
+
+---
+
 ## MCP 增强
 
 本 Skill 支持 MCP 运行时增强，自动检测并启用高级功能。
@@ -278,6 +320,6 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 ```
 ⚠️ CKB 不可用，跳过热点检测。
-如需启用热点预警，请运行 devbooks-index-bootstrap skill 生成索引。
+如需启用热点预警，请手动生成 SCIP 索引。
 ```
 

package/skills/devbooks-delivery-workflow/SKILL.md

@@ -213,5 +213,5 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 ```
 ⚠️ CKB 索引不可用，架构检查将使用基础模式。
-建议运行 devbooks-index-bootstrap skill 生成索引以启用精确检查。
+建议手动生成 SCIP 索引以启用精确检查。
 ```

package/skills/devbooks-design-doc/SKILL.md

@@ -188,6 +188,43 @@ tools:
 
 ---
 
+## 下一步推荐
+
+**参考**：`skills/_shared/workflow-next-steps.md`
+
+完成 design-doc 后，下一步取决于变更范围：
+
+| 条件 | 下一个 Skill | 原因 |
+|------|--------------|------|
+| 有外部行为/契约变更 | `devbooks-spec-contract` | 必须先定义契约再做计划 |
+| 无外部契约变更 | `devbooks-implementation-plan` | 直接进入任务计划 |
+
+**关键**：绝不在 design-doc 后直接推荐 `devbooks-test-owner` 或 `devbooks-coder`。工作流顺序是：
+```
+design-doc → [spec-contract] → implementation-plan → test-owner → coder
+```
+
+### 输出模板
+
+完成 design-doc 后，输出：
+
+```markdown
+## 推荐的下一步
+
+**下一步：`devbooks-spec-contract`**（如果有外部行为/契约变更）
+或
+**下一步：`devbooks-implementation-plan`**（如果无外部契约变更）
+
+原因：设计已完成。下一步是[定义外部契约 / 创建实现计划]。
+
+### 如何调用
+```
+运行 devbooks-<skill-name> skill 处理变更 <change-id>
+```
+```
+
+---
+
 ## MCP 增强
 
 本 Skill 不依赖 MCP 服务，无需运行时检测。

package/skills/devbooks-impact-analysis/SKILL.md

@@ -130,6 +130,6 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 ```
 ⚠️ CKB 不可用，使用 Grep 文本搜索进行影响分析。
-分析结果可能不够精确，建议运行 devbooks-index-bootstrap skill 生成索引后重新分析。
+分析结果可能不够精确，建议手动生成 SCIP 索引后重新分析。
 ```