Menu
多智能体深度代码审查技能。对单次 Commit/PR/模块执行 4+ 维度并行专项审查，合并去重后生成结构化修复任务与最终报告。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | zcode-review-deep |
| description | 多智能体深度代码审查技能。对单次 Commit/PR/模块执行 4+ 维度并行专项审查，合并去重后生成结构化修复任务与最终报告。 |
| argument-hint | [--mode commit|pr|module|frz] [--ref REF] [--base BASE] [--head HEAD] [--path PATH] [--frz-ref FRZ_REF] [--output-dir .cr-deep] |
| allowed-tools | ["Read","Write","Edit","Bash","Agent","AskUserQuestion"] |
多智能体深度代码审查技能。对单次 Commit/PR/模块执行多维度并行专项审查，合并去重后生成结构化修复任务与最终报告。
bmad-code-review（互补；bmad 用于快速扫描，deep 用于关键 PR）| 参数 | 必填 | 说明 |
|---|---|---|
--mode | 是 | 审查模式：commit / pr / module / frz |
--ref | 条件 | 提交哈希或分支名（commit 模式必填） |
--base | 条件 | PR 基分支（pr 模式必填） |
--head | 条件 | PR 头分支（pr 模式必填） |
--path | 条件 | 模块路径（module 模式必填） |
--frz-ref | 条件 | 冻结版本引用（frz 模式必填） |
--output-dir | 否 | 输出根目录，默认 .cr-deep |
| 产物 | 路径 | 说明 |
|---|---|---|
role-panel.json | {output_dir}/{batch_id}/role-panel.json | Agent 选择结果 |
batch-state.json | {output_dir}/{batch_id}/batch-state.json | 批次运行状态 |
reviews/ | {output_dir}/{batch_id}/reviews/{agent}-review.json | 各 Agent 审查结果 |
consolidated-review.json | {output_dir}/{batch_id}/consolidated-review.json | 合并后的问题清单 |
review-conflicts.json | {output_dir}/{batch_id}/review-conflicts.json | 冲突记录 |
review-consensus.json | {output_dir}/{batch_id}/review-consensus.json | 最终共识问题清单 |
fix-tasks.json | {output_dir}/{batch_id}/fix-tasks.json | 修复任务清单 |
final-report.md | {output_dir}/{batch_id}/final-report.md | 人工可读最终报告 |
| 退出码 | 含义 |
|---|---|
0 | 审查完成，无 P0 问题 |
1 | 审查完成，发现 P0 问题 |
2 | 参数错误或环境不满足 |
3 | 执行过程中发生异常 |
batch_id，创建输出目录，捕获输入快照role-panel.json{agent_id}-review.jsonconsolidated-review.json + review-conflicts.jsonreview-consensus.jsonfix-tasks.jsonfinal-report.md详细执行逻辑见下方
## Execution Protocol章节。
本技能采用协作式执行架构：
| 组件 | 职责 |
|---|---|
| 外层 AI Agent | 完整流程编排：参数解析、角色选择、并行审查、合并、报告生成 |
| validate.py | 输出产物的 JSON Schema 契约验证（可选，用于确保输出质量） |
注意：本技能是纯 SKILL.md 实现，所有流程逻辑由外层 AI Agent 执行。
validate.py仅用于验证输出产物是否符合 JSON Schema 契约。
所有输出产物必须符合以下 JSON Schema：
| 产物 | Schema | 说明 |
|---|---|---|
role-panel.json | role-panel.schema.json | Agent 选择结果 |
batch-state.json | batch-state.schema.json | 批次运行状态 |
reviews/{agent}-review.json | problem.schema.json | 各 Agent 审查结果 |
consolidated-review.json | problem.schema.json（数组） | 合并后的问题清单 |
review-conflicts.json | conflict.schema.json（数组） | 冲突记录 |
review-consensus.json | problem.schema.json（数组） | 最终共识问题清单 |
fix-tasks.json | fix-task.schema.json（数组） | 修复任务清单 |
{
"issue_id": "{batch_id}-{agent_id}-{severity}-{seq:03d}",
"severity": "P0 | P1 | P2 | P3",
"dimension": "如 C01-Consistency, C03-Logic",
"file": "相对文件路径",
"line_range": [10] 或 [10, 20],
"evidence": "精确代码片段（带行号）",
"description": "问题描述",
"found_by": ["agent_id1", "agent_id2"]
}
| 级别 | 含义 | 说明 |
|---|---|---|
| P0 | Blocker | 必须立即修复 |
| P1 | High | 应在合并前修复 |
| P2 | Medium | 建议修复 |
| P3 | Low | 可选修复 |
Initialize
batch_idRole Selection
role-panel.jsonParallel Review
{agent_id}-review.jsonMerge & Conflict Detection
consolidated-review.json + review-conflicts.jsonConsensus Build
review-consensus.jsonFix Task Generation
fix-tasks.jsonReport Synthesis
final-report.md{output_dir}/{batch_id}/
├── batch-state.json
├── role-panel.json
├── reviews/
│ ├── {agent1}-review.json
│ └── {agent2}-review.json
├── consolidated-review.json
├── review-conflicts.json
├── review-consensus.json
├── fix-tasks.json
└── final-report.md
使用 validate.py 验证输出产物是否符合 Schema 契约：
# 验证整个批次
python validate.py .cr-deep/CR-20260527-001
# 安装依赖
pip install jsonschema
| 坑点 | 影响 | 规避措施 |
|---|---|---|
| Agent 选择过少（<2） | 审查维度不足，深层缺陷漏检 | 变更 >100 行或涉及跨模块时至少启用 3 个 Agent |
| Moderator 合并时过度去重 | 不同位置相似问题被误判为同一问题，导致遗漏 | 合并规则要求 file + line_range 同时匹配才去重；保留 found_by 多 Agent 标记 |
| P0 问题缺乏代码证据 | 误报导致开发者信任下降，或漏报导致生产故障 | 强制 evidence 字段包含精确代码片段与行号；Moderator 二次校验 P0 证据链 |
| 输出产物未写入磁盘即中断 | 审查结果丢失，需重新运行，浪费 Token 与时间 | 每步完成后立即 Write 产物；batch-state.json 记录阶段状态，支持断点续跑 |
| 纯风格问题标记为 P0/P1 | 阻塞合并流程，降低团队效率 | 规则明确：P0/P1 仅限功能缺陷、安全漏洞、性能陷阱；风格问题最高 P2 |
在 Claude Code 中调用：
/zcode-review-deep --mode commit --ref HEAD~1
/zcode-review-deep --mode pr --base main --head feature/x
/zcode-review-deep --mode module --path src/services/order/
预期输出路径：
| 命令 | 预期输出目录 |
|---|---|
--mode commit --ref HEAD~1 | .cr-deep/CR-{YYYYMMDD}-{NNN}/ |
--mode pr --base main --head feature/x | .cr-deep/CR-{YYYYMMDD}-{NNN}/ |
--mode module --path src/services/order/ | .cr-deep/CR-{YYYYMMDD}-{NNN}/ |
Pre-SSOT 文档校验技能。6 大维度（商业/产品/UX/架构/测试/工程）+ 跨维度一致性，共 55 项检查。纯 LLM + 结构化输出架构，产出 BLOCK/WARN/PASS 诊断报告。
标准文档撰写引擎。根据用户输入撰写 16 种 SSOT 文档（PRD/Arch/API/UX/Tech/Test/Data/DDD/Skill/Adapter/Job/Business/Strategy/Review/Testset/UX-Prototype），自动填充必输章节、补充缺失内容、识别核心决策点和分歧点供用户确认，严格遵循 DOC-WRITING-GUIDE 和 ITERATION-DOCUMENT-CHECKLIST 完整性要求。
设计文档到实施任务转化引擎。输入 15+ 种设计文档（PRD/Arch/API/UX/Tech/Test/Data/DDD/...），源文档交叉一致性校验 → 内容整合 → 按最小可验收颗粒度拆分 Task → 交付前自动审核 → 产出独立 impl 文档 + 依赖 DAG + 交付报告。纯 LLM + 结构化输出架构。
多文档质量收敛流水线。Review 阶段采用 BMAD 多角色评审团（选角→并行评审→合并→讨论→共识/升级人类）。Fix/Verify 阶段不变。过程审计和结果报告由独立 Agent 从磁盘重建，无共享上下文。
通用评估引擎。对 skill 设计 / agent run / 文档 / 代码 diff / prompt 输出 / 多轮对话执行多视角、可重放、带证据链的评估，输出可被 CI 消费的 gate 结果。
Pre-SSOT 文档校验技能。6 大维度（商业/产品/UX/架构/测试/工程）+ 跨维度一致性，共 55 项检查。纯 LLM + 结构化输出架构，产出 BLOCK/WARN/PASS 诊断报告。