SuperAPI AI 工具集

no-comments

编程与开发

查看项目

更新于 10-28 16:13

技能介绍

no-comments 是一个用于清理代码注释与注释型抑制标记的工作流技能,常见触发方式是执行 /no-comments。其核心做法是先由 Comment Sicko 子代理以全新视角给出报告与差异,再由主流程审查并落实被接受的发现。

用途与范围:默认使用调用方指定的文件或差异;若未指定,则使用相对基底分支(默认 main)的当前差异,包含工作树改动。派发时以 subagent_type: "comment-sicko" 启动任务并传入该范围,并按 poteto-mode 技能的 Subagents 部分选择推理级别与速度。若当前 harness 未注册 comment-sicko(例如除带 pstack 插件的 Cursor 之外的环境),改用通用子代理:Claude Code 中为 Agent(subagent_type: general-purpose),OpenCode 中为 task(subagent_type: general),Codex 中为 spawn_agent;其提示词为 references/comment-sicko.md 原文加范围。若 harness 没有子代理工具(如无扩展的 Pi),则以该提示词在全新一轮中自行检查范围。

审查与判定:检查报告与差异,拒绝应用代码改动、范围越界、异常保护删除、误述的 MUST KILL 原因,以及把有意保留代码当作违规的标记。对我们代码中的意外标记应改造成可执行形式;不得恢复这些注释。保留项只有在能证明涉及我们无法变更的事物时才成立。需审计被遗漏的范围内 lint 与 TypeScript 抑制;正确性或安全性抑制仍作为可执行的 MUST KILL。仅在给出确切异常与范围内证明时才恢复删除。对单薄的 IMPORTANT 或“请勿删除”处置,先对相关符号运行 /how 或 /why 再决定;删除不明确则不恢复,保留被反驳或仍不明确则删除。对一份被拒报告命名失败原因后回退并重跑一次;第二次被拒则报告为未决并使 /no-comments 失败。

修复方式:对简单的已接受标记直接修复,例如删除死路径、去掉参数或改用真实 API。若修复涉及结构调整,先对已接受集合及周边代码运行一次 /architect,只停在草图阶段,由后续步骤实现。实现范围内最小的根因修复,移除每个已点名的工作替代方案;若根因超出范围,落地最小的范围内修复并报告其余问题为未决。不要增添症状性防护。

约束处理:约束注释表达“不要删除”“不要改措辞”“修改前先与某人沟通”等含义。对涉及无法变更之物的保留项予以保留。提供成本最低的范围内类型、运行时、测试或 CI lint 编码方案,等待交互式批准;无人值守与评测场景需调用方预先批准。获准则编码后删除注释,否则删除注释、报告约束为未决并草拟范围外工作。

报告内容:删除数量、恢复的注释、重跑情况、架构草图、修复项、编码提议、已完成的编码、未执行的约束及其他未决工作。

限制:依赖子代理能力与相关技能(poteto-mode、/architect、/how、/why 等);无子代理工具的 harness 需自行执行提示词;过程中涉及人工或调用方批准,不能自动越过。适用场景为代码注释与抑制标记整理、清理临时绕过与症状补丁、审查与差异清理。