SuperAPI AI 工具集

debt-finder

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:Debt Finder 作为侦察工具,在代码库中寻找一个具有实质影响的可维护性或设计债候选,并产出紧凑的提案。它不编辑产品代码、不启动重构、不创建分支或 PR,除非在技能之外被明确要求。默认不写文件,提案在最终回复中返回;仅在明确要求、将提案交给共识或实现流程,或保留无修复结果对后续运行有实质帮助时,才写入一个提案工件。

主要能力:先低成本阅读仓库的 AGENTS.md 或等价文件,必要时读取框架特定的分解技能,仅在所有权术语不清时读架构/设计文档。搜索预算偏向快速结构扫描:token/大小热点、广泛导入和路由/控制器形状文件、多状态桶/副作用/远程/模态工作流的组件、像隐藏页面控制器的响应式/模型文件、跨产品路径重复的领域逻辑、暴露痛苦设置或缺少隔离测试的测试、提到困惑或所有权漂移的工作日志。只对最强的一到三个候选深入阅读,一旦一个候选有足够证据就停止。

实质标准:候选需以具体方式让未来变更更难,至少满足两项:常规修复需读无关关注点;一个文件拥有多个独立状态机/工作流/证明面;行为由宽控制器、命令包、通用数据袋或对等组件内部协调;副作用同步本应派生的状态或缺乏明确所有权;重复领域逻辑带来漂移风险;缺少测试使面向用户的组件变更风险高;下一个代理/开发者可能把变更放错位置。不能仅因大小选择候选。

输出格式:提案包含候选、实质、证据(路径:行号)、边界契约(新/现有所有者、状态所有权、远程/变更所有权、事件/上下文)、非目标、证明面、被拒候选。若无候选达标,报告检查过的表面、最佳被拒候选及原因。

限制:只读侦察,不实现、不重构、不建分支或 PR;默认不写文件;不把文档查找当仪式;不因大小选候选。