用途
no-comments 是 pstack-rex 技能集中的一个技能,主要用途是清理代码中不应保留的注释。它通过生成一个名为 Comment Sicko 的子代理(worker)来审查代码,并根据审查结果处理可接受的注释问题。
主要能力
- 生成 Comment Sicko 子代理,使用调用者的文件或 diff 作为审查范围;若未提供,则使用当前分支(默认 main)的 diff,包括工作树。
- 检查子代理的报告与 diff,拒绝应用代码编辑、范围越界、受异常保护的删除、错误陈述的 MUST KILL 理由,以及将保留的有意代码视为有罪的标记。
- 审计遗漏的作用域内 lint 与 TypeScript 抑制。正确性或安全性抑制保持为可执行的 MUST KILL。
- 对单薄的 IMPORTANT 或“不要移除”类 kill/keep,在符号上运行 /how 或 /why 进行验证。
- 直接修复可接受的简单标记,例如删除死路径、去掉参数或使用真实 API。
- 若修复需要结构设计,运行一次 /architect 为可接受集合及周边代码生成草图,但停在草图阶段。
- 实现作用域内最小的根因修复,移除所有具名 workaround。若根因超出范围,则落地最小的作用域内修复并报告其余未解决。
- 对约束性注释(如“不要移除”“不要改动措辞”“改动前先联系 X”),提供最廉价的作用域内类型、运行时、测试或 CI lint 编码方案,等待交互式批准;无人值守与 eval 场景需要调用者预先批准。若获批准则编码后删除,否则删除并报告约束未解决,并草拟超出范围的工作。
- 报告删除数量、恢复的注释、重跑、architect 草图、修复、编码提议、编码、未强制约束及其他未完成工作。
使用方式
该技能以 /no-comments 形式运行。技能中提到的其他技能(如 /how、/why、/architect)通过读取对应目录下的 SKILL.md 文件并遵循其内容来执行。大多数 pstack 技能仅限用户使用,因此技能工具无法加载它们。每个子代理都是 Rex worker pane,需按照 ../rex-subagents/SKILL.md 生成、等待和关闭,默认值位于 ../poteto-mode/SKILL.md 的 Subagents 部分。
适用场景
适用于需要清理代码注释、处理约束性注释、审计 lint 与 TypeScript 抑制,以及执行根因修复的代码审查或重构流程。
限制
- 不恢复被删除的注释,除非有证据表明其涉及无法更改的内容。
- 不扩大范围,也不修复范围外的实例。
- 不添加症状防护。
- 若 kill 存在歧义,不恢复;若 keep 被反驳或仍有歧义,则删除。
- 被拒绝的报告会在新 worker 中重跑一次,若再次被拒则报告为未解决并使 /no-comments 失败。
- 约束性注释的编码需要交互式批准,无人值守与 eval 场景需要调用者预先批准。
- 关于收费、价格、平台、效果等具体信息暂未提供。