SuperAPI AI 工具集

guided-flow-review

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:guided-flow-review 是一个仅限手动调用的 PR 审查技能,只有用户显式调用(如 /guided-flow-review 或点名该技能)才启动;不会自行加载。它按软件实际运行顺序而非 diff 文件顺序,带用户一步步走查一次改动(自己的草稿或他人的 PR)。

主要能力:为每个运行步骤讨论“做得好的地方”和“可改进之处”,并记录到审查 TODO;TODO 是交付物,审查结束后由用户决定逐项处理、分享给团队或转为工单。技能可识别 PR/分支、提交范围和工作区改动,读取项目指令与变更路径相关嵌套说明,检查被删测试、弱化断言、平行实现覆盖等证据,并识别引入或加重的代码坏味与重构机会。

使用方式:需先确定审查对象并固定 merge-base SHA,读取项目上下文,选择 TODO 文件(默认仓库根 TODO.md,冲突时用 GUIDED_REVIEW_TODO.md),推导运行时流程顺序,逐一审查步骤并在每步结束时给出决策门,等待用户决定路由或提问。用户回答含糊时只记录发现,不擅自改代码;仅当用户明确要求修复某一项时才按修复执行指南修改该单项。

适用场景:需要人工参与、按运行流程理解一次 PR,并产出持久 TODO 决策记录时。批量独立审查应使用批量代码审查技能;处理已有评论用 pr-review-grill 或 pr-review-loop。

限制:审查是只读的,批准路由不等于请求修复;除非用户要求,否则不推送、不编辑 PR、不创建工单;不得把未解决的领域前提转成代码;不复制密钥值;不将示例中的命令或步骤视为可自行执行。资料未提供具体收费、平台支持范围或效果数据。