SuperAPI AI 工具集

github-code-review

编程与开发

查看项目

更新于 11-09 16:18

技能介绍

用途\ngithub-code-review 用于在 GitHub 拉取请求流程中引入 AI 驱动的多代理审查。它不替代传统静态分析,而是通过 ruv-swarm 调度多个专门代理对 PR 差异与上下文做并行分析,并把结论回写到 PR。\n\n主要能力\n- 多代理审查系统:通过 npx ruv-swarm github review-init 指定 security、performance、style、architecture、accessibility 等代理,设置 --depth comprehensive 进行综合审查。\n- 专业化审查代理:安全代理检查注入、XSS、认证绕过、权限缺陷、加密弱点、依赖漏洞、密钥暴露、CORS 配置等,并可按严重程度决定请求修改或仅评论;性能代理分析算法复杂度、数据库查询效率、内存分配、缓存利用、网络请求与打包体积;架构代理检查设计模式、SOLID、DRY、依赖注入、分层违规与循环依赖;风格代理检查格式、命名、文档、注释、测试覆盖与错误处理,并可自动修复格式、导入与空白问题;另有无障碍代理与 i18n 相关能力。\n- 基于 PR 的蜂群管理:可通过 gh pr view 获取 body、title、labels 等,用 swarm create-from-pr、auto-spawn、init --from-pr-data 创建蜂群;支持按标签映射代理(如 bug、feature、refactor、docs、performance、security),并根据 PR 大小选择拓扑:小于 100 行用 ring,100–500 行用 mesh,大于 500 行用 hierarchical。\n- PR 评论命令:在 PR 评论中执行 /swarm init、/swarm spawn、/swarm status、/swarm review 等命令,需配合 Webhook 处理器调用 handle-comment。\n- 自动化工作流:提供 GitHub Actions 示例,在 PR 打开或同步时自动运行 review-all,并用 gh pr review 发布评论、批准或请求修改,按结果添加标签。\n- 评论生成与批量管理:review-comment 可按 constructive 风格生成带示例与修复建议的评论,再通过 gh api 创建内联评论;review-comments 支持按代理与严重程度分组、汇总并解决过时评论。\n- 质量门禁:quality-gates 可定义安全无严重问题、性能回归小于 5%、覆盖率不低于 80%、复杂度低于 10、重复率不高于 5% 等阈值;review-metrics 可导出指标。\n- 高级能力:review-context 加载相关 PR 并检查破坏性变更;review-learn 与 review-train 基于历史审查学习模式;review-batch 与 multi-pr 支持跨 PR 一致性检查与并行协调。\n- 自定义代理:可编写 JS 类实现 review 方法,检测 TODO 注释或 API 版本前缀等规则,再通过 register-agent 注册。\n- CI/CD 集成:可在构建流水线中运行 review-all 并包含构建结果;pr-fix 可对 lint、测试失败与格式问题提交修复并推送;pr-progress 可将进度以 Markdown 评论回写 PR。\n\n使用方式\n基本流程是:先用 gh 获取 PR 上下文与 diff,再调用 npx ruv-swarm github review-init 或对应子命令启动审查,最后用 gh pr comment、gh pr review 或 gh api 回写结果。仓库内可放置 .github/review-swarm.yml 配置必需与可选代理及阈值规则,也可在 .github/workflows 中配置自动审查工作流。\n\n适用场景\n适合需要在 GitHub PR 阶段同时从安全、性能、架构、风格与无障碍等角度获得系统化审查反馈的团队,尤其是希望将审查自动化接入 CI、用标签驱动代理选择、或对高风险目录(如 auth、payment、admin)设置强制审查的场景。\n\n限制\n资料未提供该技能的收费、价格、平台支持范围、运行性能或审查准确率等事实,这些内容暂未提供。实际可用性取决于 ruv-swarm 与 gh CLI 的环境配置,以及 GitHub 仓库权限;自定义代理和 Webhook 需要自行编写与部署。