技能用途 no-comments 用于在指定文件或 diff 范围内,启动名为 Comment Sicko 的子代理,审查其针对代码注释的发现项,并决定是否接受、修复或拒绝这些发现。其命令式说明把它定位为“Spawn Comment Sicko. Act on accepted findings.”,并强调要尊重 Comment Sicko 的新鲜视角,而不是在调用时重述其规则。
作用范围 默认使用调用方传入的文件或 diff;如果没有传入,则使用当前工作区相对基础分支的 diff,基础分支默认为 main,并包含工作区改动。
主要流程与能力
- 以 subagent_type 为 "Comment Sicko" 启动 Task,并传入作用范围。
- 检查报告与 diff,拒绝以下情形:修改应用代码、范围越界、受异常保护的删除、MUST KILL 理由不实,以及把有意保留的代码标记为有问题的标记。对于“我们代码中的意外”类标记,应保持可操作,不应据此恢复注释。只有证明注释涉及无法改变的内容时,keep 才成立。
- 审计遗漏的范围内 lint 与 TypeScript 抑制项;正确性或安全性抑制保持为可操作的 MUST KILL。只有在存在精确异常与范围内证明时才恢复删除。
- 对单薄的 IMPORTANT、do not remove 类 kill 或 keep,在采纳前对其符号运行 /how 或 /why。kill 含义模糊时不恢复;keep 被反驳或仍模糊时删除。
- 对一份被拒绝的报告,还原并重跑一次,并指明失败原因;第二份仍被拒绝则报告为未决,并使 /no-comments 失败。
- 对简单的已接受发现项直接修复,例如删除死路径、去掉参数或改用真实 API;若修复涉及结构,针对已接受集合与周边代码运行一次 /architect,停在草图阶段,由后续步骤实现。
- 在范围内实施最小根因修复,移除每个具名 workaround;根因超出范围时,落地最小的范围内修复,其余报告为未决。相关原则技能只指导意图,不授权扩大范围或修复范围外实例,禁止附加症状性防护。
- 对约束注释(例如“不要移除”“不要改措辞”“改前先找 X”),保留涉及无法改变内容的 keep;提供最便宜的范围内类型、运行时、测试或 CI lint 编码方案,等待交互式批准;无人值守与 eval 需要调用方预先批准。批准后编码再删除;否则删除、报告约束未决,并勾勒范围外工作。
- 最终报告删除数量、恢复的注释、重跑、architect 草图、修复、编码提议、已编码项、未强制约束及其他未决工作。
使用方式与适用场景 该技能通过调用方传入文件或 diff 来使用,适合在代码审查或注释清理流程中,对注释删除与保留决策进行系统化复核。它要求遵循明确的接受与拒绝标准,并区分可修复、需架构草图、需约束编码等不同情形。
限制与暂未提供 资料未提供具体安装命令、依赖要求、平台支持、收费或价格信息,也未给出可直接运行的示例。该技能依赖 Comment Sicko 子代理、/architect、/how、/why 等相关能力,但资料未说明这些能力的实现方式与前置条件。