SuperAPI AI 工具集

no-comments

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

用途:no-comments 用于审查并清理代码中的注释。它启动名为 comment-sicko 的子代理,对调用者指定的文件或 diff(默认是相对 main 分支的当前 diff,含工作区)进行审查,然后对接受的发现采取行动。

主要能力:审查报告与 diff,拒绝应用代码改动、范围外修改、受异常保护的删除、理由不实的 MUST KILL 标记,以及把有意保留的代码误判为有罪的标记。对遗漏的范围内 lint 与 TypeScript 抑制进行审计。对含糊的 kill 不恢复,对被反驳或仍含糊的 keep 予以删除。对琐碎问题直接修复,如删除死路径、去掉参数或改用真实 API;若修复需要设计,则运行 /architect 一次并停在草图阶段。实施范围内最小根因修复,移除所有具名 workaround;根因超出范围时只落地范围内最小修复并报告其余未决。

约束注释处理:对于写着“不要移除”“不要改措辞”或“改前先联系 X”的约束注释,保留那些涉及无法改变之事的 keep,并提供范围内最省成本的类型、运行时、测试或 CI lint 编码方案,等待交互式批准;无人值守与评测场景需调用方预先批准。批准后先编码再删除,否则删除并报告约束未决。

限制:在 Codex 等非 Claude 运行时,comment-sicko 子代理与相关 Claude 工具名是 Claude 默认值,需通过 codex-tools.md 解析。若报告被拒,会回退并重跑一次并指明失败原因;第二次被拒则报告未决并使 /no-comments 失败。最终报告删除数量、恢复的注释、重跑、架构草图、修复、编码提议、已编码项、未强制约束及其他未决工作。