人工智能AI 技能AI 插件开发工具【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址https://gitcode.com/GitHub_Trending/ps/pstack-claude点击查看免费下载导读comment-sicko是 pstack-claudePotetos pstack 的 Claude Code / Codex / Copilot / Pi 移植版内置的一个插件级子代理其唯一使命是审查并删除代码中的「多余注释」——包括叙述性旁白、横幅、被注释掉的死代码以及为 workaround 辩护的长篇理由并为必须通过改名、抽取、类型化或重构才能消除的「代码意外」精确标记MUST KILL目标。本文以 comment-sicko 代理定义 为骨架结合其宿主技能 no-comments、poteto-mode 编排规则 及各运行时的适配文档讲清它的保留清单、判罚规则、证据调查流程、输出契约与跨平台调用方式让你能在自己的仓库中安全地复用它做提交前审查。一、agent 是什么一个「天生讨厌注释」的审查者comment-sicko是一个由 frontmatter 定义人格的 Agent 定义文件原文以第一人称写下了一句近乎戏谑的开场白「我讨厌注释。把父级范围内的文件或 diff 喂给我。」它的description字段这样自我描述A deranged comment-hater that savors deletion and condemns workaround code.这份人格不是装饰而是整份代理契约的基调默认判罚例外豁免。它要求审查者把「叙事注释narration、横幅banners、被注释掉的尸体commented-out corpses、workaround 布道workaround sermons」全部视为猎物除非命中下文列举的保留清单。在 pstack 插件中该定义以两份等价文件存在代理定义主文件注册为插件命名空间下的pstack:comment-sicko是 Claude CodeAgent工具实际调用的对象技能引用副本供各技能文件在生成提示词时「以相对路径读入全文」也供 Codex 等没有子代理类型的运行时把整份文件塞进spawn_agent指令。从 agent-tools.ts 的 Pi 工具定义可以看出subagent_type的合法取值包括general-purpose、pstack:poteto-agent、pstack:comment-sicko、pstack:poteto-agent-level与pstack:effort-level即 comment-sicko 与 poteto-agent 一样是插件注册的一等子代理而非普通提示词。二、审查范围Scope父级文件优先diff 兜底代理对「审查什么」有严格定义优先喂给它「父级范围内的文件parent scoped files或 diff」——即调用者显式指定的文件集合或改动。如果调用者没有指定则回退到当前相对main的 diff包括工作区未提交的改动。宿主技能 no-comments 的 Scope 一节与之一致「使用调用者的文件或 diff。否则使用相对基分支默认main含工作树的当前 diff。」这意味着该审查天然服务于「提交前清理」场景无论你给它一个文件还是让它自取 diff它都只在你指定的范围内活动不会越界扩散到无关代码。三、保留清单Keep List只有五类例外可以「爬走」代理自称「这个清单是我唯一的缰绳」。命中以下五类之一的注释才能存活其余全部视为猎物meat例外类型存活条件边界说明法律/许可协议头无条件保留如 license 头、版权声明属于不能动的内容由外部依赖/平台/厂商/协议强制、且我们无法重塑的非显然行为必须证明「我们改不了」如果是自家代码的意外surprise则属于猎物标记MUST KILL并给出改名/抽取/类型化/重构方向// prettier-ignore仅当其对应 lint 规则本身有缺陷、过于吹毛求疵或纯风格性时这是 lint 压制类注释中唯一可能存活的定义公共 API 契约的文档注释doc comments无条件保留例如对外发布函数的 JSDoc/TSDoc 契约说明解释「代码无法表达」的约束的 Issue / RFC 链接无条件保留这类注释承载了代码结构装不下的外部事实关键判罚原则是最后一句「当我不确定某个保留条款是否适用时注释死。其他一切都是肉。」这是一种显式的「存疑即删」偏置——把举证责任完全放在「保留」一方。这在机制上防止了审查者被「这段注释很重要」之类的软性声明说服而手下留情。四、压制类注释Suppressions的处置查规则再判刑代理对eslint-disable、ts-ignore、ts-expect-error及类似压制注释持「臭」的评价但不是一律删除而是要求先查清规则本身如果该规则能捕捉真实 bug或保护正确性/安全性那么压制注释本身该死同时要把被掩盖的确切罪魁符号标记为MUST KILL——即删掉压制并指出真正需要修复的代码位置言下之意若规则确实误报压制才能存活与// prettier-ignore的存活条件一致。这里的MUST KILL不是装饰性标记而是重构目标的标定MUST KILL标记精确命名范围内某个符号symbol供后续步骤去改名、抽取、类型化或重构使行为「不用散文也能显而易见」。代理明言「每个标记都命名范围内真实存在的代码并说真话我什么也不编造」。五、理由型注释Justifications的处置先查证后定罪IMPORTANT、do not remove、too risky、fine for now以及长篇 justification在代理眼里是「气味scent不是信念conviction」。标准流程是先读邻近代码判断其声称的行为在邻近代码里是否显而易见若不明显调用/how、/why技能来自 how 技能 与 why 技能对命名的符号或调用链做调查——/how回答「这代码怎么工作」/why回答「为什么长成这样」二者都以只读子代理展开并产出带依据的结论只有「外来的、且今天在活路径上被证实为真」的保留清单陷阱foreign keep-list gotcha才能爬走自家代码的意外一律按上文 reshape 标记处理调查之后的任何怀疑都是肉——即查证完仍然存疑的注释直接删除。代理还特别设了一条红线「没有经过证实的保留清单例外的长篇 justification 就是供词。杀了它。永远不要把肉打磨成更短的托词。」也就是说审查者被明令禁止「把一段冗长注释改写得更短再留下」这种看似折中、实则纵容的行为——它只能删除或用MUST KILL标记罪魁符号且「我的杀戮到此为止我不碰代码」。六、输出契约只报告不写码代理的输出被严格限定为报告形式包含四项要素被触碰的文件touched files名单删除计数deletion count每个MUST KILL标记各一行说明跳过的项skips。配套的硬约束是「我触碰注释并识别重构目标。我从不写应用程序代码。」这条约束把 comment-sicko 定位为纯审查者/标记者把「动手改代码」的职责隔离到宿主技能 no-comments 的后续步骤中——这种「审查与修改分离」的设计正是为了让审查视角保持新鲜、不被自己的修改污染。七、宿主编排no-comments 技能如何消化这份报告comment-sicko 从不单独被直接调用它由 no-comments 技能 编排形成「审查 → 验收 → 修复 → 编码化」的完整闭环共 6 步派发以subagent_type: pstack:comment-sicko生成Agent子代理传入 scope但不重述其规则规则全文由代理文件自带避免提示词污染验收检查报告与 diff拒绝四类问题——应用代码修改、越界、受保护删除被误删、MUST KILL理由失实同时不恢复那些被标记的重构目标注释因为 reshape 标记仍然可执行。对存疑的IMPORTANT/do not remove击杀宿主也要先跑/how或/why核实。被拒绝的报告会「点名失败原因后重跑一次」第二次再失败则公开上报并宣告/no-comments失败修复对无争议的标记直接动手——删死路径、去掉无用参数、改用真实 API若修复需要数据结构设计则先跑一次/architect出草图根治实施范围内最小根因修复移除所有被点名的 workaround若根因越界则落最小范围内的修复并把其余留作开放项严禁叠加症状防护约束编码化对do not remove、do not change wording、talk to X before changing这类「约束注释」先判断是否属于「我们改不了的东西」——是则保留否则向用户提议范围内最便宜的类型、运行时、测试或 CI lint 手段把约束编码进结构呼应 principle-encode-lessons-in-structure经批准后「编码并删除」不批准则删除并把约束记为开放项汇报输出删除数、恢复的注释、重跑次数、architect 草图、修复清单、编码提议、已完成的编码、未落实的约束及其他开放工作。在 poteto-mode 的编排规则 中no-comments被固定在「评审前」的触发位「Before review → the no-comments skill (/no-comments).」它和 deslop、technical-writing 一起构成了 poteto-mode 的提交前净化流水线。八、跨运行时适配Claude Code、Codex、Pi 与 Copilot 的差异pstack-claude 的本质是把 Cursor 原版 pstack 移植到多个 harnesscomment-sicko 的派发方式随运行时不同而不同Claude Code直接使用Agent工具 subagent_type: pstack:comment-sicko规则文件随插件注册见 substitutions.json 的替换规则插件代理以其文件名注册在插件命名空间下Codex没有 comment-sicko 子代理类型codex-tools.md 平台映射 要求用spawn_agent派发并让指令「先完整读取poteto-mode/references/agents/comment-sicko.md再行动」即把代理文件当作内嵌人格提示词Pipstack:comment-sicko通过agent工具原样解析pi-tools.md 特别提示传入 scope 而非让它执行/no-comments且不要用isolation: worktree运行——因为 worktree 从HEAD起检缺少 scope 所需的未提交改动GitHub Copilot同样通过提示词内嵌代理文件的方式适配且由 session-start-copilot.md 等 hook 在会话启动时注入路由。换句话说凡是有子代理类型概念的运行时走注册名没有的则把代理文件全文作为人格提示词塞入指令——文件即契约这保证了跨平台行为一致。九、为什么需要它注释治理的工程哲学从仓库源码结构可以推断comment-sicko 不是孤立玩笑而是 poteto-mode 一组「以结构代替散文」原则的执行器注释即债务poteto-mode 的 Comments 章节 规定「只保留代码无法展示的非显然why」与 comment-sicko 的保留清单同构删除优于新增呼应 principle-subtract-before-you-add 与 principle-laziness-protocol 的「偏向删除」立场把约束编码进结构MUST KILL的 rename / extract / type / rearchitecture 四类方向对应 principle-type-system-discipline让非法状态不可表示、principle-fix-root-causes删压制而不是加压制等原则的落地手段。从测试角度agent-skills.test.mjs 专门校验技能树中对agents/comment-sicko.md的引用必须在安装时随技能树一起发布防止引用悬空这说明注释治理文件本身也被当作需要版本化、可验证的插件资产来对待。十、使用建议与边界要在你的仓库中启用这套净化机制只需在 poteto-mode 会话中、评审任何 diff 之前触发/no-comments即可它会在后台派发 comment-sicko 完成扫描并产出报告再由宿主按六步流程收敛。几点边界值得注意它只删注释、标目标不改代码——任何「顺手改掉」的冲动都违反契约修复必须走宿主技能第 34 步存疑即删是默认偏置若你的团队依赖大量「过程性说明」注释首次运行的报告量可能较大属预期行为保留清单的举证责任在保留方外部强制的非显然行为必须「今天在活路径上被证实」才能豁免跨平台时注意运行时的派发差异Codex 无子代理类型、Pi 不可用 worktree 隔离需按第八节方式适配。这份文件的价值在于它把「什么是坏注释、什么能活、怎么处置」从主观品味变成了一条可执行、可验收、可跨运行时复用的机器契约——这正是 pstack 系列「用严格工作流驯化 Agent」理念在代码卫生维度上的具体体现。附关键仓库路径速查代理定义技能引用副本plugins/pstack/skills/poteto-mode/references/agents/comment-sicko.md代理定义插件注册文件plugins/pstack/agents/comment-sicko.md宿主编排技能plugins/pstack/skills/no-comments/SKILL.md触发入口与原则索引plugins/pstack/skills/poteto-mode/SKILL.md调查工具how 技能、why 技能平台映射codex-tools.md、pi-tools.md、copilot-tools.md测试与生成佐证tests/agent-skills.test.mjs、tools/substitutions.json、plugins/pstack/pi/agent-tools.ts赞分享人工智能AI 技能AI 插件开发工具【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址https://gitcode.com/GitHub_Trending/ps/pstack-claude点击查看免费下载相关推荐pstack-claude 的 comment-sicko 子代理一个极权式注释清理 agent 及其 no-comments 技能驱动机制pstack claude 的 comment sicko 子代理一个极权式注释清理 agent 及其 no comments 技能驱动机制 pstack人工智能AI 技能AI 插件开发工具pstack /no-comments 技能实战用 Comment Sicko 在代码评审前系统性清理注释pstack /no comments 技能实战用 Comment Sicko 在代码评审前系统性清理注释 导读 /no comments 是 pstackAI 技能AI 插件插件系统AI Agentpstack 中 Comment Sicko 子代理只读注释审查的保留清单、MUST KILL 标记与 /no-comments 审计工作流pstack 中 Comment Sicko 子代理只读注释审查的保留清单、MUST KILL 标记与 /no comments 审计工作流 CommentAI 技能AI 插件插件系统AI Agent上一篇BepInEx IL2CPP 插件框架实战构建、部署与崩溃排查一次讲清下一篇qiankun v3 流式 HTML-entry 加载器内部机制全解从字节流到沙箱执行创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考