dev-playbooks-cn 1.0.10 → 1.0.12

package/README.md

@@ -7,6 +7,8 @@
 [![npm](https://img.shields.io/npm/v/dev-playbooks-cn)](https://www.npmjs.com/package/dev-playbooks-cn)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
+![DevBooks 工作流](docs/workflow-diagram.svg)
+
 ---
 
 ## 为什么选择 DevBooks？
@@ -46,29 +48,6 @@ AI 编码助手很强大，但往往**不可预测**：
 
 ## 工作原理
 
-```
-                           DevBooks 工作流
-
-    PROPOSAL 阶段                  APPLY 阶段                     ARCHIVE 阶段
-    (禁止编码)                     (角色隔离强制)                  (质量闸门)
-
-    ┌─────────────────┐            ┌─────────────────┐            ┌─────────────────┐
-    │  /devbooks:     │            │   对话 A        │            │  /devbooks:     │
-    │   proposal      │            │  ┌───────────┐  │            │   gardener      │
-    │   impact        │────────────│  │Test Owner │  │────────────│   delivery      │
-    │   design        │            │  │(先跑 Red) │  │            │                 │
-    │   spec          │            │  └───────────┘  │            │  质量闸门:       │
-    │   plan          │            │                 │            │  ✓ Green 证据   │
-    └─────────────────┘            │   对话 B        │            │  ✓ 任务完成     │
-           │                       │  ┌───────────┐  │            │  ✓ 角色边界     │
-           ▼                       │  │  Coder    │  │            │  ✓ 无失败       │
-    ┌─────────────────┐            │  │(禁改测试!)│  │            └─────────────────┘
-    │ 三角对辩        │            │  └───────────┘  │
-    │ Author/Challenger│            └─────────────────┘
-    │ /Judge          │
-    └─────────────────┘
-```
-
 **核心约束**：Test Owner 与 Coder **必须在独立对话**中工作。这是硬性约束，不是建议。Coder 不能修改 `tests/**`，完成由测试/构建验证，而非 AI 自评。
 
 ---
@@ -77,19 +56,18 @@ AI 编码助手很强大，但往往**不可预测**：
 
 ### 支持的 AI 工具
 
-| 工具 | Slash 命令 | 自然语言 | 配置文件 |
-|------|-----------|----------|----------|
-| **Claude Code** | `/devbooks:*` | 支持 | `CLAUDE.md` |
-| **Codex CLI** | `/devbooks:*` | 支持 | `AGENTS.md` |
-| **Cursor** | - | 支持 | `.cursorrules` |
-| **Windsurf** | - | 支持 | `.windsurfrules` |
-| **Continue.dev** | - | 支持 | `.continuerules` |
-| **GitHub Copilot** | - | 支持 | `.github/copilot-instructions.md` |
-| **Gemini Code Assist** | - | 支持 | - |
-| **Aider** | - | 支持 | `.aider.conf.yml` |
-| **Cline** | - | 支持 | `.clinerules` |
+| 工具 | 支持级别 | 配置文件 |
+|------|----------|----------|
+| **Claude Code** | 完整 Skills | `CLAUDE.md` |
+| **Codex CLI** | 完整 Skills | `AGENTS.md` |
+| **Qoder** | 完整 Skills | `AGENTS.md` |
+| **Cursor** | Rules 系统 | `.cursor/rules/` |
+| **Windsurf** | Rules 系统 | `.windsurf/rules/` |
+| **Gemini CLI** | Rules 系统 | `GEMINI.md` |
+| **Continue** | Rules 系统 | `.continue/rules/` |
+| **GitHub Copilot** | 自定义指令 | `.github/copilot-instructions.md` |
 
-> **提示**：对于不支持 Slash 命令的工具，使用自然语言指令，例如："运行 DevBooks proposal skill..."
+> **提示**：使用自然语言调用 Skills，例如："运行 devbooks-proposal-author skill..."
 
 ### 安装与初始化
 
@@ -119,7 +97,7 @@ npx dev-playbooks-cn@latest init
 
 初始化后：
 - Claude Code：`~/.claude/skills/devbooks-*`
-- Codex CLI：`$CODEX_HOME/skills/devbooks-*`（默认 `~/.codex/skills/devbooks-*`）
+- Codex CLI：`~/.codex/skills/devbooks-*`
 
 ### 快速集成
 
@@ -130,7 +108,7 @@ DevBooks 使用两个目录根：
 | `<truth-root>` | 当前规格（只读真理） | `dev-playbooks/specs/` |
 | `<change-root>` | 变更包（工作区） | `dev-playbooks/changes/` |
 
-详见 `docs/DevBooks集成模板（协议无关）.md` 或使用 `docs/DevBooks安装提示词.md` 让 AI 自动配置。
+详见 `docs/DevBooks配置指南.md`。
 
 ---
 
@@ -138,20 +116,20 @@ DevBooks 使用两个目录根：
 
 ### 使用 Router（推荐）
 
+告诉 AI 你的需求，让 Router 分析并输出执行计划：
+
 ```
-/devbooks:router <你的需求>
+请运行 devbooks-router skill，分析需求：<你的需求>
 ```
 
-Router 分析需求并输出执行计划，告诉你下一步用哪个命令。
-
-### 直达命令
+### Skills 直达
 
 熟悉流程后，直接调用 Skill：
 
 **1. Proposal 阶段（禁止编码）**
 
 ```
-/devbooks:proposal 添加 OAuth2 用户认证
+请运行 devbooks-proposal-author skill，创建提案：添加 OAuth2 用户认证
 ```
 
 产物：`proposal.md`（必需）、`design.md`、`tasks.md`
@@ -162,10 +140,10 @@ Router 分析需求并输出执行计划，告诉你下一步用哪个命令。
 
 ```
 # 对话 A - Test Owner
-/devbooks:test add-oauth2
+请运行 devbooks-test-owner skill，变更 ID：add-oauth2
 
 # 对话 B - Coder
-/devbooks:code add-oauth2
+请运行 devbooks-coder skill，变更 ID：add-oauth2
 ```
 
 - Test Owner：写 `verification.md` + 测试，先跑 **Red**
@@ -174,64 +152,64 @@ Router 分析需求并输出执行计划，告诉你下一步用哪个命令。
 **3. Review 阶段**
 
 ```
-/devbooks:review add-oauth2
+请运行 devbooks-code-review skill，变更 ID：add-oauth2
 ```
 
 **4. Archive 阶段**
 
 ```
-/devbooks:gardener add-oauth2
+请运行 devbooks-spec-gardener skill，变更 ID：add-oauth2
 ```
 
 ---
 
-## 命令参考
+## Skills 参考
 
 ### Proposal 阶段
 
-| 命令 | Skill | 说明 |
-|------|-------|------|
-| `/devbooks:router` | devbooks-router | 智能路由到合适的 Skill |
-| `/devbooks:proposal` | devbooks-proposal-author | 创建变更提案 |
-| `/devbooks:impact` | devbooks-impact-analysis | 跨模块影响分析 |
-| `/devbooks:challenger` | devbooks-proposal-challenger | 质疑和挑战提案 |
-| `/devbooks:judge` | devbooks-proposal-judge | 裁决提案 |
-| `/devbooks:debate` | devbooks-proposal-debate-workflow | 三角对辩（Author/Challenger/Judge） |
-| `/devbooks:design` | devbooks-design-doc | 创建设计文档 |
-| `/devbooks:spec` | devbooks-spec-contract | 定义规格与契约 |
-| `/devbooks:c4` | devbooks-c4-map | 生成 C4 架构地图 |
-| `/devbooks:plan` | devbooks-implementation-plan | 创建实现计划 |
+| Skill | 说明 |
+|-------|------|
+| `devbooks-router` | 智能路由到合适的 Skill |
+| `devbooks-proposal-author` | 创建变更提案 |
+| `devbooks-impact-analysis` | 跨模块影响分析 |
+| `devbooks-proposal-challenger` | 质疑和挑战提案 |
+| `devbooks-proposal-judge` | 裁决提案 |
+| `devbooks-proposal-debate-workflow` | 三角对辩（Author/Challenger/Judge） |
+| `devbooks-design-doc` | 创建设计文档 |
+| `devbooks-spec-contract` | 定义规格与契约 |
+| `devbooks-c4-map` | 生成 C4 架构地图 |
+| `devbooks-implementation-plan` | 创建实现计划 |
 
 ### Apply 阶段
 
-| 命令 | Skill | 说明 |
-|------|-------|------|
-| `/devbooks:test` | devbooks-test-owner | Test Owner 角色（必须独立对话） |
-| `/devbooks:code` | devbooks-coder | Coder 角色（必须独立对话） |
-| `/devbooks:backport` | devbooks-design-backport | 回写发现到设计文档 |
+| Skill | 说明 |
+|-------|------|
+| `devbooks-test-owner` | Test Owner 角色（必须独立对话） |
+| `devbooks-coder` | Coder 角色（必须独立对话） |
+| `devbooks-design-backport` | 回写发现到设计文档 |
 
 ### Review 阶段
 
-| 命令 | Skill | 说明 |
-|------|-------|------|
-| `/devbooks:review` | devbooks-code-review | 代码评审（可读性/一致性） |
-| `/devbooks:test-review` | devbooks-test-reviewer | 测试质量与覆盖率评审 |
+| Skill | 说明 |
+|-------|------|
+| `devbooks-code-review` | 代码评审（可读性/一致性） |
+| `devbooks-test-reviewer` | 测试质量与覆盖率评审 |
 
 ### Archive 阶段
 
-| 命令 | Skill | 说明 |
-|------|-------|------|
-| `/devbooks:gardener` | devbooks-spec-gardener | 规格维护与去重 |
-| `/devbooks:delivery` | devbooks-delivery-workflow | 完整交付闭环 |
+| Skill | 说明 |
+|-------|------|
+| `devbooks-spec-gardener` | 规格维护与去重 |
+| `devbooks-delivery-workflow` | 完整交付闭环 |
 
 ### 独立技能
 
-| 命令 | Skill | 说明 |
-|------|-------|------|
-| `/devbooks:entropy` | devbooks-entropy-monitor | 系统熵度量 |
-| `/devbooks:federation` | devbooks-federation | 跨仓库联邦分析 |
-| `/devbooks:bootstrap` | devbooks-brownfield-bootstrap | 存量项目初始化 |
-| `/devbooks:index` | devbooks-index-bootstrap | 生成 SCIP 索引 |
+| Skill | 说明 |
+|-------|------|
+| `devbooks-entropy-monitor` | 系统熵度量 |
+| `devbooks-federation` | 跨仓库联邦分析 |
+| `devbooks-brownfield-bootstrap` | 存量项目初始化 |
+| `devbooks-index-bootstrap` | 生成 SCIP 索引 |
 
 ---
 
@@ -317,7 +295,7 @@ DevBooks 提供质量闸门拦截"伪完成"：
 | P0 跳过审批 | strict | P0 任务跳过必须有审批记录 |
 | 角色边界检查 | apply --role | Coder 不能改 tests/，Test Owner 不能改 src/ |
 
-核心脚本（位于 `skills/devbooks-delivery-workflow/scripts/`）：
+核心脚本（位于 `~/.claude/skills/devbooks-delivery-workflow/scripts/`）：
 - `change-check.sh --mode proposal|apply|archive|strict`
 - `handoff-check.sh` - 角色交接验证
 - `audit-scope.sh` - 全量审计扫描
@@ -337,7 +315,7 @@ DevBooks 提供质量闸门拦截"伪完成"：
 
 原型模式防止实验代码污染主源码树。
 
-脚本位于 `skills/devbooks-delivery-workflow/scripts/`。
+脚本位于 `~/.claude/skills/devbooks-delivery-workflow/scripts/`。
 
 </details>
 
@@ -353,22 +331,17 @@ DevBooks 跟踪四维系统熵：
 | 测试熵 | 测试覆盖率和质量衰减 |
 | 依赖熵 | 外部依赖健康度 |
 
-用 `/devbooks:entropy` 生成报告，识别重构机会。
+用 `devbooks-entropy-monitor` 生成报告，识别重构机会。
 
-脚本（位于 `skills/devbooks-entropy-monitor/scripts/`）：`entropy-measure.sh`、`entropy-report.sh`
+脚本（位于 `~/.claude/skills/devbooks-entropy-monitor/scripts/`）：`entropy-measure.sh`、`entropy-report.sh`
 
 </details>
 
 <details>
 <summary><strong>存量项目初始化</strong></summary>
 
-当 `<truth-root>` 为空时：
+当 `<truth-root>` 为空时，使用 `devbooks-brownfield-bootstrap` 生成：
 
-```
-/devbooks:bootstrap
-```
-
-生成：
 - 项目画像和术语表
 - 从现有代码生成基线规格
 - 最小验证锚点
@@ -380,24 +353,18 @@ DevBooks 跟踪四维系统熵：
 <details>
 <summary><strong>跨仓库联邦</strong></summary>
 
-多仓库分析：
-
-```
-/devbooks:federation
-```
-
-分析跨仓库边界的契约和依赖，支持协调变更。
+多仓库分析用 `devbooks-federation`，分析跨仓库边界的契约和依赖，支持协调变更。
 
 </details>
 
 <details>
 <summary><strong>MCP 自动检测</strong></summary>
 
-DevBooks Skills 支持 MCP（Model Context Protocol）优雅降级：在没有 MCP/CKB 的环境也能跑完整工作流；一旦检测到 CKB（Code Knowledge Base）可用，就自动启用图基能力，把“范围/引用/调用链”分析做得更准。
+DevBooks Skills 支持 MCP（Model Context Protocol）优雅降级：在没有 MCP/CKB 的环境也能跑完整工作流；一旦检测到 CKB（Code Knowledge Base）可用，就自动启用图基能力，把"范围/引用/调用链"分析做得更准。
 
 ### 它有什么用？
 
-- **影响分析更精确**：从“文件级猜测”升级到“符号级引用 + 调用图”，降低漏改风险
+- **影响分析更精确**：从"文件级猜测"升级到"符号级引用 + 调用图"，降低漏改风险
 - **审查更有重点**：自动拉取热点文件，优先关注高风险区域（技术债/高变动）
 - **大仓库更省心**：减少手动 Grep 的噪音与反复确认
 
@@ -405,27 +372,23 @@ DevBooks Skills 支持 MCP（Model Context Protocol）优雅降级：在没有 M
 
 | MCP 状态 | 行为 |
 |----------|------|
-| CKB 可用 | 增强模式：符号级影响分析/引用查找/调用图/热点（`mcp__ckb__analyzeImpact`、`mcp__ckb__findReferences`、`mcp__ckb__getCallGraph`、`mcp__ckb__getHotspots`） |
+| CKB 可用 | 增强模式：符号级影响分析/引用查找/调用图/热点 |
 | CKB 不可用 | 基础模式：Grep + Glob 文本搜索（功能完整，精度降低） |
 
 ### 自动检测
 
-- 需要 MCP 的 Skills 会先调用 `mcp__ckb__getStatus` 探测可用性（2s 超时）
+- 需要 MCP 的 Skills 会先探测可用性（2s 超时）
 - 超时/失败 → 静默降级到基础模式，不阻塞执行
-- 无需手动选择“基础/增强”模式
+- 无需手动选择"基础/增强"模式
 
-如需启用增强能力：按 `docs/推荐MCP.md` 配置 CKB，并运行 `/devbooks:index` 生成 `index.scip`。
+如需启用增强能力：按 `docs/推荐MCP.md` 配置 CKB，并运行 `devbooks-index-bootstrap` 生成 `index.scip`。
 
 </details>
 
 <details>
 <summary><strong>提案对辩工作流</strong></summary>
 
-严格提案审查用三角对辩：
-
-```
-/devbooks:debate
-```
+严格提案审查用三角对辩 `devbooks-proposal-debate-workflow`：
 
 三个角色：
 1. **Author**：创建并捍卫提案
@@ -438,26 +401,103 @@ DevBooks Skills 支持 MCP（Model Context Protocol）优雅降级：在没有 M
 
 ---
 
-## 仓库结构
+## 从其他框架迁移
+
+DevBooks 提供迁移脚本帮助从其他规格驱动开发工具迁移。
+
+### 从 OpenSpec 迁移
+
+如果你当前使用 [OpenSpec](https://github.com/Fission-AI/OpenSpec)，有 `openspec/` 目录：
+
+```bash
+# 使用 CLI（推荐）
+dev-playbooks-cn migrate --from openspec
+
+# 先预览变更
+dev-playbooks-cn migrate --from openspec --dry-run
+
+# 迁移后保留原目录
+dev-playbooks-cn migrate --from openspec --keep-old
+```
+
+**迁移内容：**
+- `openspec/specs/` → `dev-playbooks/specs/`
+- `openspec/changes/` → `dev-playbooks/changes/`
+- `openspec/project.md` → `dev-playbooks/project.md`
+- 所有路径引用自动更新
+
+### 从 GitHub spec-kit 迁移
+
+如果你使用 [GitHub spec-kit](https://github.com/github/spec-kit)，有 `specs/` 和 `memory/` 目录：
+
+```bash
+# 使用 CLI（推荐）
+dev-playbooks-cn migrate --from speckit
+
+# 先预览变更
+dev-playbooks-cn migrate --from speckit --dry-run
+
+# 迁移后保留原目录
+dev-playbooks-cn migrate --from speckit --keep-old
+```
+
+**映射规则：**
+
+| Spec-Kit | DevBooks |
+|----------|----------|
+| `memory/constitution.md` | `dev-playbooks/specs/_meta/constitution.md` |
+| `specs/[feature]/spec.md` | `changes/[feature]/design.md` |
+| `specs/[feature]/plan.md` | `changes/[feature]/proposal.md` |
+| `specs/[feature]/tasks.md` | `changes/[feature]/tasks.md` |
+| `specs/[feature]/quickstart.md` | `changes/[feature]/verification.md` |
+| `specs/[feature]/contracts/` | `changes/[feature]/specs/` |
+
+### 迁移功能
+
+两个迁移脚本都支持：
+
+- **幂等执行**：可安全多次运行
+- **断点续传**：中断后可从断点恢复
+- **试运行模式**：预览变更再执行
+- **自动备份**：原文件备份到 `.devbooks/backup/`
+- **引用更新**：文档中的路径引用自动更新
+
+### 迁移后步骤
+
+迁移后：
+
+1. 运行 `dev-playbooks-cn init` 设置 DevBooks Skills
+2. 检查 `dev-playbooks/` 中的迁移文件
+3. 更新 `verification.md` 文件的 AC 映射
+4. 如需基线规格，运行 `devbooks-brownfield-bootstrap`
+
+---
+
+## 目录结构
 
 ```
-skills/                    # devbooks-* Skills 源码（部分 Skill 自带 scripts/）
-templates/                 # 项目初始化模板（`dev-playbooks-cn init` 使用）
-templates/dev-playbooks/   # DevBooks 协议目录模板（初始化后写入项目为 `dev-playbooks/`）
-scripts/                   # 安装与辅助脚本
-docs/                      # 支持文档
-bin/                       # CLI 入口
+dev-playbooks/
+├── README.md              # 本文档
+├── constitution.md        # 项目宪法（GIP 原则）
+├── project.md             # 项目上下文（技术栈/约定）
+├── specs/                 # 当前规格（只读真理）
+│   ├── _meta/             # 元数据（术语表、项目画像）
+│   └── architecture/      # 架构规格（fitness-rules）
+├── changes/               # 变更包（工作区）
+├── scripts/               # 辅助脚本
+└── docs/                  # 文档
+    ├── workflow-diagram.svg   # 工作流程图
+    ├── 推荐MCP.md             # MCP 配置建议
+    └── DevBooks配置指南.md    # 配置指南
 ```
 
 ---
 
 ## 文档
 
-- [Slash 命令使用指南](docs/Slash 命令使用指南.md)
-- [Skills 使用说明](skills/Skills使用说明.md)
+- [工作流程图](docs/workflow-diagram.svg)
 - [MCP 配置建议](docs/推荐MCP.md)
-- [集成模板（协议无关）](docs/DevBooks集成模板（协议无关）.md)
-- [安装提示词](docs/DevBooks安装提示词.md)
+- [配置指南](docs/DevBooks配置指南.md)
 
 ---
 

package/bin/devbooks.js

@@ -427,14 +427,14 @@ ${DEVBOOKS_MARKERS.start}
 - Coder 禁止修改 tests/
 - 任何新功能/破坏性变更/架构改动：必须先创建 \`dev-playbooks/changes/<id>/\`
 
-## 工作流命令
+## 工作流 Skills
 
-| 命令 | 说明 |
+| Skill | 说明 |
 |------|------|
-| \`/devbooks:proposal\` | 创建变更提案 |
-| \`/devbooks:design\` | 创建设计文档 |
-| \`/devbooks:apply <role>\` | 执行实现 |
-| \`/devbooks:archive\` | 归档变更包 |
+| \`devbooks-proposal-author\` | 创建变更提案 |
+| \`devbooks-design-doc\` | 创建设计文档 |
+| \`devbooks-test-owner / devbooks-coder\` | 执行实现 |
+| \`devbooks-spec-gardener\` | 归档变更包 |
 
 ${DEVBOOKS_MARKERS.end}
 `;
@@ -545,14 +545,14 @@ function generateAgentsContent(filename) {
 - Test Owner 与 Coder 必须独立对话/独立实例；Coder 禁止修改 tests/。
 - 任何新功能/破坏性变更/架构改动：必须先创建 \`dev-playbooks/changes/<id>/\`。
 
-## 工作流命令
+## 工作流 Skills
 
-| 命令 | 说明 |
+| Skill | 说明 |
 |------|------|
-| \`/devbooks:proposal\` | 创建变更提案 |
-| \`/devbooks:design\` | 创建设计文档 |
-| \`/devbooks:apply <role>\` | 执行实现（test-owner/coder/reviewer） |
-| \`/devbooks:archive\` | 归档变更包 |
+| \`devbooks-proposal-author\` | 创建变更提案 |
+| \`devbooks-design-doc\` | 创建设计文档 |
+| \`devbooks-test-owner / devbooks-coder\` | 执行实现（test-owner/coder/reviewer） |
+| \`devbooks-spec-gardener\` | 归档变更包 |
 
 ${DEVBOOKS_MARKERS.end}
 `;

package/package.json

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

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

@@ -48,7 +48,7 @@
 
 ```
 ⚠️ CKB 不可用（超时或未配置），使用基础模式执行。
-如需启用增强功能，请运行 /devbooks:index 生成索引。
+如需启用增强功能，请运行 devbooks-index-bootstrap skill 生成索引。
 ```
 ```
 

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

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

package/skills/devbooks-c4-map/SKILL.md

@@ -146,6 +146,6 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 ```
 ⚠️ CKB 不可用，使用目录结构推断架构。
-生成的 C4 图可能不够精确，建议运行 /devbooks:index 生成索引。
+生成的 C4 图可能不够精确，建议运行 devbooks-index-bootstrap skill 生成索引。
 ```
 

package/skills/devbooks-coder/SKILL.md

@@ -214,6 +214,6 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 ```
 ⚠️ CKB 不可用，跳过热点检测。
-如需启用热点预警，请运行 /devbooks:index 生成索引。
+如需启用热点预警，请运行 devbooks-index-bootstrap skill 生成索引。
 ```
 

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

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

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

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

package/skills/devbooks-proposal-author/references//346/217/220/346/241/210/346/222/260/345/206/231/346/217/220/347/244/272/350/257/215.md

@@ -34,7 +34,7 @@
 
 设计性决策识别标准：
 以下类型的决策属于"设计性决策"，需要呈现给用户选择：
-- 命名风格（如 `/devbooks:*` vs `/db:*`）
+- 命名风格（如 skill 命名规范）
 - 目录结构组织方式
 - 技术栈选择（如 npm 包名策略）
 - 阶段划分方式

package/skills/devbooks-router/SKILL.md

@@ -119,16 +119,16 @@ impact_profile:
 ## 执行计划（基于 Impact 画像）
 
 ### 必须执行
-1. `/devbooks:proposal` → proposal.md（提案已存在，跳过）
-2. `/devbooks:design` → design.md（必须）
-3. `/devbooks:plan` → tasks.md（必须）
+1. `devbooks-proposal-author skill` → proposal.md（提案已存在，跳过）
+2. `devbooks-design-doc skill` → design.md（必须）
+3. `devbooks-implementation-plan skill` → tasks.md（必须）
 
 ### 建议执行（基于 Impact 分析）
-4. `/devbooks:spec` → specs/**（检测到 external_api: true）
-5. `/devbooks:c4` → architecture/c4.md（检测到 architecture_boundary: true）
+4. `devbooks-spec-contract skill` → specs/**（检测到 external_api: true）
+5. `devbooks-c4-map skill` → architecture/c4.md（检测到 architecture_boundary: true）
 
 ### 可选执行
-6. `/devbooks:impact` → 深度影响分析（affected_modules > 5）
+6. `devbooks-impact-analysis skill` → 深度影响分析（affected_modules > 5）
 ```
 
 ### 解析失败处理（AC-012）
@@ -143,13 +143,13 @@ impact_profile:
 - 或 impact_profile YAML 块缺失
 
 建议动作：
-1. 运行 `/devbooks:impact` 生成影响分析
-2. 或直接使用直达命令 `/devbooks:<skill>`
+1. 运行 `devbooks-impact-analysis skill` 生成影响分析
+2. 或直接使用相应 skill
 
-直达命令列表：
-- /devbooks:design → 设计文档
-- /devbooks:plan → 编码计划
-- /devbooks:spec → 规格定义
+skill 列表：
+- devbooks-design-doc skill → 设计文档
+- devbooks-implementation-plan skill → 编码计划
+- devbooks-spec-contract skill → 规格定义
 ```
 
 **YAML 解析失败时**：
@@ -161,7 +161,7 @@ impact_profile:
 
 建议动作：
 1. 检查 proposal.md 中 impact_profile YAML 格式
-2. 或使用直达命令 `/devbooks:<skill>` 绕过 Router
+2. 或直接使用相应 skill 绕过 Router
 ```
 
 ---
@@ -270,9 +270,9 @@ LSC（大规模同质化修改）建议：
 1. 记录学习到的关键洞察到 `proposal.md` 的 Decision Log
 2. 删除 `prototype/` 目录
 
-## DevBooks 命令适配
+## DevBooks Skill 适配
 
-DevBooks 使用 `/devbooks:proposal`、`/devbooks:apply`、`/devbooks:archive` 作为入口。
+DevBooks 使用 `devbooks-proposal-author skill`、`devbooks-test-owner/coder skill`、`devbooks-spec-gardener skill` 作为入口。
 按上述 A/B/C/D 路由即可，产物路径以项目指路牌里 `<truth-root>/<change-root>` 的映射为准。
 
 ---
@@ -326,7 +326,7 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 1. 调用 `mcp__ckb__getStatus`（2s 超时）
 2. 若 CKB 可用 → 在路由建议中标注"图基能力已激活"
-3. 若超时或失败 → 在路由建议中标注"图基能力降级"，建议运行 /devbooks:index
+3. 若超时或失败 → 在路由建议中标注"图基能力降级"，建议运行 devbooks-index-bootstrap skill
 
 ### 增强模式 vs 基础模式
 
@@ -342,5 +342,5 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 ```
 ⚠️ CKB 索引未激活，图基能力（影响分析、调用图等）将降级。
-建议运行 /devbooks:index 生成索引以启用完整功能。
+建议运行 devbooks-index-bootstrap skill 生成索引以启用完整功能。
 ```

package/skills/devbooks-spec-contract/SKILL.md

@@ -187,5 +187,5 @@ MCP 增强规则参考：`skills/_shared/mcp-enhancement-template.md`
 
 ```
 ⚠️ CKB 不可用，使用 Grep 文本搜索检测契约引用。
-结果可能不够精确，建议运行 /devbooks:index 生成索引。
+结果可能不够精确，建议运行 devbooks-index-bootstrap skill 生成索引。
 ```