SuperAPI AI 工具集

no-comments

编程与开发

查看项目

更新于 10-15 22:12

技能介绍

用途:no-comments 用于在代码审查或重构中清理注释。它依据调用者的文件或 diff(否则使用相对默认分支 main 的当前 diff,含工作区)确定范围,然后委派 Comment Sicko 进行只读审查,再对接受的发现采取行动。

主要能力:通过 delegate_task(mode: "async")启动 Comment Sicko,其简报为 poteto-mode 技能 references/comment-sicko.md 的文本加上范围(文件路径或 diff 本身),并用 task_status 收取结果。审查报告本身不写文件,由调用方删除其指出的注释。流程会拒绝应用代码修改、范围越界、受异常保护的删除、理由不实的 MUST KILL,以及把有意保留的代码当作有罪的标记。对薄弱的 IMPORTANT 或 do not remove 判定,先对相关符号运行 /how 或 /why 再决定。

使用方式:对接受的标记,可直接删除死路径、去掉参数或改用真实 API 等小修复;若修复需要设计,运行一次 /architect 得到草图,再由后续步骤实现。实现最小根因修复并移除所有具名 workaround;根因超出范围时只落地范围内最小修复,其余报告为未决。约束类注释(do not remove、不要改措辞、改动前先联系某人)若涉及无法改动的内容则保留,并提供范围内最便宜的类型、运行时、测试或 CI lint 编码方案,需在会话中获得用户批准;无人值守运行需调用方预先批准。批准后先编码再删除,否则删除并把约束报告为未决。

限制:Comment Sicko 为只读,不写文件;不得恢复被删除的注释,除非有精确异常和范围内证明;不得扩大范围或修复范围外实例;不得添加症状性防护。若某次报告被拒,可带失败原因重跑一次,第二次被拒则报告为未决并使 /no-comments 失败。资料未提供具体安装命令、收费或平台信息。