关于 no-comments
no-comments 是一项审查并删除代码注释的开发技能，面向维护代码库的 Agent。它要求评估发现、保留有依据的例外，并处理遗漏的 lint 与 TypeScript 抑制项。
主要功能
- 01按指定范围审查注释
- 02评估并处理审查发现
- 03检查 lint 与 TypeScript 抑制项
- 04修复已接受的问题并报告未解决项
适用场景
- 01清理代码 diff 中过时或不当的注释
- 02处理代码中的 lint 或 TypeScript 抑制项
- 03记录审查中保留的例外和未解决约束
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/no-comments确认已加载。
详细介绍
不留注释
启动 Comment Sicko。处理已接受的发现。
尊重 Comment Sicko 的全新视角。
范围
使用调用方的文件或 diff。否则，使用当前相对于基准分支的 diff；默认基准分支为 main，并包含工作树。
步骤
- 使用
subagent_type: "comment-sicko"启动Task。传入范围。根据 poteto-mode 技能的 Subagents 部分，为每个子代理选择适合任务的推理级别和快速或标准速度。不要复述其规则。 - 检查其报告和 diff。拒绝应用代码编辑、超出范围的修改、受例外保护的删除、错误陈述的
MUST KILL理由，以及把保留的有意代码判为有问题的标记。让针对本代码意外情况的标记保持可执行。不要恢复这些注释。只有在有证据证明注释涉及我们无法更改的内容时，才保留它。审查遗漏的、范围内的 lint 和 TypeScript 抑制。正确性或安全性方面的抑制仍应作为可执行的MUST KILL。只有在具备确切例外和范围内证据时才恢复删除。接受单薄的IMPORTANT或do not remove类 kill 或保留之前，先对其符号运行/how或/why。如果 kill 含糊不清，不要恢复。如果保留项被证伪或仍有歧义，就删除。撤销并重新运行一份被拒绝的报告，同时说明失败原因。若第二次仍被拒绝，则将其列为未解决，并让/no-comments失败。 - 直接修复琐碎的已接受标记：删除死代码路径、移除参数，或使用真实 API。如果任何修复需要设计方案，就针对已接受项及周边代码运行一次
/architect。停在草图阶段。由 Architect 设计方案。步骤 4 负责实施。 - 在范围内实施最小的根因修复。移除所有被点名的变通方案。如果根因超出范围，就提交最小的范围内修复，并将其余问题列为未解决。principle-fix-root-causes 和 principle-redesign-from-first-principles 技能仅用于指导意图。两者都不授权扩大范围，也不授权修复范围外的实例。切勿添加针对症状的防护。
- 约束类注释会写明
do not remove、do not change wording或talk to X before changing。对于涉及我们无法更改内容的保留项，予以保留。提出成本最低的范围内类型、运行时、测试或 CI lint 方案。等待交互式批准。无人值守和评估任务需要调用方预先批准。若获批准，先编码再删除；否则删除，并将该约束列为未解决，同时概述范围外的工作。 - 报告删除数量、恢复的注释、重新运行次数、Architect 草图、修复、编码提议、已编码项、未强制执行的约束，以及其他未解决工作。
评论
支持 Markdown