dev-playbooks-cn 1.0.0

package/templates/claude-commands/devbooks/apply.md

@@ -0,0 +1,38 @@
+---
+skill: multi-role
+backward-compat: true
+---
+
+# /devbooks:apply
+
+**向后兼容命令**：执行 Apply 阶段（Test Owner 或 Coder）。
+
+## 用途
+
+此命令是向后兼容命令，保持与原有 `/devbooks:apply` 调用方式一致。
+
+## 新版本替代方案
+
+建议使用以下直达命令：
+
+| 角色 | 新命令 | 说明 |
+|------|--------|------|
+| Test Owner | `/devbooks:test` | 测试负责人，产出 verification.md |
+| Coder | `/devbooks:code` | 实现负责人，按 tasks.md 实现 |
+
+## 参数
+
+- `--role test-owner`：以 Test Owner 角色执行
+- `--role coder`：以 Coder 角色执行
+
+## 角色隔离
+
+Test Owner 和 Coder 必须在独立会话中执行。
+
+## 迁移说明
+
+```
+旧命令                    新命令
+/devbooks:apply --role test-owner  →  /devbooks:test
+/devbooks:apply --role coder       →  /devbooks:code
+```

package/templates/claude-commands/devbooks/archive.md

@@ -0,0 +1,33 @@
+---
+skill: devbooks-spec-gardener
+backward-compat: true
+---
+
+# /devbooks:archive
+
+**向后兼容命令**：执行归档阶段。
+
+## 用途
+
+此命令是向后兼容命令，保持与原有 `/devbooks:archive` 调用方式一致。
+
+内部调用 `devbooks-spec-gardener` Skill。
+
+## 新版本替代方案
+
+建议使用直达命令：
+
+```
+/devbooks:gardener
+```
+
+## 功能
+
+归档前修剪与维护 <truth-root>（去重合并/删除过时/目录整理/一致性修复），避免 specs 堆叠失控。
+
+## 迁移说明
+
+```
+旧命令             新命令
+/devbooks:archive  →  /devbooks:gardener
+```

package/templates/claude-commands/devbooks/backport.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-design-backport
+---
+
+# /devbooks:backport
+
+触发 Skill：`devbooks-design-backport`
+
+## 用途
+
+把实现过程中发现的新约束、冲突、缺口回写到 design.md，保持设计为黄金真理，并标注决策与影响。
+
+## 典型使用场景
+
+- 实现中发现设计遗漏或冲突
+- 需要更新设计文档以反映实际
+- 保持设计与实现的一致性
+
+请点名使用 `devbooks-design-backport` 执行相应任务。

package/templates/claude-commands/devbooks/bootstrap.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-brownfield-bootstrap
+---
+
+# /devbooks:bootstrap
+
+触发 Skill：`devbooks-brownfield-bootstrap`
+
+## 用途
+
+存量项目初始化：在当前真理目录为空时生成项目画像、术语表、基线规格与最小验证锚点，避免"边补 specs 边改行为"。
+
+## 典型使用场景
+
+- 老项目接入 DevBooks
+- 建立项目 glossary 和基线
+- 生成初始项目画像
+
+请点名使用 `devbooks-brownfield-bootstrap` 执行相应任务。

package/templates/claude-commands/devbooks/c4.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-c4-map
+---
+
+# /devbooks:c4
+
+触发 Skill：`devbooks-c4-map`
+
+## 用途
+
+维护/更新项目的 C4 架构地图（当前真理），并按变更输出 C4 Delta。
+
+## 典型使用场景
+
+- 画架构图或更新边界定义
+- 分析模块依赖方向
+- 记录架构变更的 Delta
+
+请点名使用 `devbooks-c4-map` 执行相应任务。

package/templates/claude-commands/devbooks/challenger.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-proposal-challenger
+---
+
+# /devbooks:challenger
+
+触发 Skill：`devbooks-proposal-challenger`
+
+## 用途
+
+对 proposal.md 发起质疑与查漏补缺，指出风险、遗漏、不一致并给结论。发现缺失的验收标准和未覆盖场景。
+
+## 典型使用场景
+
+- 提案撰写完成后需要质疑审查
+- 需要识别潜在风险和遗漏
+- 执行提案对辩流程中的 Challenger 角色
+
+请点名使用 `devbooks-proposal-challenger` 执行相应任务。

package/templates/claude-commands/devbooks/code.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-coder
+---
+
+# /devbooks:code
+
+触发 Skill：`devbooks-coder`
+
+## 用途
+
+以 Coder 角色严格按 tasks.md 实现功能并跑闸门，禁止修改 tests/，以测试/静态检查为唯一完成判据。
+
+## 典型使用场景
+
+- 按计划实现代码功能
+- 修复测试失败让闸门全绿
+- 断点续做（自动识别已完成任务）
+
+请点名使用 `devbooks-coder` 执行相应任务。

package/templates/claude-commands/devbooks/debate.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-proposal-debate-workflow
+---
+
+# /devbooks:debate
+
+触发 Skill：`devbooks-proposal-debate-workflow`
+
+## 用途
+
+在 proposal 阶段执行"提案-质疑-裁决"三角对辩流程，强制三角色隔离并写回 Decision Log。
+
+## 典型使用场景
+
+- 需要完整执行提案审核流程
+- 自动协调 Author、Challenger、Judge 三个角色
+- 确保决策过程有记录可追溯
+
+请点名使用 `devbooks-proposal-debate-workflow` 执行相应任务。

package/templates/claude-commands/devbooks/delivery.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-delivery-workflow
+---
+
+# /devbooks:delivery
+
+触发 Skill：`devbooks-delivery-workflow`
+
+## 用途
+
+把一次变更跑成可追溯闭环（Design→Plan→Trace→Verify→Implement→Archive），明确 DoD、追溯矩阵与角色隔离。
+
+## 典型使用场景
+
+- 需要完整的交付验收流程
+- 生成追溯矩阵和 DoD 检查
+- 确保变更包符合关账标准
+
+请点名使用 `devbooks-delivery-workflow` 执行相应任务。

package/templates/claude-commands/devbooks/design.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-design-doc
+---
+
+# /devbooks:design
+
+触发 Skill：`devbooks-design-doc`
+
+## 用途
+
+产出变更包的设计文档（design.md），只写 What/Constraints 与 AC-xxx，不写实现步骤。
+
+## 典型使用场景
+
+- 提案通过后需要详细设计
+- 定义验收标准和约束条件
+- 明确 C4 Delta 和架构影响
+
+请点名使用 `devbooks-design-doc` 执行相应任务。

package/templates/claude-commands/devbooks/entropy.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-entropy-monitor
+---
+
+# /devbooks:entropy
+
+触发 Skill：`devbooks-entropy-monitor`
+
+## 用途
+
+定期采集系统熵度量（结构熵/变更熵/测试熵/依赖熵），生成量化报告，当指标超阈值时建议重构。
+
+## 典型使用场景
+
+- 监控代码复杂度趋势
+- 识别需要重构的区域
+- 量化技术债务程度
+
+请点名使用 `devbooks-entropy-monitor` 执行相应任务。

package/templates/claude-commands/devbooks/federation.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-federation
+---
+
+# /devbooks:federation
+
+触发 Skill：`devbooks-federation`
+
+## 用途
+
+跨仓库联邦分析与契约同步。当变更涉及对外 API/契约、或需要分析跨仓库影响时使用。
+
+## 典型使用场景
+
+- 分析跨仓库影响
+- 同步上下游依赖契约
+- 多仓库协调变更
+
+请点名使用 `devbooks-federation` 执行相应任务。

package/templates/claude-commands/devbooks/gardener.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-spec-gardener
+---
+
+# /devbooks:gardener
+
+触发 Skill：`devbooks-spec-gardener`
+
+## 用途
+
+归档前修剪与维护 truth-root（去重合并、删除过时、目录整理、一致性修复），避免 specs 堆叠失控。
+
+## 典型使用场景
+
+- 变更包归档前的收尾清理
+- specs 目录需要去重和整理
+- 清理过时的规范文档
+
+请点名使用 `devbooks-spec-gardener` 执行相应任务。

package/templates/claude-commands/devbooks/impact.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-impact-analysis
+---
+
+# /devbooks:impact
+
+触发 Skill：`devbooks-impact-analysis`
+
+## 用途
+
+跨模块/跨文件/对外契约变更前做影响分析，产出可直接写入 proposal.md 的 Impact 部分。
+
+## 典型使用场景
+
+- 变更前评估影响范围
+- 识别受影响的模块和 API
+- 分析兼容性风险
+
+请点名使用 `devbooks-impact-analysis` 执行相应任务。

package/templates/claude-commands/devbooks/index.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-index-bootstrap
+---
+
+# /devbooks:index
+
+触发 Skill：`devbooks-index-bootstrap`
+
+## 用途
+
+自动检测项目语言栈并生成 SCIP 索引，激活图基代码理解能力。
+
+## 典型使用场景
+
+- 首次进入大型项目需要索引
+- CKB 报告索引缺失时
+- 更新代码后重建索引
+
+请点名使用 `devbooks-index-bootstrap` 执行相应任务。

package/templates/claude-commands/devbooks/judge.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-proposal-judge
+---
+
+# /devbooks:judge
+
+触发 Skill：`devbooks-proposal-judge`
+
+## 用途
+
+对 proposal 阶段进行裁决，输出 Approved/Revise/Rejected 并写回 proposal.md 的 Decision Log。
+
+## 典型使用场景
+
+- 提案对辩完成后需要最终裁决
+- 需要决定提案是否可以进入实现阶段
+- 记录决策理由和条件
+
+请点名使用 `devbooks-proposal-judge` 执行相应任务。

package/templates/claude-commands/devbooks/plan.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-implementation-plan
+---
+
+# /devbooks:plan
+
+触发 Skill：`devbooks-implementation-plan`
+
+## 用途
+
+从设计文档推导编码计划（tasks.md），输出可跟踪的主线计划、临时计划、断点区，并绑定验收锚点。
+
+## 典型使用场景
+
+- 设计完成后需要拆分实现任务
+- 需要可跟踪的里程碑和验收锚点
+- 规划并行和串行任务依赖
+
+请点名使用 `devbooks-implementation-plan` 执行相应任务。

package/templates/claude-commands/devbooks/proposal.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-proposal-author
+---
+
+# /devbooks:proposal
+
+触发 Skill：`devbooks-proposal-author`
+
+## 用途
+
+撰写变更提案（proposal.md），作为后续 Design/Spec/Plan 的入口。对设计性决策会呈现选项给用户选择。
+
+## 典型使用场景
+
+- 启动新的变更/功能开发
+- 需要分析为什么要改、改动范围、影响面
+- 坏味道重构需要立项时
+
+请点名使用 `devbooks-proposal-author` 执行相应任务。

package/templates/claude-commands/devbooks/quick.md

@@ -0,0 +1,42 @@
+---
+skill: multi-skill
+backward-compat: true
+---
+
+# /devbooks:quick
+
+**向后兼容命令**：快速模式（小变更）。
+
+## 用途
+
+此命令是向后兼容命令，保持与原有 `/devbooks:quick` 调用方式一致。
+
+适用于小型变更，跳过部分流程。
+
+## 新版本替代方案
+
+建议使用 Router 获取完整路由建议：
+
+```
+/devbooks:router
+```
+
+Router 会根据变更规模自动推荐最短路径。
+
+## 快速模式约束
+
+- 仅适用于单文件或少量文件变更
+- 不涉及对外 API 变更
+- 不涉及架构边界变更
+- 不涉及数据模型变更
+
+## 边界检查
+
+如果变更超出快速模式边界，会自动建议切换到完整流程。
+
+## 迁移说明
+
+```
+旧命令           新命令
+/devbooks:quick  →  /devbooks:router（会自动推荐快速路径）
+```

package/templates/claude-commands/devbooks/review.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-code-review
+---
+
+# /devbooks:review
+
+触发 Skill：`devbooks-code-review`
+
+## 用途
+
+以 Reviewer 角色做可读性/一致性/依赖健康/坏味道审查，只输出审查意见与可执行建议，不讨论业务正确性。
+
+## 典型使用场景
+
+- 代码实现完成后需要评审
+- 检查代码质量和一致性
+- 识别依赖风险和坏味道
+
+请点名使用 `devbooks-code-review` 执行相应任务。

package/templates/claude-commands/devbooks/router.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-router
+---
+
+# /devbooks:router
+
+触发 Skill：`devbooks-router`
+
+## 用途
+
+DevBooks 工作流路由与下一步建议。根据用户请求和当前变更包状态，推荐应使用的 Skill 并给出执行计划。
+
+## 典型使用场景
+
+- 不确定下一步应该做什么时
+- 需要了解当前变更包的阶段状态
+- 需要获取最短闭环路径建议
+
+请点名使用 `devbooks-router` 执行相应任务。

package/templates/claude-commands/devbooks/spec.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-spec-contract
+---
+
+# /devbooks:spec
+
+触发 Skill：`devbooks-spec-contract`
+
+## 用途
+
+定义对外行为规格与契约（Requirements/Scenarios/API/Schema/兼容策略/迁移），并建议或生成 contract tests。
+
+## 典型使用场景
+
+- 需要定义 API 或接口规格
+- 需要撰写行为场景（Given/When/Then）
+- 需要兼容性策略和迁移方案
+
+请点名使用 `devbooks-spec-contract` 执行相应任务。

package/templates/claude-commands/devbooks/test-review.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-test-reviewer
+---
+
+# /devbooks:test-review
+
+触发 Skill：`devbooks-test-reviewer`
+
+## 用途
+
+审查测试代码质量，检查测试覆盖率、测试隔离性、Mock 使用是否合理等。
+
+## 典型使用场景
+
+- 测试代码需要质量审查
+- 检查测试是否符合最佳实践
+- 验证测试覆盖是否充分
+
+请点名使用 `devbooks-test-reviewer` 执行相应任务。

package/templates/claude-commands/devbooks/test.md

@@ -0,0 +1,19 @@
+---
+skill: devbooks-test-owner
+---
+
+# /devbooks:test
+
+触发 Skill：`devbooks-test-owner`
+
+## 用途
+
+以 Test Owner 角色把设计/规格转成可执行验收测试与追溯文档（verification.md），强调与实现独立对话、先跑出 Red 基线。
+
+## 典型使用场景
+
+- 需要从规格生成测试用例
+- 建立追溯矩阵（AC 到测试）
+- 生成 Red-Green 基线测试
+
+请点名使用 `devbooks-test-owner` 执行相应任务。