SuperAPI AI 工具集

no-comments

编程与开发

查看项目

更新于 10-15 21:38

技能介绍

用途:no-comments 用于清理代码中的注释与相关冗余代码。它启动名为 comment-sicko 的子代理,依据其报告和 diff 处理被接受的发现,删除死路径、多余参数,改用真实 API,并移除被点名的临时绕过方案。

主要能力:审查注释与 diff,拒绝应用代码编辑、范围外改动、受异常保护的删除、理由不实的 MUST KILL 标记,以及把有意保留的代码误判为有罪的标记。对遗漏的作用域内 lint 与 TypeScript 抑制进行审计,正确性或安全性抑制保持为可执行的 MUST KILL。对单薄的 IMPORTANT 或“请勿移除”判定,先运行 /how 或 /why 核实;含糊的 kill 不恢复,被驳倒或仍含糊的 keep 则删除。

使用方式:默认使用调用者的文件或 diff,否则使用相对基线分支(默认 main)的当前 diff,含工作区。启动 Agent 时传入 subagent_type: "comment-sicko" 并传递范围,不重述其规则。简单修复直接删除死路径、去掉参数或改用真实 API;若修复需要结构设计,先运行一次 /architect 得到草图,再由步骤 4 实现。约束注释(如“请勿移除”“请勿改措辞”“改动前先联系 X”)需提供最廉价的作用域内类型、运行时、测试或 CI lint 编码方案,等待交互式批准;无人值守与评测场景需调用方预先批准。批准后先编码再删除,否则删除并报告约束未决。

限制:在 Codex 等非 Claude 运行时,comment-sicko 子代理与相关 Claude 工具名是 Claude 默认值,需通过 codex-tools.md 解析。原则类技能仅指导意图,不授权扩大范围或修复范围外实例,也不得添加症状性防护。若根因超出范围,只落地最小范围内修复并报告其余未决。被拒绝的报告可带失败原因重跑一次,第二次拒绝则报告未决并使 /no-comments 失败。