关于 no-comments
no-comments 是 pstack 技能,用于审查指定文件或差异、删除判定为不必要的注释,并处理认可的问题。它强调核验审查报告并将修改限制在指定范围内。
主要功能
- 01审查指定文件或差异
- 02委派独立注释审查
- 03核验问题并重跑被拒报告
- 04删除认可的问题注释
- 05报告修复与未解决事项
适用场景
- 01审查工作树差异中的注释
- 02检查 lint 和 TypeScript 抑制项
- 03核实约束后删除注释
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ backnotprop/ pstack --skill no-comments安装后在 Claude Code 中输入/no-comments确认已加载。
附带文件references/comment-sicko.md
详细介绍
无注释
启动 Comment Sicko。处理已接受的问题。
听从 Comment Sicko 的全新视角。
范围
使用调用方提供的文件或差异。否则,使用当前工作树中相对于基准分支(默认为 main)的差异。
步骤
- 使用
subagent_type: "comment-sicko"启动Task。传入范围。根据 poteto-mode 技能的 Subagents 部分,为每个子代理选择合适的推理级别和快速或标准速度。不要复述其规则。如果你的运行环境未将 comment-sicko 注册为子代理(除带有 pstack 插件的 Cursor 外的任何运行环境),则改为启动通用子代理:在 Claude Code 中使用Agent(subagent_type: general-purpose),在 OpenCode 中使用task(subagent_type: general),在 Codex 中使用spawn_agent。其提示词应为references/comment-sicko.md的原文,然后附上范围。如果你的运行环境没有子代理工具(例如未安装扩展的 Pi),就在重新检查范围时自行执行该提示词。 - 检查其报告和差异。拒绝应用代码编辑、超出范围的改动、受异常保护的删除、错误陈述的
MUST KILL原因,以及将保留的有意代码误判为有问题的标记。让针对我们代码中意外情况的标记保持可操作。不要恢复这些注释。保留项只有在有证据证明其涉及我们无法更改的内容时才能成立。审查遗漏的范围内 lint 和 TypeScript 抑制项。正确性或安全性方面的抑制仍应作为可操作的MUST KILL。只有在有精确例外和范围内证据时才恢复删除的内容。接受内容单薄的IMPORTANT或do not remove类MUST KILL或保留项之前,对其符号运行/how或/why。如果某个MUST KILL存在歧义,不要恢复。如果某个保留项被证伪或仍有歧义,就删除它;但关于外部规则的REVIEW保留项除外,应保留到有人检查该规则为止,并报告为未解决。若拒绝某份报告,需注明失败原因,恢复并重新运行一次。如果重跑的报告也被拒绝,则只恢复其中被拒绝的问题,报告为未解决,并继续处理已接受的问题。 - 直接修复简单的已接受标记:删除无效路径、移除参数,或使用实际 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 方案。等待交互式批准。无人值守和评测场景必须事先获得调用方批准。如果获批,就将约束编码化,然后删除注释。否则删除注释,将该约束报告为未解决,并概述范围外的工作。 - 报告删除数量、恢复的注释、
REVIEW保留项、重跑次数、Architect 方案、修复、编码化提议、已编码约束、未强制执行的约束,以及其他未解决事项。
评论
支持 Markdown