$npx -y skills add arch-team/devpace --skill pace-reviewUse when user says "review", "审核", "帮我看看", "代码审查", "提交审核", "Gate 2", "提交审批", "pace-review", or when a change request reaches in_review state. NOT for running tests or acceptance verification (use /pace-test).
| 1 | # /pace-review — 生成 Review 摘要 |
| 2 | |
| 3 | 为到达 in_review 状态的变更请求生成人类可读的审核摘要。追溯链展示至 Epic 层(CR→PF→BR→Epic→OBJ)。 |
| 4 | |
| 5 | ## 输入 |
| 6 | |
| 7 | $ARGUMENTS: |
| 8 | - (空)→ 处理所有 in_review 的 CR |
| 9 | - `<关键词>` → 指定特定变更 |
| 10 | |
| 11 | ## 流程 |
| 12 | |
| 13 | ### Step 1:识别待 review 的变更 |
| 14 | |
| 15 | 扫描 `.devpace/backlog/` 找状态为 in_review 的 CR 文件。 |
| 16 | |
| 17 | 如果没有 in_review 的 CR,按以下顺序做状态感知引导(用户不需要理解状态机): |
| 18 | 1. 有 `verifying` 状态的 CR → 提示"CR-xxx 正在验证中(Gate 2 自动检查),检查完成后会自动进入 Review。要先看看当前质量检查进度吗?" |
| 19 | 2. 只有 `developing` 状态的 CR → 提示"CR-xxx 还在开发中。需要先推进到 review 阶段吗?" |
| 20 | 3. 无活跃 CR → 告知用户当前没有待审查的变更 |
| 21 | |
| 22 | ### Step 2:确定 Review 模式并按需加载 |
| 23 | |
| 24 | 重要:根据 Review 模式和 CR 复杂度,仅读取对应的 procedures 文件,不加载全部规程。 |
| 25 | |
| 26 | **固定加载**: |
| 27 | |
| 28 | | 文件 | 说明 | |
| 29 | |------|------| |
| 30 | | `skills/pace-review/review-procedures-common.md` | 通用规则(始终加载) | |
| 31 | |
| 32 | **按 Review 模式和复杂度加载**: |
| 33 | |
| 34 | | 模式 | 条件 | 额外加载文件 | |
| 35 | |------|------|-------------| |
| 36 | | 中断恢复 | CR 验证证据有已生成摘要 + 代码无变更 | 无(仅用 common) | |
| 37 | | 增量 Review(S 级) | 打回历史 + S 级 | `skills/pace-review/review-procedures-delta.md`(自包含) | |
| 38 | | 增量 Review(M+ 级) | 打回历史 + M+ 级 | `skills/pace-review/review-procedures-delta.md` + `skills/pace-review/review-procedures-gate.md` | |
| 39 | | 全量 Review(S 级) | 首次 review,S 级 | 无(common 含 S 级格式) | |
| 40 | | 全量 Review(M+ 级) | 首次 review,M+ 级 | `skills/pace-review/review-procedures-gate.md` | |
| 41 | |
| 42 | **后续按需加载**: |
| 43 | |
| 44 | | 触发条件 | 加载文件 | |
| 45 | |---------|---------| |
| 46 | | 用户打回或给出修改意见 | `skills/pace-review/review-procedures-feedback.md`(自包含) | |
| 47 | |
| 48 | ### Step 3:生成摘要 |
| 49 | |
| 50 | 对每个待 review 的 CR 执行: |
| 51 | |
| 52 | 1. **交叉影响扫描**:检测多活跃 CR 间的文件/模块重叠 |
| 53 | 2. **意图一致性检查**:对比 CR 意图与 `git diff` 实际变更(简单 CR 跳过),含推理后缀 |
| 54 | 3. **业务追溯**:CR → PF → BR 完整价值链追溯 |
| 55 | 4. **对抗审查**:强制发现问题(M/L/XL),联动 accept 报告弱覆盖区域 |
| 56 | 5. **输出摘要**:按复杂度分级——S 微型 / M 标准 / L-XL 完整+TL;DR |
| 57 | 6. **持久化**:将摘要写入 CR 验证证据 section |
| 58 | |
| 59 | 详细操作步骤和摘要格式见已加载的 procedures 文件。 |
| 60 | |
| 61 | ### Step 4:等待人类决策 |
| 62 | |
| 63 | 处理人类回复(approved / 打回 / 修改意见 / 探索性问题),详细动作见已加载的 procedures 文件。 |
| 64 | |
| 65 | ## 输出 |
| 66 | |
| 67 | Review 摘要 + 等待用户决策。 |