SuperAPI AI 工具集

no-comments

编程与开发

查看项目

更新于 10-16 02:02

技能介绍

用途

no-comments 是一个用于清理代码注释的技能,属于 hachej/boring-stack 技能集。它通过生成名为 Comment Sicko 的子代理,对代码中的注释进行审查,并对已接受的发现采取行动。

主要能力

  • 生成 Comment Sicko 子代理,传入作用域,由其提供全新视角的审查报告。
  • 审查报告和 diff,拒绝应用代码编辑、范围逃逸、异常保护的删除、错误陈述的 MUST KILL 理由,以及将保留的有意代码视为有罪的标记。
  • 对遗漏的作用域内 lint 和 TypeScript 抑制进行审计。
  • 对薄弱的 IMPORTANT 或“不要移除”的删除或保留,先运行 /how 或 /why 检查其符号。
  • 对已接受的标记进行直接修复,如删除死路径、丢弃参数或使用真实 API。
  • 若修复需要形态设计,运行 /architect 一次,仅停留在草图阶段。
  • 实现作用域内最小的根因修复,移除所有指定的变通方法。
  • 对约束注释提供最便宜的作用域内类型、运行时、测试或 CI lint 编码方案,等待交互式批准。

使用方式

使用调用者的文件或 diff;否则使用当前 diff 对比基础分支(默认 main),包括工作树。生成 Task,subagent_type 为 "Comment Sicko",传入作用域,不要重述其规则。

适用场景

适用于代码审查后需要清理注释、删除死代码、处理约束注释的场景。

限制

  • 拒绝应用代码编辑、范围逃逸、异常保护的删除等。
  • 不恢复那些注释。保留仅在有证据表明涉及无法更改的内容时才能存活。
  • 正确性或安全性抑制保持为可操作的 MUST KILL。
  • 仅在有精确异常和作用域证明时恢复删除。
  • 若删除有歧义,不恢复。若保留被反驳或仍有歧义,删除它。
  • 回退并重新运行一个被拒绝的报告,并指明失败原因。拒绝第二个,报告为开放,并使 /no-comments 失败。
  • 若根因超出作用域,落地最小的作用域内修复并报告其余为开放。
  • principle-fix-root-causes 和 principle-redesign-from-first-principles 技能仅指导意图,均不授权扩大围栏或修复围栏外的实例。
  • 绝不添加症状防护。
  • 无人值守和评估需要调用者预先批准。

报告内容

报告删除计数、恢复的注释、重新运行、架构草图、修复、编码提议、编码、未强制执行的约束以及其他开放工作。