SuperAPI AI 工具集

no-comments

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:该插件用于清理代码中不应保留的注释。它会调用名为 Comment Sicko 的子代理,先产出审查报告与 diff,再依据接受的结论执行删除或恢复,并针对声明为约束的注释提供编码方案。

范围:使用调用方指定的文件或 diff;未指定时使用相对基础分支(默认 main,含工作区)的当前 diff。

步骤:以 subagent_type 为 comment-sicko 生成 Task 并传入范围;依据 poteto-mode 技能的 Subagents 部分为任务选择推理级别与速度。检查报告与 diff,拒绝应用代码改动、越界改动、受异常保护的删除、误报的 MUST KILL 理由,以及把有意保留的代码当作有罪的标记。对薄弱的 IMPORTANT 或 do not remove 结论,可对其符号运行 /how 或 /why;歧义的 kill 不恢复,被反驳或仍歧义的 keep 删除。可回退并重跑一次被拒报告,第二次则上报并失败。

修复:简单接受的标记直接删除死路径、去掉参数或改用真实 API;需要设计时先运行 /architect 一次并停在草图阶段,第 4 步再实现。实施范围内最小根因修复,移除所有具名变通,若根因越界则落地最小范围内修复并上报其余未决。

约束注释:对 do not remove、不得改措辞、改动前需先沟通等约束,保留针对不可变对象的 keep;提供范围内最便宜的类型、运行时、测试或 CI lint 编码,等待交互批准;无人值守与 eval 需调用方预先批准。批准后编码并删除,否则删除、上报约束未决并勾勒越界工作。

报告:删除数量、恢复的注释、重跑、架构草图、修复、编码提议、已编码项、未强制约束及其他未决工作。限制:具体定价、平台支持和效果资料暂未提供。