pstack原则06最小化读者负担降低代码审查认知负荷的8条实用清单【免费下载链接】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 是一套面向 Claude Code、Codex、Pi 等智能体平台的严格工作流技能栈其中最小化读者负担Minimize Reader Load原则是它降低代码审查认知负荷的核心清单。这条原则只问一个问题读者为了理解这段代码需要付出多少工作量如果答案是太多那问题不在读者而在代码本身。为什么读者负担才是代码质量的第一指标代码被阅读的次数远远多于被书写的次数。代码行数、圈复杂度、整洁架构这些指标都只是代理指标真正决定维护成本的是读者脑中的负担。pstack 把这份负担拆成两个可以独立追踪的维度追踪的层数—— 从问题到答案之间隔了多少层间接调用需要持有的状态—— 读者必须在脑海中记住多少隐藏的、可变的上下文这两轴互相独立一个有 50 个全局变量的扁平文件可能和 6 层适配器堆栈一样难推理。两个都要守。这条原则的完整定义见 principle-minimize-reader-load/SKILL.md它是 poteto-mode 核心原则清单中的第 6 条。8条降低认知负荷的操作清单 1. 折叠只省不赚的层只被调用一次的包装函数、没有第二个实现的适配器、从未被需要的投机性间接层——直接内联掉。判断标准很简单在添加任何层或状态之前先问它是否在其他地方至少等价地降低了读者负担2. 相邻层必须改变抽象如果一层只是重复上一层的方法和参数透传层它只增加负担、不提供压缩应合并。3. 追求接口压缩一个隐藏不了多少复杂度的宽接口强迫读者既学表面 API 又学实现细节。好的边界应该隐藏有意义的决策。4. 缩小可变状态的 scope优先级排序纯函数返回值优于变更 局部变量 字段 模块状态 全局状态。能用推导得到就绝不同步维护。5. 在边界处只说一次不变式命名不变式invariant应该放在边界处让读者只学一次而不是在每个使用点重复声明。6. 保持扁平的调用层级这是配套的 Laziness Protocol懒惰协议 的核心要求回答一个问题如果需要追踪超过 3 个文件或 3 层调用就该把它压平。pstack 的 architect 执行者提示 也明确写入了这条规则。7. 先做减法再做加法添加会放大复杂删除会暴露本质结构。Subtract Before You Add先减后加 要求删除死代码、折叠单调用者包装、去掉冗余校验然后再引入新形状。8. 30秒测试给新读者的验收标准 ⏱️这是整条原则的终极检验一位新读者能否在30 秒内回答X 是从哪里来的和什么东西能改变 X如果答不上来就砍层或砍状态。在 pstack 重构工作流中的实际应用这条原则不只是口号而是被写进了执行流程。Refactoring 剧本 的第 7 步明确规定成功度量标准是降低读者负担。如果这次 diff 没有在任何地方降低读者负担就回滚它。也就是说一次重构是否值得保留由读者负担的增量来裁决——这正是可验证单元思想的体现。延伸阅读本原则的姊妹篇 Guard the Context Window守护上下文窗口两者本质同源——读者和 AI 的工作记忆都是有限的。新手速查如何上手安装 pstack 插件在 Claude Code 中运行插件安装命令详见 README.md 与 docs/reference.md用poteto-mode处理真实任务观察它如何自动触发该原则下次 code review 时直接拿30秒测试去衡量眼前的每一段难读的代码记住代码是为读者写的。当维护者觉得累问题永远在代码一侧。【免费下载链接】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），仅供参考