mcpField
N
no-comments

no-comments

github.com/backnotprop测试与质量3.1k5.9k 次安装今天更新
代码仓库

关于 no-comments

no-comments 是 pstack 技能,用于审查指定文件或差异、删除判定为不必要的注释,并处理认可的问题。它强调核验审查报告并将修改限制在指定范围内。

主要功能

  1. 01审查指定文件或差异
  2. 02委派独立注释审查
  3. 03核验问题并重跑被拒报告
  4. 04删除认可的问题注释
  5. 05报告修复与未解决事项

适用场景

  1. 01审查工作树差异中的注释
  2. 02检查 lint 和 TypeScript 抑制项
  3. 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)的差异。

步骤

  1. 使用 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),就在重新检查范围时自行执行该提示词。
  2. 检查其报告和差异。拒绝应用代码编辑、超出范围的改动、受异常保护的删除、错误陈述的 MUST KILL 原因,以及将保留的有意代码误判为有问题的标记。让针对我们代码中意外情况的标记保持可操作。不要恢复这些注释。保留项只有在有证据证明其涉及我们无法更改的内容时才能成立。审查遗漏的范围内 lint 和 TypeScript 抑制项。正确性或安全性方面的抑制仍应作为可操作的 MUST KILL。只有在有精确例外和范围内证据时才恢复删除的内容。接受内容单薄的 IMPORTANT 或 do not remove 类 MUST KILL 或保留项之前,对其符号运行 /how 或 /why。如果某个 MUST KILL 存在歧义,不要恢复。如果某个保留项被证伪或仍有歧义,就删除它;但关于外部规则的 REVIEW 保留项除外,应保留到有人检查该规则为止,并报告为未解决。若拒绝某份报告,需注明失败原因,恢复并重新运行一次。如果重跑的报告也被拒绝,则只恢复其中被拒绝的问题,报告为未解决,并继续处理已接受的问题。
  3. 直接修复简单的已接受标记:删除无效路径、移除参数,或使用实际 API。如果任何修复需要确定结构,针对已接受问题及其周边代码运行一次 /architect。停留在方案阶段。结构设计由 Architect 负责,第 4 步负责实现。
  4. 在范围内实施最小的根因修复。移除所有被点名的变通方案。如果根因超出范围,则提交范围内的最小修复,并报告其余问题仍未解决。principle-fix-root-causes 和 principle-redesign-from-first-principles 技能仅用于指导意图。它们都不授权扩大边界,也不授权修复范围外的实例。绝不要附加症状防护措施。
  5. 约束注释会写明 do not remove、do not change wording 或 talk to X before changing。保留关于我们无法更改事项的保留项。提供成本最低的范围内类型、运行时、测试或 CI lint 方案。等待交互式批准。无人值守和评测场景必须事先获得调用方批准。如果获批,就将约束编码化,然后删除注释。否则删除注释,将该约束报告为未解决,并概述范围外的工作。
  6. 报告删除数量、恢复的注释、REVIEW 保留项、重跑次数、Architect 方案、修复、编码化提议、已编码约束、未强制执行的约束,以及其他未解决事项。

评论

支持 Markdown