pstack 24条原则速查AI Agent工作流完整清单与适用场景对照表【免费下载链接】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是一套面向 AI 编程助手Claude Code、Codex、Copilot、Pi 等的技能栈插件其中的poteto-mode通过 24 条Agent 工作原则pstack 原则让 AI 在写代码、修 Bug、重构时更严谨、更可验证。本文给出这 24 条原则的完整清单 适用场景对照表帮你快速判断什么情况下该用哪条原则。一图看懂 pstack 原则在 Agent 工作流中的位置pstack 的核心玩法是你用自然语言下达目标poteto-mode自动选择合适的 playbook计划 / 修 Bug / 功能 / 重构交给子代理执行再经过多模型审查和验证最后交付被证明可用的成果。24 条原则就是贯穿这个流程的决策依据每条原则都是一个独立的技能文件存放在 plugins/pstack/skills/ 目录下总目录和分类见 plugins/pstack/skills/poteto-mode/SKILL.md。pstack 24条原则完整分类对照表官方把 24 条原则分为5 大类核心原则10 条、架构原则6 条、验证原则5 条、委派原则2 条、元原则1 条。核心原则10条写代码前的基本盘原则什么时候用原则文档懒惰协议Laziness Protocol重构、评估 diff 大小或想加抽象、分层时偏向删除做最小改动SKILL.md基础思考Foundational Thinking动手写逻辑之前先定核心类型与数据结构想清楚并发的参与者共享什么SKILL.md第一性原理重设计Redesign from First Principles往现有设计里塞新需求时当作第一天就有此需求重新设计而不是打补丁SKILL.md攻击前提Attack the Premise连续多个基于同一假设的修复都失败时先写出这个假设找一个能推翻它的实验SKILL.md先减后加Subtract Before You Add做新增、重构、重写前先删死代码、冗余校验再在更干净的底子上加东西SKILL.md最小化读者负担Minimize Reader Load审查难以追溯的代码时数一数问题到答案之间隔了几层合并单调用者包装函数SKILL.md结果导向执行Outcome-Oriented Execution有计划边界的重写和迁移时直奔目标架构不为过渡状态保留一次性兼容代码SKILL.md体验优先Experience First产品 / UX / 功能范围取舍时宁可少而精追求用户惊艳感SKILL.md穷尽设计空间Exhaust the Design Space遇到无先例的新交互或架构决策做 2–3 个竞争原型并排对比后再定SKILL.md造杠杆Build the Lever任何非琐碎工作别手工做写一个能重跑的工具脚本、生成器、codemodSKILL.md架构原则6条让系统结构更稳原则什么时候用原则文档领域建模Model the Domain写有状态逻辑、条件分支很多时把领域编码进结构状态机、类型化模型、表/注册表替代散落的 if 判断SKILL.md边界纪律Boundary Discipline接校验、错误处理、框架适配时守卫集中在系统边界CLI、配置、网络、外部 API内部代码信任类型SKILL.md类型系统纪律Type System Discipline设计类型或函数签名时让非法状态无法表示外部数据在边界解析不向编译器撒谎SKILL.md让操作幂等Make Operations Idempotent设计会在崩溃、重启、重试中运行的命令或循环无论跑过多少次收敛到同一终态SKILL.md先迁移调用方再删旧 APIMigrate Callers Then Delete Legacy APIs引入新内部 API 而旧调用方还在时同一波次内迁移并删除旧 API不留兼容层SKILL.md共享状态先隔离再串行化Separate Before Serializing多个并发参与者可能写同一文件 / 分支 / 键时先消除共享确有必要才做结构性串行化SKILL.md验证原则5条交付前必须自证原则什么时候用原则文档证明它有效Prove It Works任务完成后、宣布搞定之前直接验证真实产物跑功能、读真实值、看 diff而不是能编译就行SKILL.md修复根因Fix Root Causes调试时先复现一路问为什么直到根因拒绝用空值检查压掉崩溃SKILL.md把工序列成可验证单元Sequence Verifiable Units多步骤工作批量修改、迁移、叠 commit 和 PR每小步都以可检查状态收尾验证一个再下一个SKILL.md测行为不测实现Test Behavior, Not Implementation写 / 改 / 保留测试时确认测试能捕获一个真实缺陷断言的是契约要求的结果或可观测效果SKILL.md解释这个数字Explain the Number信任、上报或依据某个测量值加速比、延迟、eval 结果行动前找出是什么在限制它排除量错了对象SKILL.md委派原则2条Agent 协作的上下文管理原则什么时候用原则文档守护上下文窗口Guard the Context Window上下文快满时大输出、长文件、反复读取、扇出规划把批量工作丢给子代理主线程只留摘要SKILL.md永不阻塞等人Never Block on the Human可逆的操作上想问我该做 X 吗时直接做、给出结果让人事后纠偏只有不可逆操作才等确认SKILL.md元原则1条让经验沉淀下来原则什么时候用原则文档把教训编码进结构Encode Lessons in Structure你第二次写同一条口头指令时别再加文字把它变成 lint、元数据标记、运行时检查或脚本SKILL.md新手建议5条高频原则优先掌握 如果你不想一次记 24 条先掌握这 5 条覆盖面最广的原则懒惰协议—— 任何改动前问一句能不能更小、更少对抗 AI 爱加抽象的倾向证明它有效—— 交付前验证真实产物杜绝编译通过完成的幻觉修复根因—— 调试的黄金律复现 → 追问 → 修根因领域建模—— 分支一多就改成结构是代码越改越乱的解药先减后加—— 加功能前清理死代码起点越干净后面越轻松。3步上手找到并使用这些 pstack 原则第 1 步 · 安装 pstack以 Claude Code 为例在会话内运行/plugin marketplace add/plugin install pstackCodex、Pi、GitHub Copilot 等运行时的安装方式见 README.md 与 docs/reference.md。第 2 步 · 直接说目标例如用 poteto-mode 修复翻页时搜索条件被重置的问题插件会自动路由到对应 playbook并按需触发上面的原则还会在回复中点名引用它读了哪条原则。第 3 步 · 按需细读每条原则的完整规则就是一份 SKILL.md例如 plugins/pstack/skills/principle-prove-it-works/SKILL.md5 分钟即可读完一条适合做原则速查式的积累。小结pstack 的 24 条原则 10 条核心 6 条架构 5 条验证 2 条委派 1 条元原则本质是把资深工程师的工作习惯翻译成 Agent 可执行的触发规则。配合 poteto-mode 总入口 使用你不需要背下它们——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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考