dev-playbooks-cn 1.7.1 → 1.7.3

package/README.md

@@ -164,7 +164,7 @@ DevBooks 使用两个目录根：
 **3. Review 阶段**
 
 ```
-请运行 devbooks-code-review skill，变更 ID：add-oauth2
+请运行 devbooks-reviewer skill，变更 ID：add-oauth2
 ```
 
 **4. Archive 阶段**
@@ -202,7 +202,7 @@ DevBooks 使用两个目录根：
 
 | Skill | 说明 |
 |-------|------|
-| `devbooks-code-review` | 代码评审（可读性/一致性） |
+| `devbooks-reviewer` | 代码评审（可读性/一致性） |
 | `devbooks-test-reviewer` | 测试质量与覆盖率评审 |
 
 ### Archive 阶段

package/bin/devbooks.js

@@ -1188,13 +1188,15 @@ function loadConfig(projectDir) {
   const content = fs.readFileSync(configPath, 'utf-8');
 
   // 解析 ai_tools
-  const toolsMatch = content.match(/ai_tools:\s*([\s\S]*?)(?=\n\w|\n$|$)/);
+  // 修复：使用更健壮的正则，匹配到下一个顶级 key（非缩进的行）或文件结尾
+  const toolsMatch = content.match(/ai_tools:\s*\n((?:[ \t]+-[ \t]+.+\n?)*)/);
   const tools = toolsMatch
     ? toolsMatch[1]
         .split('\n')
         .map(line => line.trim())
         .filter(line => line.startsWith('-'))
         .map(line => line.replace(/^-\s*/, '').trim())
+        .filter(line => line.length > 0)
     : [];
 
   // 解析 install_scope

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-playbooks-cn",
-  "version": "1.7.1",
+  "version": "1.7.3",
   "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

@@ -220,7 +220,7 @@ Skills 引用的共享资源（如 `_shared/references/`）位于 skills 全局
 
 ---
 
-## `devbooks-code-review`（Reviewer）
+## `devbooks-reviewer`（Reviewer）
 
 - 作用：以 Reviewer 角色做可读性/一致性/依赖健康/坏味道审查，只输出可执行建议，不讨论业务正确性。
 - **热点优先审查**：审查前调用 `mcp__ckb__getHotspots` 获取项目热点，按风险排序审查
@@ -232,7 +232,7 @@ Skills 引用的共享资源（如 `_shared/references/`）位于 skills 全局
   - 想发现耦合、依赖方向、复杂度、坏味道
 - 使用话术：
   ```text
-  你现在是 Reviewer。请点名使用 `devbooks-code-review`。
+  你现在是 Reviewer。请点名使用 `devbooks-reviewer`。
   请只做可读性/一致性/依赖健康度/坏味道审查，不讨论业务正确性；不改 tests/，不改设计。
   输入：本次变更涉及的代码 + `dev-playbooks/specs/**`（如需要项目画像/术语表/坑库）。
   输出：严重问题 / 可维护性风险 / 一致性建议 / 需要新增的质量闸门建议。

package/skills/Skill/345/274/200/345/217/221/346/214/207/345/215/227.md

@@ -18,7 +18,7 @@
 
 | Skill 类型 | 幂等性要求 | 示例 |
 |------------|------------|------|
-| **验证/检查类** | 必须幂等（不修改文件） | `change-check.sh`、`guardrail-check.sh`、`devbooks-code-review` |
+| **验证/检查类** | 必须幂等（不修改文件） | `change-check.sh`、`guardrail-check.sh`、`devbooks-reviewer` |
 | **生成类** | 必须明确"覆盖/增量"行为 | `change-scaffold.sh`、`devbooks-design-doc`、`devbooks-proposal-author` |
 | **修改类** | 必须可安全重跑 | `devbooks-archiver`、`devbooks-design-backport` |
 

package/skills/_shared/MCP/345/242/236/345/274/272/346/250/241/346/235/277.md

@@ -84,7 +84,7 @@
 | Skill | MCP 依赖 | 增强功能 |
 |-------|----------|----------|
 | devbooks-coder | mcp__ckb__getHotspots | 热点文件预警 |
-| devbooks-code-review | mcp__ckb__getHotspots | 热点文件高亮 |
+| devbooks-reviewer | mcp__ckb__getHotspots | 热点文件高亮 |
 | devbooks-impact-analysis | mcp__ckb__analyzeImpact, findReferences | 精确影响分析 |
 | devbooks-brownfield-bootstrap | mcp__ckb__* | COD 模型生成 |
 | devbooks-router | mcp__ckb__getStatus | 索引可用性检测 |

package/skills/_shared/references//345/201/217/347/246/273/346/243/200/346/265/213/344/270/216/350/267/257/347/224/261/345/215/217/350/256/256.md

@@ -124,7 +124,7 @@ deviation-log.md 是**持久化文件**，不受 compact 影响。即使对话
 | 当前 Skill | 完成状态 | 下一步 |
 |------------|----------|--------|
 | 任意 | COMPLETED_WITH_DEVIATION | `devbooks-design-backport` |
-| coder | COMPLETED | `devbooks-code-review` |
+| coder | COMPLETED | `devbooks-reviewer` |
 | coder | HANDOFF (测试问题) | `devbooks-test-owner` |
 | test-owner | COMPLETED | `devbooks-coder` |
 | test-owner | HANDOFF (设计问题) | `devbooks-design-backport` |

package/skills/_shared//345/267/245/344/275/234/346/265/201/344/270/213/344/270/200/346/255/245.md

@@ -44,9 +44,9 @@
 | `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-archiver` | 如果有 spec deltas |
-| `devbooks-code-review` | 归档完成 | 如果无 spec deltas |
+| `devbooks-coder` | `devbooks-reviewer` | 所有任务完成后 |
+| `devbooks-reviewer` | `devbooks-archiver` | 如果有 spec deltas |
+| `devbooks-reviewer` | 归档完成 | 如果无 spec deltas |
 | `devbooks-test-reviewer` | `devbooks-coder` | 如果发现测试问题，交回 |
 | `devbooks-design-backport` | `devbooks-implementation-plan` | 设计更新后重跑计划 |
 | `devbooks-archiver` | 归档完成 | 始终 |

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

@@ -163,7 +163,7 @@ allowed-tools:
 | 7 | Test-Red | `devbooks-test-owner` | devbooks-test-owner | verification.md + tests/ | ✅ |
 | 8 | Code | `devbooks-coder` | devbooks-coder | src/ 实现 | ✅ |
 | 9 | Test-Review | `devbooks-reviewer` | devbooks-test-reviewer | 测试评审意见 | ✅ |
-| 10 | Code-Review | `devbooks-reviewer` | devbooks-code-review | 代码评审意见 | ✅ |
+| 10 | Code-Review | `devbooks-reviewer` | devbooks-reviewer | 代码评审意见 | ✅ |
 | 11 | Green-Verify | `devbooks-test-owner` | devbooks-test-owner | evidence/green-final/ | ✅ |
 | 12 | Archive | `devbooks-archiver` | devbooks-archiver | 归档到 archive/ | ✅ |
 

package/skills/devbooks-delivery-workflow/references//344/272/244/344/273/230/351/252/214/346/224/266/345/267/245/344/275/234/346/265/201.md

@@ -229,7 +229,7 @@ change-check.sh <change-id> --mode strict --project-root "$(pwd)" --change-root
 - 运行本次范围内所有 A 类锚点（全套 tests + 静态检查 + build 校验）
 - 静态检查优先使用机器可读输出（json/xml），便于机械式修复与可追溯存档。
 - 执行 B/C 类：按 checklist 逐条勾选并记录证据（截图/录像/报表/签字）
-- 可读性/依赖/坏味道审查（Reviewer）：使用 `devbooks-code-review` Skill 输出审查意见
+- 可读性/依赖/坏味道审查（Reviewer）：使用 `devbooks-reviewer` Skill 输出审查意见
 
 ### Step 7：关账与沉淀（Close-out）
 

package/skills/devbooks-delivery-workflow/references//345/255/220Agent/350/260/203/347/224/250/350/247/204/350/214/203.md

@@ -27,7 +27,7 @@
 | 7 | devbooks-test-owner | "使用 devbooks-test-owner skill 为变更 [change-id] 编写测试并建立 Red 基线" |
 | 8 | devbooks-coder | "使用 devbooks-coder skill 为变更 [change-id] 实现功能" |
 | 9 | devbooks-reviewer | "使用 devbooks-test-reviewer skill 评审变更 [change-id] 的测试" |
-| 10 | devbooks-reviewer | "使用 devbooks-code-review skill 评审变更 [change-id] 的代码" |
+| 10 | devbooks-reviewer | "使用 devbooks-reviewer skill 评审变更 [change-id] 的代码" |
 | 11 | devbooks-test-owner | "使用 devbooks-test-owner skill 运行变更 [change-id] 的所有测试并收集 Green 证据" |
 | 12 | devbooks-archiver | "使用 devbooks-archiver skill 归档变更 [change-id]" |
 

package/skills/devbooks-entropy-monitor/SKILL.md

@@ -105,7 +105,7 @@ allowed-tools:
 
 | Skill | 关系 |
 |-------|------|
-| devbooks-code-review | 熵度量**不**嵌入每次 review，作为独立任务 |
+| devbooks-reviewer | 熵度量**不**嵌入每次 review，作为独立任务 |
 | devbooks-proposal-author | 熵报告可作为重构提案的数据支撑 |
 | devbooks-impact-analysis | 高熵区域变更需更谨慎的影响分析 |
 

package/skills/{devbooks-code-review → devbooks-reviewer}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: devbooks-code-review
-description: devbooks-code-review：以 Reviewer 角色做可读性/一致性/依赖健康/坏味道审查，只输出审查意见与可执行建议，不讨论业务正确性。用户说"帮我做代码评审/review 可维护性/坏味道/依赖风险/一致性建议"，或在 DevBooks apply 阶段以 reviewer 执行时使用。
+name: devbooks-reviewer
+description: devbooks-reviewer：以 Reviewer 角色做可读性/一致性/依赖健康/坏味道审查，只输出审查意见与可执行建议，不讨论业务正确性。用户说"帮我做代码评审/review 可维护性/坏味道/依赖风险/一致性建议"，或在 DevBooks apply 阶段以 reviewer 执行时使用。
 allowed-tools:
   - Glob
   - Grep

package/skills/{devbooks-code-review → devbooks-reviewer}/references//345/235/217/345/221/263/351/201/223/351/200/237/346/237/245/350/241/250.md

@@ -399,7 +399,7 @@ class PaymentService:
 - 《重构：改善既有代码的设计》(第2版) - Martin Fowler
 - 《架构整洁之道》- Robert C. Martin（第14章 组件耦合）
 - dev-playbooks 辩论修订版评估报告
-- devbooks-code-review 检查清单
+- devbooks-reviewer 检查清单
 
 ---
 

package/skills/devbooks-router/SKILL.md

@@ -68,7 +68,7 @@ fi
 
 **降级模式说明**：
 - 无索引时，`devbooks-impact-analysis` 退化为 Grep 文本搜索（准确度下降）
-- 无索引时，`devbooks-code-review` 无法获取调用图上下文
+- 无索引时，`devbooks-reviewer` 无法获取调用图上下文
 - 建议在 Apply 阶段前完成索引生成
 
 ## 你要做的事
@@ -228,7 +228,7 @@ LSC（大规模同质化修改）建议：
 触发信号：用户说"review/坏味道/可维护性/依赖风险/一致性"等。
 
 默认路由：
-- `devbooks-code-review`（输出可执行建议；不改业务结论、不改 tests）
+- `devbooks-reviewer`（输出可执行建议；不改业务结论、不改 tests）
 - `devbooks-test-reviewer`（评审测试质量、覆盖率、边界条件）
 
 ### D) Docs Sync（文档同步）

package/skills/devbooks-test-owner/SKILL.md

@@ -231,7 +231,7 @@ proposal → design → [TEST-OWNER] → [CODER] → [TEST-OWNER] → code-revie
 
 | 状态码 | 状态 | 判定条件 | 下一步 |
 |:------:|------|----------|--------|
-| ✅ | PHASE2_VERIFIED | 证据审计通过，AC 矩阵已打勾 | `devbooks-code-review` |
+| ✅ | PHASE2_VERIFIED | 证据审计通过，AC 矩阵已打勾 | `devbooks-reviewer` |
 | ⏳ | PHASE2_WAITING | @full 测试仍在运行 | 等待 CI 完成 |
 | ❌ | PHASE2_FAILED | @full 测试未通过 | 通知 Coder 修复 |
 | 🔄 | PHASE2_HANDOFF | 发现测试本身有问题 | 修复测试后重新验证 |

package/skills/devbooks-test-owner/references//351/230/266/346/256/2652/350/257/201/346/215/256/345/256/241/350/256/241/346/270/205/345/215/225.md

@@ -101,7 +101,7 @@ npm test -- --grep "@critical"
 
 | 状态码 | 状态 | 判定条件 | 下一步 |
 |:------:|------|----------|--------|
-| ✅ | PHASE2_VERIFIED | 证据审计通过，AC 矩阵已打勾 | `devbooks-code-review` |
+| ✅ | PHASE2_VERIFIED | 证据审计通过，AC 矩阵已打勾 | `devbooks-reviewer` |
 | ⏳ | PHASE2_WAITING | @full 测试仍在运行 | 等待 CI 完成 |
 | ❌ | PHASE2_FAILED | @full 测试未通过 | 通知 Coder 修复 |
 | 🔄 | PHASE2_HANDOFF | 发现测试本身有问题 | 修复测试后重新验证 |

package/templates/claude-agents/devbooks-reviewer.md

@@ -1,7 +1,7 @@
 ---
 name: devbooks-reviewer
 description: DevBooks Reviewer 子代理：执行代码评审和测试评审，输出可执行建议。
-skills: devbooks-code-review, devbooks-test-reviewer
+skills: devbooks-reviewer, devbooks-test-reviewer
 ---
 
 # DevBooks Reviewer 子代理

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

@@ -3,7 +3,7 @@ skill: multi-skill-combo
 skills:
   - devbooks-test-owner
   - devbooks-coder
-  - devbooks-code-review
+  - devbooks-reviewer
 ---
 
 # DevBooks: 应用变更（向后兼容）
@@ -23,7 +23,7 @@ $ARGUMENTS
 这是一个向后兼容命令，触发多 Skill 组合：
 1. devbooks-test-owner：创建验收测试
 2. devbooks-coder：实现功能代码
-3. devbooks-code-review：代码评审
+3. devbooks-reviewer：代码评审
 
 建议使用更精确的直达命令：
 - /devbooks:test - 验收测试

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

@@ -1,10 +1,10 @@
 ---
-skill: devbooks-code-review
+skill: devbooks-reviewer
 ---
 
 # DevBooks: 代码评审
 
-使用 devbooks-code-review 做可读性/一致性/依赖健康/坏味道审查。
+使用 devbooks-reviewer 做可读性/一致性/依赖健康/坏味道审查。
 
 ## 用法
 

package/templates/dev-playbooks/README.md

@@ -154,7 +154,7 @@ DevBooks 使用两个目录根：
 **3. Review 阶段**
 
 ```
-请运行 devbooks-code-review skill，变更 ID：add-oauth2
+请运行 devbooks-reviewer skill，变更 ID：add-oauth2
 ```
 
 **4. Archive 阶段**
@@ -192,7 +192,7 @@ DevBooks 使用两个目录根：
 
 | Skill | 说明 |
 |-------|------|
-| `devbooks-code-review` | 代码评审（可读性/一致性） |
+| `devbooks-reviewer` | 代码评审（可读性/一致性） |
 | `devbooks-test-reviewer` | 测试质量与覆盖率评审 |
 
 ### Archive 阶段

package/templates/dev-playbooks/docs/DevBooks/351/205/215/347/275/256/346/214/207/345/215/227.md

@@ -131,7 +131,7 @@ change_root: dev-playbooks/changes/ # 变更包目录根
 | Planner | `devbooks-implementation-plan` | `tasks.md` |
 | Test Owner | `devbooks-test-owner` | `verification.md` + `tests/` |
 | Coder | `devbooks-coder` | 按 tasks 实现（禁止改 tests） |
-| Reviewer | `devbooks-code-review` | 评审意见 |
+| Reviewer | `devbooks-reviewer` | 评审意见 |
 | Archiver | `devbooks-archiver` | 归档修剪 + C4 合并 |
 | Design Backport | `devbooks-design-backport` | 回写设计缺口 |
 
@@ -185,6 +185,6 @@ AI 可以根据用户意图自动选择 Skills：
 | 用户意图 | 自动路由 |
 |----------|----------|
 | "修 bug"、"定位问题" | `devbooks-impact-analysis` → `devbooks-coder` |
-| "重构"、"优化代码" | `devbooks-code-review` → `devbooks-coder` |
+| "重构"、"优化代码" | `devbooks-reviewer` → `devbooks-coder` |
 | "新功能"、"实现 XX" | `devbooks-router` → 输出闭环路线 |
 | "写测试"、"补测试" | `devbooks-test-owner` |

package/skills//346/270/220/350/277/233/346/212/253/351/234/262/346/224/271/350/277/233/345/273/272/350/256/256.md

@@ -1,143 +0,0 @@
-# DevBooks Skills 渐进披露改进建议
-
-## 问题诊断
-
-### 当前状态
-- ✅ 已采用多文件结构（SKILL.md + references/ + scripts/）
-- ⚠️ SKILL.md过长（最长633行，超出官方建议的500行）
-- ⚠️ 核心指令与详细规则混在一起
-
-### 官方最佳实践要求
-1. SKILL.md < 500行
-2. 核心信息在SKILL.md，详细参考在单独文件
-3. 引用保持一层深（SKILL.md → reference.md，不要 A → B → C）
-4. 脚本可执行但不加载到上下文
-
-## 改进方案
-
-### 方案1：拆分超长SKILL.md（推荐）
-
-**目标**：将633行的 `devbooks-test-owner/SKILL.md` 拆分为：
-
-```
-devbooks-test-owner/
-├── SKILL.md (< 200行)           # 概览 + 导航 + 核心流程
-├── references/
-│   ├── 测试驱动.md               # 已存在
-│   ├── 测试分层策略.md           # 已存在
-│   ├── 测试代码提示词.md         # 已存在
-│   ├── 禁令与规则.md             # 新增：从SKILL.md移出的详细规则
-│   ├── 测试模式与标签.md         # 新增：@smoke/@critical/@full详解
-│   └── 证据审计清单.md           # 新增：阶段2审计步骤详解
-└── scripts/
-    └── evidence-check.sh         # 可选：自动化证据检查脚本
-```
-
-**SKILL.md 精简后的结构**：
-```markdown
----
-name: devbooks-test-owner
-description: ...
----
-
-# DevBooks：测试负责人（Test Owner）
-
-## 快速开始（Quick Start）
-
-我的职责：
-1. 阶段1：编写测试 → 产出Red基线
-2. 阶段2：审计证据 → 勾选AC矩阵
-
-## 核心流程
-
-[保留最核心的流程图和步骤，约50-100行]
-
-## 详细参考（按需阅读）
-
-- **必读**：`~/.claude/skills/_shared/references/AI行为规范.md`
-- **禁令与规则**：`references/禁令与规则.md`（包含所有❌禁止项）
-- **测试方法论**：`references/测试驱动.md`
-- **测试分层**：`references/测试分层策略.md`
-- **完整提示词**：`references/测试代码提示词.md`
-- **证据审计**：`references/证据审计清单.md`（阶段2必读）
-
-## 常见场景
-
-[保留3-5个最常见的场景示例，每个<10行]
-
-## 自检清单
-
-- [ ] 阶段1：Red基线已产出？
-- [ ] 阶段2：@full测试已通过？
-- [ ] AC矩阵已勾选？
-```
-
-### 方案2：标准化引用格式
-
-在所有SKILL.md中统一使用以下格式：
-
-```markdown
-## 📚 参考文档
-
-### 必读（自动加载）
-- `~/.claude/skills/_shared/references/AI行为规范.md`
-
-### 按需阅读（需要时再读）
-- **方法论**：`references/测试驱动.md` - 完整TDD方法论
-- **分层策略**：`references/测试分层策略.md` - @smoke/@critical/@full详解
-- **详细规则**：`references/禁令与规则.md` - 所有禁止项和边界条件
-
-### 工具脚本（执行不加载）
-```bash
-# 检查证据完整性
-bash scripts/evidence-check.sh <change-id>
-```
-```
-
-### 方案3：增加"渐进披露检查"脚本
-
-创建一个脚本来检查所有skills是否符合渐进披露原则：
-
-```bash
-#!/bin/bash
-# scripts/check-progressive-disclosure.sh
-
-echo "检查 Skills 渐进披露合规性..."
-
-for skill in skills/devbooks-*/SKILL.md; do
-  lines=$(wc -l < "$skill")
-  skill_name=$(basename $(dirname "$skill"))
-
-  if [ "$lines" -gt 500 ]; then
-    echo "❌ $skill_name: $lines 行（超出建议的500行）"
-  elif [ "$lines" -gt 400 ]; then
-    echo "⚠️  $skill_name: $lines 行（接近上限）"
-  else
-    echo "✅ $skill_name: $lines 行"
-  fi
-done
-```
-
-## 实施优先级
-
-### P0（立即执行）
-1. 拆分 `devbooks-test-owner/SKILL.md`（633行 → <300行）
-2. 拆分 `devbooks-delivery-workflow/SKILL.md`（488行 → <300行）
-3. 拆分 `devbooks-coder/SKILL.md`（480行 → <300行）
-
-### P1（下个版本）
-1. 标准化所有skills的引用格式
-2. 为每个skill添加"快速开始"章节
-3. 创建渐进披露检查脚本
-
-### P2（持续优化）
-1. 监控SKILL.md行数，防止膨胀
-2. 定期审查references/目录结构
-3. 收集AI使用反馈，优化引用路径
-
-## 预期收益
-
-1. **性能提升**：SKILL.md更小 → 加载更快 → AI响应更快
-2. **上下文节省**：详细文档按需加载 → 节省token → 可以同时使用更多skills
-3. **可维护性**：职责清晰 → 更新更容易 → 减少冲突
-4. **用户体验**：快速开始 → 降低学习曲线 → 提高采用率