pstack子代理策略详解何时用poteto-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-claude这篇文章面向新手讲清 pstack 的子代理subagent调度策略poteto-agent 在 playbook 步骤内何时登场以及为什么 pstack 要求新任务默认交给全新子代理避免指令丢失和上下文漂移。先认识 pstack 和它的主力子代理pstack 是把 Lauren Tan 的 pstack 技能栈移植到 Claude Code、Codex、Pi 等代理运行时的项目。核心玩法很简单向poteto-mode描述目标它会自动调用匹配的工作流查 bug、设计评审、并行探索等并保证代码简洁、可验证。pstack 内置了两个角色代理poteto-agent/poteto-mode的路由目标任何按 poteto 风格干活的请求都走它。定义见 poteto-agent.mdcomment-sicko一个专门恨注释的特色代理负责清理叙述性注释和 workaround 说教定义见 comment-sicko.mdpoteto-agent 有一个硬性规则动手前必须完整读取poteto-mode技能的 SKILL.md含其中的 Principles 索引。用general-purpose替代它会跳过这次阅读风格就会漂移。这一点是理解整套子代理策略的关键。规则一playbook 步骤内用 pstack:poteto-agentpoteto-mode 的 SKILL.md 中 Subagents 一节给出了明确的分工规则场景该用哪个子代理playbook 步骤内的代码委派、临时帮手subagent_type: pstack:poteto-agenthow、why、interrogate、reflect、swarm等路由型技能技能自己设定的subagent_type多模型评审用general-purpose不要覆盖成 poteto-agent需要指定推理等级时pstack:poteto-agent-levellow / medium / high / xhigh / max为什么路由型技能要排除在外因为interrogate、arena、swarm这类技能的对抗信号来自模型多样性不同模型各审一遍、互相投票而不是来自 poteto 风格。尊重技能自己的设定是第一条铁律。按难度给子代理配模型每次Agent调用都有默认约定后台运行run_in_background: true、完整工具权限、用文件指针而非内联上下文传资料、按角色显式指定模型。模型分级策略是最难的变更跨模块设计、棘手的并发、微妙算法→ 最强判断力模型琐碎的机械性编辑→ 快速代码模型其余任务→ 单角色默认模型角色默认值写在 models.json默认 opus、最强 fable、评审小组 opus/fable/sonnet各推理等级对应的代理文件在 effort-agents/并可通过/setup-pstack命令逐角色改写。规则二新任务默认交给全新子代理这是 pstack 子代理策略里最容易忽视的一条Fresh subagents by default默认用全新子代理。什么是合并范围consolidated scope新工作要交给一个全新子代理并带上合并范围即原始任务简报之后所有补充指令上一个代理的报告和分支修复轮次、后续跟进、重试、队列里的下一项全都适用。为什么不能图省事直接续命官方给出的理由很直接resume 链式恢复会悄悄丢掉指令interrupt-chained resumes silently drop directives。你以为旧代理还记得别动那个配置其实那条指令早没了。所以正确做法是开一个全新子代理把全部上下文重新打包给它而不是信任一句已完成的摘要。严格的例外什么时候可以 Resume只有当新工作严格依赖只存在于那个代理里的状态、且搬走代价很高时才允许 resume 原代理包括三类它本地的 checkout本地检出它未提交的改动它仍在运行的进程开发服务器、模拟器、babysit 监视器等注意两个易错点给运行中代理下达停止/暂停指令不算复用角色如 PR owner比代理活得久代理一返回角色下一轮就该由全新代理接手停止旧代理要确认它真的停了换新代理前先停掉被弃用者并确认停止。因为列表里的completed状态只代表完成已被通知不代表进程已退出——带着后台子任务live background children的代理可以报告 completed 后继续复活。只有显式 stop 才能终结它。一个典型信号代理声称工作树处于某个状态但git status与它矛盾——说明它还在动。为什么要把大量工作丢给子代理这与 pstack 的原则之一Guard the Context Window守护上下文窗口直接相关上下文窗口有限且会话内不可再生大输出、长文件、反复读取都会挤占主线程。策略是把大块内容路由给子代理主线程只留摘要。子代理就是 pstack 用来扩容上下文的核心手段因此何时派子代理和派哪种子代理同样重要。常见错误清单❌ 用general-purpose顶替pstack:poteto-agent跳过 SKILL.md 阅读风格漂移❌ 把路由型技能how / why / interrogate / swarm的子代理强制改成 poteto-agent失去多模型多样性信号❌ 修复轮、重试时 resume 旧代理省得重新交代指令在链式 resume 中悄悄丢失❌ 看到completed就认为旧代理已退出它可能只是通知了完成进程仍在跑小结两张判断卡选类型时playbook 步骤内干活 →pstack:poteto-agent路由型评审技能 → 技能自己指定。选新旧时默认全新子代理 合并范围仅当工作严格依赖旧代理的本地检出、未提交改动或运行中进程时才 resume 它。把这两条记住就能像 poteto-mode 一样调度子代理简洁、可验证、不漂移。【免费下载链接】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），仅供参考