mcpField
N
no-comments

no-comments

github.com/ericlitman测试与质量53847 次安装1 周前更新
代码仓库

关于 no-comments

一项用于审查代码注释的技能：让 comment-sicko 子 Agent 检查指定文件或当前差异，并按规则筛选问题、实施修复和汇报未解决事项。

主要功能

  1. 01检查指定文件或当前差异
  2. 02委派 comment-sicko 子 Agent
  3. 03审核报告并筛除不合规发现
  4. 04修复确认的问题并汇报结果

适用场景

  1. 01审查当前分支差异中的注释
  2. 02按项目规则处理注释相关发现
  3. 03在 Codex 等非 Claude 环境中解析工具名称

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ericlitman/open-pstack --skill no-comments

安装后在 Claude Code 中输入/no-comments确认已加载。

详细介绍

不要留注释

启动 comment-sicko。处理已接受的发现。

尊重 comment-sicko 的全新视角。

平台说明。 在 Codex 或其他非 Claude 运行环境中，comment-sicko 子 Agent 和下方的 Claude 工具名称均为 Claude 默认值。请通过 codex-tools.md 解析它们。

范围

使用调用方提供的文件或 diff。否则，使用当前相对于基础分支（默认为 main）的 diff，包括工作树。

步骤

  1. 使用 subagent_type: "comment-sicko" 启动一个 Agent。传入范围。按照 poteto-mode 技能的 Subagents 部分，为每个子 Agent 选择合适的工作量。不要复述其规则。
  2. 检查其报告和 diff。拒绝应用代码编辑、超出范围的修改、受异常保护的删除、错误陈述的 MUST KILL 理由，以及将保留的有意代码视为问题的标记。针对我方代码意外情况的标记仍应可执行。不要还原那些注释。只有在有证据证明注释针对的是我们无法更改的内容时，才保留它。审查遗漏的、范围内的 lint 和 TypeScript 抑制项。正确性或安全性抑制项仍应作为可执行的 MUST KILL。只有在有明确例外和范围内证据时，才恢复已删除的注释。接受内容单薄的 IMPORTANT 或 do not remove 类 MUST KILL 或保留项前，先对其符号运行 /how 或 /why。如果某个 MUST KILL 含糊不清，不要恢复注释。如果某个保留项已被证伪或仍然含糊不清，就删除它。撤销并重跑一份被拒绝的报告，同时说明失败原因。拒绝第二份报告，将其列为未解决，并判定 /no-comments 失败。
  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 方案。等待交互式批准。无人值守和 eval 场景必须获得调用方预先批准。如果获批，则将约束编码后再删除。否则删除，并将约束报告为未解决，同时概述范围外工作。
  6. 报告删除数量、恢复的注释、重跑情况、Architect 方案草图、修复、编码提议、已编码内容、未强制执行的约束，以及其他未解决工作。

评论

支持 Markdown