SuperAPI AI 工具集

review-debt

智能体与模型

查看项目

更新于 10-15 21:56

技能介绍

用途:这是 agentic-workflow 评审包中的内部技术债转换环节,由 review-change / product-audit 在其对话中组合调用,作为被路由的步骤内联执行。它只产出发现,从不编辑、从不重构。

主要能力:针对调用方已合成的发现表(融合、分类后的决策表)进行转换,不重新扫描 diff。把表中技术债形态的行——TODO/FIXME/HACK、重复代码、过时或孤立抽象、死代码、复杂度热点、缺失测试、绑定上游修复的临时方案——转为明确、可偿还的债务项:按 file:line 重述并说明其推迟了什么;归属到表中已记录的轴,不重新争论归属;确认每项都带 TRIGGER(必须偿还的条件,如“出现第 3 个消费者”“超过 10 万行”),无触发条件的债务项本身即为发现;核查当前单元债务未被误标为非阻塞(当前单元工作不能 postpone/tradeoff/wontfix,出现即回退给分类器,不在此重新分类);遵守死代码例外:对照 roadmap/SPEC/TASKS 的暂存/计划代码不算死代码,不确定时标 verify,绝不武断。

使用方式:在调用方对话中内联遵循该文件作为路由步骤。返回固定格式块:REVIEW TECH DEBT — scope: <scope>,随后是表格(#、Finding、Sev、Evidence、Suggested fix),Suggested fix 列同时携带 TRIGGER 与最小动作;再给出 Rows 统计、Summary 与 Decision(PASS/FAIL)。任何 critical 或 major 发现未关闭则 FAIL,否则 PASS;minor 不阻塞,作为债务备注出现在调用方报告中。

适用场景:已由 review-change / product-audit 合成发现表、需要把技术债条目显式化并附触发条件的评审流程。

限制:不重新扫描 diff,不重新判定归属,不修改代码;当前单元债务不得被标为非阻塞;死代码需对照 roadmap/SPEC/TASKS 判断。完成条件为:每条债务形态行都已带证据转换或明确标 n/a 并说明原因,每项都带触发条件,且仅返回上述固定格式块。