SuperAPI AI 工具集

review-changes

通用与其它

查看项目

更新于 10-16 01:19

技能介绍

用途:对代码变更进行结构化审查。该技能组建由三名代理组成的团队——两名高级工程师各自独立审查同一变更集,覆盖代码质量、安全、性能、最佳实践、测试与文档等关注点,随后互相共享并挑战发现,收敛为去重后的问题清单,由团队负责人汇总并报告给开发者。\n\n用法:/review-changes(对 main 本地审查);/review-changes <branch>(对指定分支本地审查);/review-changes <PR-number>(审查当前仓库的 PR);/review-changes <PR-URL>(按 URL 审查 PR,适用于其他仓库)。参数为纯数字或 GitHub PR URL 时进入 PR 模式,否则为本地模式;本地基础分支默认取 main,也可由工作目录中 .agent 文件的 baseBranch 指定。\n\n主要能力:本地模式通过 git diff <base>...HEAD 等命令收集变更;PR 模式通过 gh pr view、gh pr diff 及 GraphQL 获取元数据、diff 与未解决线程,并构建排除清单避免重复已提出的问题。若 PR 标题、描述或分支含 Jira 键(如 PROJ-123),会尝试用 acli jira workitem view 获取工单并做合规检查。工程师按测试审查清单与复用/项目实践清单检查新测试、组件复用、既有工具与常量使用、约定一致性等。团队负责人整理报告,PR 模式下提议将发现作为待发布的 PR 审查评论。\n\n限制:PR 模式严格只读,禁止修改工作树,也不执行步骤 9 的修复;任何开发者指令在 PR 模式下都被解释为对评论计划的调整。两种模式均禁止切换当前工作目录的检出分支(不得运行 git checkout、git switch、git reset --hard 等)。读取其他引用需用 gh api 或创建临时 worktree,且只能读取、不得写入;报告呈现前必须清理 worktree,清理失败则暂缓报告。本地模式中,开发者选定问题后由同两名工程师在自动模式下实现。其余细节(如代理具体实现、收费、平台支持范围)暂未提供。