
pstack的multi-phase-plan跨阶段、多PR叠加工作的规划方法完整指南【免费下载链接】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 等 AI 编程助手的严谨智能体技能栈其核心 poteto-mode 会把任务自动路由到对应的工作流。其中 multi-phase-plan 是专门处理跨阶段、多 PR 叠加工作的规划手册它把大项目拆成一个个可逐项核验的小 PR交付物不是代码而是一份清单式的计划。什么是 multi-phase-plan计划本身才是交付物一句话说清它的立场你拥有的是计划不是代码。手册原文multi-phase-plan.md规定计划是负责人逐框执行、审计者按证据检查的清单。具体含义每个复选框是一个工作单元且必须写明验证它的证据文件、日志行、截图、测试输出或 SHA证据不存在框就不能打勾一个 PR 就是一个变更携带自己完整的验证证据对应 sequence-verifiable-units 原则。这是大型叠加工作可被信任的基础评审者可以逐框回放而不是相信我。什么时候触发它路由规则写在主文档 poteto-mode SKILL.md 中跨越阶段或堆叠 PR 的工作 → multi-phase-plan。但边界同样重要情况处理方式只改 1~2 个文件、方案明显跳过规划直接做并说明跨阶段、多 PR、有依赖关系使用 multi-phase-plan连续多天的项目级工程、几十个以上子代理升级到 orchestrate 要点规划的仪式必须与工作体量匹配。小改动被强塞进重流程与这套技能栈能删就删的精神正好相反。计划是怎么写出来的7 步流程手册定义了 7 步全程不写一行业务代码判断要不要规划—— 一两处文件、方案明显说明理由后直接停止用原型回答未决问题—— 凡是跑一次实验就能定的问题先用 prototype 定掉保留分支、SHA 和截图只把真正属于产品偏好的问题留给用户子代理并行探索—— 派出多个 poteto-agent 收集文件指针、代码惯例、测试命令与入口保持主上下文干净填骨架—— 把标准骨架写进计划文件一个 PR 一个章节标题顺序不可调整两遍文字打磨—— 先按 /technical-writing 写正文再用 /unslop 去除冗余表达机器检查—— 运行 check-plan.mjs修复它报出的每一行问题交还—— 只回复计划路径和脚本输出然后停止。 注意第 7 步的说完即停用户要看计划不等于授权开工执行必须由用户明确说go才开始。计划文件的骨架一个 PR 一个章节骨架采用渐进披露结构机器检查也按同一标准标题 摘要不超过 10 行改什么、给谁改、PR 编号按序列出How to read this阅读规则 选用哪个执行手册 验证规则Program checklist武装计划、派出负责人、PR 机制、裁决与合并、启动配方五个小节每个 PR 一个##章节动词短语 PR 编号Close the program收尾后接附录 A~D原型证据、被否决的方案、风险、阅读清单。每个 PR 章节含固定的 9 个小块逐块列复选框小块写什么Depends on依赖哪个 PR或 NoneFiles要编辑、创建、删除的具体文件Build一个变更写明符号和文件You see一个可观察结果精确的日志行或界面状态Verify, unit测试文件与运行命令Verify, live10 条泳道的真实环境验证各带截图与通过判据Verify, perf指标、探测方式、trunk 基线、带数字的判定规则Review gate是否需要人工评审需要则附截图与 30~60 秒视频Merge干净裁决、机器人评论分诊、合并方式✅ 依赖关系画在派出负责人小节里独立的 PR 从 main 并行起步有依赖的 PR 等父 PR 合并后再动。这是叠加不乱的关键。三重验证规则计划的心脏每个验证块的开头必须原样写一句话Tests alone are not sufficient verification. A PR is verified only when its unit, live, and perf boxes are all checked.即单元测试、真实环境、性能三关全过才算验证live在 PR 头部的 worktree 上并行跑 10 条泳道。第 1 条固定是对 trunk 的回归泳道——同一核心场景在主干和头部各跑一遍确认新改动没弄坏旧行为每条泳道存一张截图并写明通过判据perf双向门槛先测 trunk 记录基线再测头部规则里必须带数字不达标即失败两侧场景不可比时改用绝对预算不硬造比例Review gate改动交互的 PR 必须让用户在聊天里看截图和视频后再合并不改交互的则明确写无人工评审门槛。 这套设计让叠加 PR变得安全即便堆上十几个 PR每一个都自带完整独立的证据链出问题能在几秒内定位到具体是哪个 PR。三种执行模式计划定稿后三选一计划本身不实现代码它只在 How to read this 里指名一个执行手册模式适用场景谁负责落地autopilot-fullPR 相互独立可并行落地用户逐个点击合并autopilot-stack工作有顺序或耦合先评审后落地用户整条链落地orchestrate常驻项目级工程多天、大量子代理协调者落地已验证的工作计划刻意不抄执行手册里的 rebase 细节——拓扑变更与合并权归执行手册所有计划只记录谁合并、哪些 PR 停在 merge-ready 等用户点击。质量防线check-plan.mjs 机器检查check-plan.mjs 是交付前必跑的一步它会核对章节齐全且顺序正确摘要、How to read this、Program checklist、按序的 PR 章节、Close the program、附录每个 PR 的 9 个小块按序出现且不为空live 泳道恰好 1~10 号每条都带截图与Pass when判据性能四件套 Metric / Probe / Baseline / Rule 齐备文字纪律无长破折号、无句中冒号。脚本最后输出每个 PR 的框数统计。这是把教训编码进结构原则的落地规则不靠代理记住而是写成脚本。快速上手按 README.md 的官方说明安装 pstack 插件用一句话下达大任务例如用 poteto-mode 规划把配置模块迁移到新存储层按依赖拆成多个 PR。代理匹配到 multi-phase-plan交付计划文件 脚本检查输出确认依赖图与人工评审门槛后说go执行手册接棒。 相关路径poteto-mode 主文档、全部手册目录 playbooks/、原则技能集 skills/。【免费下载链接】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),仅供参考