关于 no-comments
这是 pstack 中用于审查代码注释的 skill，针对调用者指定的文件或当前差异开展检查，并处理已接受的问题。它将审查交给专门的子 Agent，并按严格规则筛选、修复和报告发现。
主要功能
- 01审查指定文件或差异中的注释
- 02委派给 comment-sicko 审查
- 03依据范围和代码核验发现
- 04修复已接受问题并报告未结事项
适用场景
- 01审查当前差异中的注释
- 02检查调用者指定文件集的注释
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/no-comments确认已加载。
详细介绍
无注释
在 Codex 上，遵循此技能前，请阅读平台映射，包括其中针对各技能的说明。
在 GitHub Copilot 上，遵循此技能前，请阅读平台映射，包括其中针对各技能的说明。
在 Muse 上，遵循此技能前，请阅读平台映射，包括其中针对各技能的说明。
启动 comment-sicko。处理已接受的问题。
尊重 comment-sicko 的全新视角。
范围
使用调用方提供的文件或差异。否则，使用当前相对于基准分支的差异，默认基准分支为 main，并包含工作树。
步骤
- 使用
subagent_type: "pstack:comment-sicko"启动Agent。传入范围。根据 poteto-mode 技能的 Subagents 部分，为每个子代理选择合适的推理级别。不要复述其规则。 - 检查其报告和差异。拒绝应用代码编辑、超出范围的改动、受异常保护的删除、错误陈述的
MUST KILL理由，以及把保留的有意代码视为有问题的标记。针对我们代码中意外情况的标记仍须具有可操作性。不要恢复那些注释。只有能证明注释所指内容是我们无法更改的事项时，才保留注释。审查遗漏的、范围内的 lint 和 TypeScript 抑制项。正确性或安全性抑制项仍须作为可操作的MUST KILL处理。只有在具备确切例外和范围内证据时才恢复删除项。接受内容单薄的IMPORTANT或do not remove类删除项或保留项之前，先对其符号运行/how或/why。如果删除理由含糊，不要恢复。如果保留项被反证或仍有歧义，就删除它。撤销一份被拒绝的报告，并注明失败原因后重新运行。第二次仍被拒绝时，报告该项未解决，并让/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