SuperAPI AI 工具集

no-comments

编程与开发

查看项目

更新于 10-19 18:23

技能介绍

用途

no-comments 用于审计一定范围内的代码注释,并据此清理与修复。其核心设计是把“审查”和“修复”分开:先由独立的子代理角色 comment-sicko 做一次性审查,再由调用方对报告进行判断和修复,从而让审计具备第二双眼睛。

主要能力

  • 以 comment-sicko 角色对指定范围做独立审查,报告一次性返回,不需要轮询。
  • 对审查报告逐项判断,可驳回应用代码修改、范围越界、受异常保护的删除、MUST KILL 理由陈述不准确,以及把保留的有意代码误判为有罪的标记。
  • 对涉及“我们无法变更之物”的保留意见要求提供证据,模糊的删除不予恢复。
  • 补审报告中遗漏的 lint 与 TypeScript 抑制注释,正确性或安全性相关的抑制保持可执行的 MUST KILL。
  • 对证据单薄的 IMPORTANT 或“勿删”结论,先通过 fact-finder 角色核实符号(或自行阅读符号及其调用点)再判断。
  • 对驳回的报告可带失败原因重跑一次;第二次仍驳回则标记为未解决并终止本次运行。
  • 直接修复简单可接受项(删除死路径、去掉参数、改用真实 API 等);需要结构设计时,先就接受集与周边代码咨询 codebase-design 一次,仅停留在草图层面。
  • 在范围内实现最小的根因修复并移除所有点名的工作绕过;若根因在范围外,则落地最小的范围内修复并报告其余未解决项。
  • 处理约束型注释(勿删、勿改措辞、改前先联系某人):仅当其针对无法变更之物时保留,并提供最廉价的固化方式(类型、运行时检查、测试、CI lint),等待批准;获批则固化后删除,否则删除并报告约束未解决,同时给出范围外工作草图。
  • 最终报告删除数量、恢复的注释、重跑次数、设计草图、修复内容、固化提议、已固化的约束、未强制执行的约束及其他未完成工作。

使用方式

范围优先采用调用方提供的文件或 diff;否则使用相对基准分支(默认 main)的当前 diff,包含工作区改动。首次审查以 comment-sicko 角色和该范围作为任务,只传这些内容,调用为阻塞式,完整报告在一个结果中返回,且不重复其规则。随后按上述判断标准处理报告,必要时重跑、核实、修复。

适用场景

需要系统清理代码中过时、冗余或误导性注释,并区分哪些注释表达的是无法变更的约束、需要用代码或测试固化的场景。

限制

前置依赖为 pi-matt-subagent(子代理工具及内置的 comment-sicko、fact-finder 角色)。工具的具体实现细节、支持的平台与收费情况暂未提供。