尧图网站建设 
pstack的注释哲学no-comments技能与注释规则深度解析【免费下载链接】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-claudepstack 是把 Poteto 的严格 Agent 工作流移植到 Claude Code、Codex、Pi 等平台上的技能栈。它最有争议也最有趣的设计是no-comments 技能一套默认有罪推定的注释规则——注释先被删少数类型才配活下来。本文带你读懂 no-comments 技能、comment-sicko 子代理以及 pstack 完整的注释清理规则。 no-comments提交前的一轮注释净化评审在 pstack 的命令目录中这条技能只有一句话的官方定义/no-commentsstrip comments before review, fix the accepted findings, encode claimed constraints. 评审前剥离注释修复被接受的发现并把声称的约束编码成可执行形式。见 docs/reference.md。它的完整定义在 plugins/pstack/skills/no-comments/SKILL.md核心是一条六步流水线派出子代理用subagent_type: pstack:comment-sicko派出找茬者把审查范围当前文件、diff 或相对main的变更交给它审查报告主代理逐条核对发现拒绝误报——被保留的注释必须有证据证明代码无法表达它处理小修复删死代码路径、丢无用参数、改用真实 API根因修复删除每个被点名的 workaround而不加症状守卫约束注释遇到do not remove之类的注释给出最便宜的编码方案——类型、运行时检查、测试或 CI lint批准后才编码并删除注释输出报告删除数量、恢复的注释、未强制的约束等。它的设计意图在 CHANGES.md 中有记录no-comments加上comment-sicko子代理共同构成一道comment-stripping review pass注释剥离评审通道。 comment-sicko一个仇恨注释的子代理plugins/pstack/agents/comment-sicko.md 里的角色设定相当个性A deranged comment-hater that savors deletion and condemns workaround code. 一个变态的注释仇恨者以删注释为乐并以 workaround 代码为罪。它对叙述性注释、横幅分隔线、被注释掉的尸体代码、workaround 说教全部感兴趣。但它的纪律也很严格只报告不动代码它只点名触碰的文件、删除计数、MUST KILL标记每个附一行说明和跳过项从不写应用代码lint 抑制不放过eslint-disable、ts-ignore、ts-expect-error等发臭的抑制必须查明规则——如果规则真能抓 bug 或保护正确性就杀掉抑制并标记MUST KILLIMPORTANT、do not remove只是气味不是证据它会读附近代码必要时跑/how、/why技能去求证证明不了的注释就删。✅ 注释的五宗豁免哪些注释能活下来comment-sicko 的唯一缰绳是 comment-sicko.md 第 16-21 行 的例外清单只有五类#可豁免的注释说明1法务 / 许可证头法律要求不可删2外部依赖强加的非显然行为平台、供应商、协议导致的我们改不动自己代码里的惊喜不算3// prettier-ignore格式化工具指令4定义公开 API 契约的文档注释契约本身5解释代码无法表达的约束的 Issue / RFC 链接指向性引用清单之外不确定的就死When I am not sure a keep clause applies, the comment dies。⚡ 如何触发一次注释清理安装 pstack 插件后各平台安装方式见 README.md直接在 Agent 会话中运行/no-comments即可。作用范围规则很实用优先使用调用者指定的文件或 diff否则自动使用相对基础分支默认main的当前 diff包含工作区未提交内容。配合 poteto-mode 技能 使用效果最佳它的触发器规则明确要求评审前 →/no-comments见 poteto-mode/SKILL.md 第 30 行让注释清理成为每次评审前的固定动作。 三层防线no-comments 与 deslop、poteto-mode 的注释规则pstack 的注释哲学不是单点技能而是三层防线写代码时——poteto-mode/SKILL.md 的 Comments 章节 规定注释只保留代码无法展示的非显然 why测试脚本禁止写// Phase 1: add cards这类阶段叙述断言信息自己说话提交时——deslop 技能 对照main的差异清理多余的、与本地风格不一致的注释等 AI 生成痕迹评审前——no-comments comment-sicko 做最终剥离把活下来的约束注释编码成类型、测试或 lint 规则。一句话总结这套注释规则注释默认是债务代码自己说话才是目标注释要活要么有证据要么有豁免。 相关文件速查技能定义plugins/pstack/skills/no-comments/SKILL.md子代理定义plugins/pstack/agents/comment-sicko.md配套清理技能plugins/pstack/skills/deslop/SKILL.md工作流与触发器plugins/pstack/skills/poteto-mode/SKILL.md命令目录docs/reference.md【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 pstack的注释哲学：no-comments技能与注释规则深度解析
pstack的注释哲学no-comments技能与注释规则深度解析【免费下载链接】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-claudepstack 是把 Poteto 的严格 Agent 工作流移植到 Claude Code、Codex、Pi 等平台上的技能栈。它最有争议也最有趣的设计是no-comments 技能一套默认有罪推定的注释规则——注释先被删少数类型才配活下来。本文带你读懂 no-comments 技能、comment-sicko 子代理以及 pstack 完整的注释清理规则。 no-comments提交前的一轮注释净化评审在 pstack 的命令目录中这条技能只有一句话的官方定义/no-commentsstrip comments before review, fix the accepted findings, encode claimed constraints. 评审前剥离注释修复被接受的发现并把声称的约束编码成可执行形式。见 docs/reference.md。它的完整定义在 plugins/pstack/skills/no-comments/SKILL.md核心是一条六步流水线派出子代理用subagent_type: pstack:comment-sicko派出找茬者把审查范围当前文件、diff 或相对main的变更交给它审查报告主代理逐条核对发现拒绝误报——被保留的注释必须有证据证明代码无法表达它处理小修复删死代码路径、丢无用参数、改用真实 API根因修复删除每个被点名的 workaround而不加症状守卫约束注释遇到do not remove之类的注释给出最便宜的编码方案——类型、运行时检查、测试或 CI lint批准后才编码并删除注释输出报告删除数量、恢复的注释、未强制的约束等。它的设计意图在 CHANGES.md 中有记录no-comments加上comment-sicko子代理共同构成一道comment-stripping review pass注释剥离评审通道。 comment-sicko一个仇恨注释的子代理plugins/pstack/agents/comment-sicko.md 里的角色设定相当个性A deranged comment-hater that savors deletion and condemns workaround code. 一个变态的注释仇恨者以删注释为乐并以 workaround 代码为罪。它对叙述性注释、横幅分隔线、被注释掉的尸体代码、workaround 说教全部感兴趣。但它的纪律也很严格只报告不动代码它只点名触碰的文件、删除计数、MUST KILL标记每个附一行说明和跳过项从不写应用代码lint 抑制不放过eslint-disable、ts-ignore、ts-expect-error等发臭的抑制必须查明规则——如果规则真能抓 bug 或保护正确性就杀掉抑制并标记MUST KILLIMPORTANT、do not remove只是气味不是证据它会读附近代码必要时跑/how、/why技能去求证证明不了的注释就删。✅ 注释的五宗豁免哪些注释能活下来comment-sicko 的唯一缰绳是 comment-sicko.md 第 16-21 行 的例外清单只有五类#可豁免的注释说明1法务 / 许可证头法律要求不可删2外部依赖强加的非显然行为平台、供应商、协议导致的我们改不动自己代码里的惊喜不算3// prettier-ignore格式化工具指令4定义公开 API 契约的文档注释契约本身5解释代码无法表达的约束的 Issue / RFC 链接指向性引用清单之外不确定的就死When I am not sure a keep clause applies, the comment dies。⚡ 如何触发一次注释清理安装 pstack 插件后各平台安装方式见 README.md直接在 Agent 会话中运行/no-comments即可。作用范围规则很实用优先使用调用者指定的文件或 diff否则自动使用相对基础分支默认main的当前 diff包含工作区未提交内容。配合 poteto-mode 技能 使用效果最佳它的触发器规则明确要求评审前 →/no-comments见 poteto-mode/SKILL.md 第 30 行让注释清理成为每次评审前的固定动作。 三层防线no-comments 与 deslop、poteto-mode 的注释规则pstack 的注释哲学不是单点技能而是三层防线写代码时——poteto-mode/SKILL.md 的 Comments 章节 规定注释只保留代码无法展示的非显然 why测试脚本禁止写// Phase 1: add cards这类阶段叙述断言信息自己说话提交时——deslop 技能 对照main的差异清理多余的、与本地风格不一致的注释等 AI 生成痕迹评审前——no-comments comment-sicko 做最终剥离把活下来的约束注释编码成类型、测试或 lint 规则。一句话总结这套注释规则注释默认是债务代码自己说话才是目标注释要活要么有证据要么有豁免。 相关文件速查技能定义plugins/pstack/skills/no-comments/SKILL.md子代理定义plugins/pstack/agents/comment-sicko.md配套清理技能plugins/pstack/skills/deslop/SKILL.md工作流与触发器plugins/pstack/skills/poteto-mode/SKILL.md命令目录docs/reference.md【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考