SuperAPI AI 工具集

traiage-review

通用与其它

查看项目

更新于 10-16 01:35

技能介绍

用途:当代码库变更很多、人类评审时间有限时,Traiage Review 帮助评审者把注意力集中在最可能导致评审失败的文件上。它不试图找出所有需要关注的变更,而是从全部变更中构建一个可能引发问题的文件清单。

主要能力:该技能以编排者身份运行,自身不读取源文件、不做实现工作,只启动四个并行代理:change-story-agent、change-impact-agent、change-failure-agent、change-expectation-agent。每个代理独立给出需要关注的文件列表,其中 change-expectation-agent 还会给出声明式文件列表。编排者汇总各列表,从每个代理取前 5 个文件,去重后补足至 20 个;再通过 Python 脚本从全部变更文件中随机抽取 20 个,从中选出 5 个加入最终列表(忽略文档、测试、配置等非逻辑变更,除非无其他文件可选)。最终报告包括关键事实摘要、关键文件表、随机样本表和声明式文件表。

使用方式:技能支持三种评审模式,由传入参数或本地状态自动判断。传入 commit 参数时使用提交模式:若给出具体哈希则直接使用,否则用 git rev-parse HEAD 解析最新提交。传入 branch 参数时使用分支差异模式。否则检查本地变更:git status --porcelain 有输出则使用本地变更模式;无本地变更则检测默认分支,若当前分支不是默认分支则使用分支差异模式,若是默认分支则停止并报告无可比较内容。默认分支检测优先用 git symbolic-ref --short refs/remotes/origin/HEAD,失败则回退到 git rev-parse --verify origin/main 或 origin/master。分支模式使用 git diff origin/<default-branch>...HEAD(三点),提交模式使用 git show <commit-hash> 或 git diff <commit-hash>^!。随机抽样脚本按模式读取变更文件列表并随机选取。

限制:编排者只能运行只读命令,禁止读取源文件或执行任何变更类 git 命令(commit、stash、push、checkout、reset、revert、add、merge、rebase 等)。该技能不保证覆盖所有需要关注的变更,仅提供优先级参考。具体代理提示词、评分规则和输出格式的完整细节以产品资料为准,此处不展开。