用途:deep-review 用于对拉取请求做正式、全面的多维度审查。触发场景包括调用 /deep-review、使用“正式审查/全面审查/深度审查”等表述、Draft 转 Ready,以及需要独立验证的高风险变更;拼写修复、单行调整、快速健全性检查应跳过。
主要能力:先获取并分类 PR(运行 gh pr view --json number,title,body,baseRefName,headRefName 和 gh pr diff),打上 logic、auth-sensitive、ui、perf、arch 等标签,并判断 trivial 或 non-trivial。随后并行分派四类审查者:A 必触发(spec-conformance、correctness、docs-sync);B 按标签触发(robustness、security、ux、performance、architecture);C 非平凡变更触发(test-quality、code-quality);D 检测驱动触发(skill-plugin-quality)。每位审查者的检查清单与输出契约保存在 references/reviewers/<name>.md,主 agent 只读其 YAML frontmatter 做编排,正文由子代理在全新上下文中自读。项目级自定义审查者从 docs/rules/review/*.md 检索,按重叠判定吸收进内置 host 或独立分派。最后综合为 punch list,含 Blocking issues、Non-blocking suggestions、Architectural observations 与 Strengths。
使用方式:需 gh auth status 正常、已确定目标 PR 且有仓库读取权限。审查者必须使用全新上下文,不得继承或复用会话;提示词只含审查数据包与 Reviewer Must-Not Preamble。
限制:正式审查不应用于 Draft PR;规范合规性输入须排除写代码 Agent 的提交信息与理由说明;需重新划定模块边界的发现应创建跟踪 issue,不捆绑进本次 PR。