SuperAPI AI 工具集

review-branch

编程与开发

查看项目

更新于 10-16 08:05

技能介绍

用途:作为技术负责人式的审查编排器,对当前分支的代码改动组织一次严格的多审查者评审,最终产出可执行的优先级行动计划,而非直接给出单点意见。

主要能力:审查团队分三层。第一层为角色型审查者(经 Moonbridge 并行运行):Grug 关注复杂度与过早抽象,Carmack 关注最简方案与可交付性,Ousterhout 关注模块深度与信息隐藏,Beck 关注 TDD 与行为测试,Fowler 关注代码坏味与重复。第二层为领域专家(经 Task 并行):security-sentinel 负责认证、注入、密钥与 OWASP,为强制项;performance-pathfinder 关注瓶颈、N+1 与扩展性;data-integrity-guardian 关注事务、迁移与引用完整性;architecture-guardian 关注模块边界与耦合。第三层为元审查:hindsight-reviewer 追问“从零开始是否仍会这样构建”,最后由编排者去重、解决冲突并校准严重度。

使用方式:先确定范围,执行 git diff --name-only $(git merge-base HEAD main)...HEAD 并获取完整 diff;随后并行启动第一、二层审查者;再将摘要交给 hindsight-reviewer;最后综合输出。严重度分为 Critical(安全漏洞、数据丢失、功能损坏,阻止合并)、Important(规范违反、缺少错误处理、性能问题,应在 PR 内修复)、Suggestion(风格与重构建议,可选)。输出包含行动计划、综合说明、共识发现、冲突解决与正面观察,原始输出放在可折叠详情中。提示词模板见 references/reviewer-prompts.md。

适用场景与限制:适合中小型 PR 的全面评审;小于 100 行时使用全部角色型审查者加 security-sentinel 及 1-2 名相关专家;大于 500 行时建议拆分。security-sentinel 在任何 PR 上均为强制;diff 中无迁移时可跳过 data-integrity-guardian 增强模式。完成后可生成可视化 HTML 摘要,写入 ~/.agent/diagrams/review-{branch}-{date}.html 并用 open 打开;会话过于简单、用户指定 --no-visual 或无浏览器(SSH)时跳过。其他细节暂未提供。