SuperAPI AI 工具集

review-order

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

用途:review-order 用于在人工审查代码前,把分支相对基线分支的改动整理成一份可快速浏览的“地图”。它不执行评审、不提建议、不标记待确认项,只做描述性整理,帮助用户自己决定要看什么。

主要能力:解析参数作为对比的基线分支,为空时默认 main;运行 git diff <base>...HEAD 与 git diff --name-status <base>...HEAD 获取改动;读取变更文件并归类;把差异按功能变更分组,每个功能内按四遍顺序组织:类型与接口、数据流、业务逻辑、边界情况。每条要点都带 file:line,便于直接点击跳转;无对应行号的功能级说明放在功能标题下的一句话介绍中。

使用方式:以基线分支作为参数调用该技能,例如传入分支名;未传参时默认对比 main。输出为 Markdown 文档,按影响范围排序,安全/认证相关优先,重构最后。功能分组依据包括:新增模型/迁移通常锚定一个功能,新增路由+控制器+页面通常是一个功能,新增通知类+触发+邮件模板是一个功能,既有流程新增副作用算独立小功能,纯重构可归为末尾的 Refactor。

适用场景:分支或 diff 的审查准备、需要按功能而非按文件层理解改动、希望快速定位类型定义、数据流向、逻辑分支与边界情况位置时。

限制:不进行评审、不提出修复或测试建议、不提问;每条要点必须带 file:line;每条要点保持简短单句;不使用表情符号;跳过锁文件、编译产物、生成的路由/类型定义等自动生成文件,除非其中出现意外内容;同一功能内同一行只出现一次;若某遍无内容则省略该节;若无改动则告知用户并停止。具体安装方式与调用命令在资料中暂未提供。