ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

pstack orchestrate 完整指南:如何把多日项目交给一个协调者 Agent

pstack orchestrate 完整指南:如何把多日项目交给一个协调者 Agent pstack orchestrate 完整指南如何把多日项目交给一个协调者 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 是一个面向 Claude Code、Codex、Pi 等 Agent 框架的技能栈其中的orchestrate剧本playbook专门解决一个问题把跨越数天、包含几十个 PR 和数十个并行子 Agent 的大项目整体交给一个常驻的协调者 AgentCoordinator来驱动——你每天只需查看两次进度而不是每五分钟盯一次屏幕。 一图看懂pstack 的 poteto-mode 会根据任务自动选择工作流剧本orchestrate 就是其中专为项目级大工程设计的长周期编排模式。Orchestrate 解决什么问题什么任务该交给协调者大多数 Agent 工作流适合一个会话内做完的任务。但有些工作寿命超过任何单个 Agent跨越多天、多层 PR 堆叠stacked PRs、需要同时跑几十上百个子 Agent。这时就该路由到 orchestrate。它和其他模式的区别很清晰见 SKILL.md 的路由规则模式适用场景Autonomous run一个任务驱动到完成条件predicate单任务长跑figure-it-out单次雄心任务需要量身定制的工作流Orchestrate整个项目交给一个协调者聊天窗口多日、多 PR 堆叠、大规模子 Agent 队列一句话判断标准如果一个 Agent 能在本次会话预算内干完就别用 orchestrate只有工作寿命超过单 Agent的项目才值得付出这套编排开销。三层角色分工协调者、子协调者、工人orchestrate 的核心设计是严格的角色分层深度固定在协调者 → 轨道track→ 工人三层见 orchestrate.md 协调者当前聊天窗口写任务简报brief、清空完成队列、做判断决策、负责向人类汇报。它绝不亲自写代码——改代码、解决冲突、合并都是任务不是它的手动操作。 子协调者可选当项目规模超过一个协调者能处理的吞吐量时才引入每条轨道一个只向上汇报汇总不透传原始子报告。 工人 / 验证者后台运行的子 Agent。每个写代码者独占一个 worktree 或分支避免共享状态冲突验证者使用与工人不同模型族的模型保证验证独立性。三条铁律贯穿始终完成是队列事件而不是打断、每次生成和恢复都必须逐字携带常设指令standing orders、简报就是产品——因为工人无法回头问你问题模糊的简报只会安静地失败。简报Brief协调者唯一的产品协调者不写代码它写的每一封任务简报brief就是交付物。一份完整简报包含固定字段模板见 orchestrate.mdGOAL一句话目标陌生人在没有聊天上下文的情况下也能执行SCOPE允许写和禁止写的路径、独占的 worktree/分支CONTEXT相关文件与 PR 指针依赖的上游报告必须全文贴入ACCEPTANCE / VERIFY逐行可检查的验收标准 精确的验证命令TIMEBOX / FORBIDDEN运行时限与禁区禁止 rebase、force-push、范围外修改等STANDING逐字粘贴的常设指令模型策略、验证门槛、升级策略等设计精髓是简报与单元规模匹配一条命令的单元简报压缩成一段话四 KB 的模板套两行修改纯属浪费而子协调者的简报会额外附带轨道边界、生成预算和汇总格式。七步推进从立项到收尾的程序化流程orchestrate 把多日项目拆成七个可编程的步骤见 Steps 章节Frame立框把完成条件写成可计数的指标如全部 126 个单元合并且逐行台账验证通过量化单元数、预算和工作墙钟时间Install安装运行时执行orch init初始化存储写常设指令从现有 PR 播种合并前沿线Pilot试点先让一个单元完整走一遍简报→工人→验证→入栈→合并全流程——用 1 个 Agent 的成本证伪模板而不是 50 个Scale扩展滚动窗口式生成工人而非阻塞式批次完成后即补位避免每批次都等最慢的子 AgentDrain清空队列在关键节点批量处理完成事件分类为已落地/待验证/失败/僵尸/噪音Land落地合并是连续的从第一个验证通过的单元就开始集成绝不等到最后Close收尾对账每个生成过的 Agent、确认完成条件、把重复出现的修正写入常设指令完整保留存储目录作为事后复盘材料状态存储与 orch CLI让程序比会话更长寿orchestrate 在~/.claude/orchestrate/项目名/下建立一套仓库外、会话外的持久存储布局见 orchestrate.mdpreferences.md常设指令登记册每次生成/恢复逐字粘贴units.tsv每个工作单元一行id、轨道、状态、分支、PR、head SHAledger.tsv验证台账以PR 号 head SHA为键记录判定结果inbox/与gates.md完成事件指针 等待人类决策的关卡frontier.json计算得出的合并前沿线而非叙述性记录配套的是orch命令行工具源码见 orch.ts 与 store.tsorch inbox push/drain、orch unit add/set、orch ledger record、orch status。它的设计哲学是一次命令进、一行结果出——CLI 从不生成、等待或唤醒任何 Agent状态读写都发生在清空队列的时间点。验证判定同样有严格等级live-ui-verified→unit-test-verified→type-check-only等CI 绿只是判定的输入而非判定本身verifier-blocked不算通过。容错与人类边界协调者何时喊停多日长跑必然遭遇故障orchestrate 用活性与失败章节定义了重试纪律见 Liveness 章节永远不恢复一个 Agent 只为查看它——恢复会重启空闲 Agent应改用只读探针台账、分支、PR按失败模式分类重试超限/OOM 缩小范围重生网络掉线原样重试工具错误换模型重试两次重试后放弃该单元并绕行重规划会话重启后在飞的子 Agent 死了但已推送的分支、开放的 PR 和存储目录都活着——按 PR 和分支重新挂载而不是按 Agent id而升级Escalation定义了人机边界只有不可逆操作force-push、部署、删除、真正的产品偏好决策、与常设指令矛盾的现实、以及重规划后仍走不通的死路才会批量进入gates.md关卡等待人类前沿线微调、重试、CI 抖动、格式修复等一律不打扰你——拿不准时行动并记录。快速上手 orchestrate 工作流第 1 步安装 pstack。在 Claude Code 中执行插件市场安装命令其他运行时Codex、Pi、Prime Agent、OpenCode 等的安装方式见 docs/reference.md。若走共享技能安装路径可克隆仓库后把技能链接到~/.agents/skills/git clone https://gitcode.com/GitHub_Trending/ps/pstack-claude cd pstack-claude第 2 步用触发短语路由。直接用自然语言描述项目级意图即可例如Use poteto-mode to own this migration until it lands.run this whole project、own this migration until it lands 这类整项目级的表述会被路由到 orchestrate路由表见 SKILL.md。第 3 步阅读核心文档。完整编排规范只有一份文件orchestrate.md配套的队列/存储实现与恢复机制分别位于 orch/ 和 resume-storage.md。总结pstack 的 orchestrate 把把大项目交给 AI这件事工程化了——角色分层保证职责清晰简报模板保证指令不衰减持久存储保证跨天可恢复验证台账保证每个判定可审计。你每天来看两次orch status的三行输出其余交给协调者。【免费下载链接】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),仅供参考
返回列表