pi-interactive-subagents 内置 Agent 团队深度剖析：planner、scout、worker、reviewer 六名专家如何分工协作-北京尧图网络

【免费下载链接】pi-interactive-subagentsInteractive subagents for pi — spawn, orchestrate, and manage sub-agent sessions in cmux terminals项目地址https://gitcode.com/gh_mirrors/pi/pi-interactive-subagents点击查看免费下载pi-interactive-subagents是一款为 pi 编码智能体打造的交互式子代理subagents扩展它能在 cmux/tmux 等终端多路复用器中一键派生、编排并管理多个子 Agent 会话全程非阻塞——主 Agent 继续工作时子 Agent 在独立窗格中并行运行。本文带你逐一点透它内置的 6 名专家 Agentplanner、scout、worker、reviewer、visual-tester 与 claude-code看懂它们如何组成一支分工明确的AI 开发团队。为什么需要一支 Agent 团队单个 AI Agent 既写代码又做规划、还负责审查上下文容易打架。pi-interactive-subagents 的思路是把任务拆给不同角色planner负责想清楚做什么、怎么做scout负责快速摸清现有代码库worker负责落地实现reviewer负责把代码质量关️visual-tester负责视觉 QAclaude-code负责深度探索实验主会话调用subagent()后立即返回子 Agent 在专属终端窗格中运行输入框上方的实时组件持续显示每个子 Agent 的状态starting/active/waiting/stalled/running。完成后结果自动回流到主会话触发新一轮处理。详见 README.md。六名专家一览模型与职责速查表Agent默认模型核心职责定义文件plannerOpusmedium 思考需求澄清、方案探索、输出计划与 todosagents/planner.mdscoutHaiku轻量快速代码库侦察文件、模式、约定agents/scout.mdworkerSonnetminimal 思考按 todos 写代码、跑测试、提交agents/worker.mdreviewerOpusmedium 思考审查代码的缺陷、安全与正确性agents/reviewer.mdvisual-testerSonnet通过 Chrome CDP 做截图、响应式与交互测试agents/visual-tester.mdclaude-codeSonnetClaude CLI自主深度调查、实验与代码探索agents/claude-code.md一个值得关注的设计每个角色只被授予必要工具。scout 只有read, bash只读侦察worker 有read, bash, write, edit可动手实现reviewer 只读不改——从权限层面杜绝审查员顺手改了代码这类越界行为。planner交互式规划师交付计划 todosplanner 是团队的军师也是六人中唯一默认交互式的 Agent不设auto-exit用户可以直接在它的面板里对话。它的硬规则很严格一次只推进一步每条消息只覆盖一个阶段然后停下来等用户回复不跳阶段哪怕是个计数器应用也要走完整流程绝不实现功能交付物是plan.md和 todos不是生产代码需求工程保持轻量澄清到无重大歧义即止通常 1-2 轮提问就够它的工作流覆盖10 个阶段调查上下文 → 理解意图 → 澄清需求 → 确定投入等级与理想状态标准ISC→ 探索 2-3 个方案 → 验证设计 → 事前验尸Premortem→ 撰写plan.md→ 创建 todos → 总结退出。更妙的是它的委托机制遇到代码事实缺口就派 scout现有认证怎么工作的遇到外部知识缺口就派 researcher当前最佳实践是什么而用户偏好类问题则直接问人。这条派谁去查的决策表是整支团队协作的中枢。scout快速侦察兵只读不改scout 是侦察专家只操作现有代码库价值在于读懂已存在的东西——文件、模式、约定、依赖和坑。它的工作方法可以概括为五步定位 → 绘制地形 → 读代码 → 提炼约定 → 标记坑点。原则是先读再评、彻底但快、直接不绕。侦察结果通过write工具落成一份scout-context.md典型路径.pi/plans/YYYY-MM-DD-name/scout-context.md供 planner 和 worker 后续消费。scout 的约束非常干净只读——绝不修改任何文件不构建、不测试——留给 worker不做实现决策——那是 planner 的事配合auto-exit: true与spawning: false它是一个跑完即退、不再生成下级子 Agent 的一次性探针这正是它在多子 Agent 并行时特别省心的原因。worker落地实现者交付即交人worker 的定位是一位拿到清晰任务的高级工程师。它的第一课就是不重新设计、不重新规划、不扩大范围——上下文由 scout 采集、决策由 planner 做出它只负责高质量执行。worker 的标准流程是一条闭环流水线读任务从任务消息里拿到 TODO 引用、计划路径与验收标准校验 todo 质量若缺少代码示例/引用/约束停下并上报绝不瞎猜——提问带来做对猜测带来做错认领 todo→ 4.实现跟随既有模式改动最小化验证跑测试、对照 ISC 逐条留证据应该能跑不算证据提交生成描述清晰的 commit关闭 todo它内置的工程信条同样值得抄进你自己的 Agent 提示词先读再改、有证据才有断言、调研而非猜测。reviewer代码审查员按 P0-P3 分级reviewer 负责质量、安全与正确性审查同样只读不改——发现问题就清晰标出留给 worker 去修。它最有价值的是那套务实的分级标准级别含义例子P0立即处理会炸生产、丢数据或开安全洞密钥泄露到客户端、认证绕过P1真正的陷阱必有人踩坑隐蔽的竞态、缺失的错误处理P2值得提真实改进可读性、可维护性优化P3几乎无关命名口味同时它也明确规定不该标什么命名偏好、假设性边界情况、风格差异、投机式未来扩展问题。审查结论落成review.md给出APPROVED/NEEDS CHANGES的明确裁决——如果代码没问题简短的审查就是正确答案不制造无病呻吟的发现。visual-tester 与 claude-code补齐测试与探索两翼visual-tester是视觉 QA 专员通过 Chrome CDP 控制浏览器截图、检查可访问性树、操作元素检查布局错位、文字截断、颜色对比、异常滚动条等肉眼看的问题产出结构化报告供 worker 修复。注意它同样不修 CSS——它只负责看出哪里不对。claude-code则是一个自驱动的 Claude Code 会话拥有完整终端能力bash、文件访问、git clone、编辑、测试、构建适合 pi 主 Agent 需要放手交给一个能自己干活的终端会话的深度调查与实验场景。两者均设置spawning: falseauto-exit: true保证它们是受控的叶子节点。协作全景/plan 命令的 5 阶段流水线理解单个角色后最直观的协作场景就是内置的/plan工作流。输入一句需求/plan Add a dark mode toggle to the settings page编排流程如下Phase 1: Investigation → scout 快速扫描代码库 Phase 2: Planning → 交互式 planner 子 Agent用户参与 Phase 3: Review Plan → 确认 todos必要时调整 Phase 4: Execute → scout 顺序 worker 逐个实现 todos Phase 5: Review → reviewer 子 Agent 检查全部变更窗口标题会随阶段实时切换 Investigating → Planning → Executing 1/3 → Reviewing → ✅ Done。配套还有/iterate命令把当前会话完整 fork给一个子 Agent 做快速修复修完返回摘要主会话上下文保持干净。此外主会话还能用subagent_interrupt中断子 Agent 的当前回合、用subagents_list列出可用 Agent、用subagent_resume恢复暂停的子会话子 Agent 遇到需要上级决策的问题时还能通过caller_ping向父会话求助。完整工具与参数说明见 README.md。如何自定义你的 Agent 团队内置 6 个 Agent 只是起点。你可以通过 Markdown 文件定义自己的角色放在.pi/agents/项目级或~/.pi/agent/agents/全局优先级为项目级全局包内置——同名即可覆盖内置 Agent。frontmatter 中最关键的几个字段字段作用model/thinking指定默认模型与思考强度minimal/medium/hightools限定原生工具如read, bashspawning: false禁止该 Agent 再生成子 Agentauto-exit: true回合结束自动退出无需显式调用subagent_donesession-modestandalone/lineage-only/fork控制子会话如何继承上下文cwd指定角色文件夹可为不同角色挂载各自的CLAUDE.md与技能官方对推荐配置的总结值得照搬planner 保留派生能力它要派 scout 去查事实scout / worker / reviewer 一律spawning: false——各司其职不允许层层外包。更多字段与配置示例见 README.md 的 Frontmatter Reference 章节状态展示配置可参考 config.json.example。快速上手三步接入你的 pi 工作流第 1 步安装扩展pi install git:github.com/HazAT/pi-interactive-subagents第 2 步在支持的复用器中启动 pi支持 cmux、tmux、zellij、WezTermcmux pi # 或 tmux new -A -s pi pi第 3 步开始派活/plan 给设置页加一个暗色模式开关然后你就能在输入框上方的组件里看着 scout、planner、worker、reviewer 依次上场。若 shell 启动慢导致子 Agent 命令丢失可将PI_SUBAGENT_SHELL_READY_DELAY_MS调大默认500。小结把一个全能 Agent拆成一支专业团队pi-interactive-subagents 的核心价值不是更多子 Agent而是一套可复制的分工方法论角色边界用权限固化工具白名单 spawning: false从机制上防止越界交付物即接口scout-context.md→plan.md todos → 代码 →review.md每个角色消费上一个角色的产物非阻塞编排子 Agent 并行运行、结果自动回流主会话随时可对话⚖️交互与自治分离planner 交互式陪跑scout/worker/reviewer 自治跑完即退auto-exit如果你想深入扩展实现细节核心入口在 pi-extension/subagents/index.ts会话管理在 pi-extension/subagents/session.ts实时状态组件在 pi-extension/subagents/status.ts。对于想用 pi 搭建多智能体开发流水线的团队这套内置六人组既是现成的生产配置也是自定义 Agent 团队的最佳模板。赞分享【免费下载链接】pi-interactive-subagentsInteractive subagents for pi — spawn, orchestrate, and manage sub-agent sessions in cmux terminals项目地址https://gitcode.com/gh_mirrors/pi/pi-interactive-subagents点击查看免费下载相关推荐拆解ARTEX多Agent协作内幕Planner与Worker如何分工跑通渗透任务拆解ARTEX多Agent协作内幕Planner与Worker如何分工跑通渗透任务 ARTEX 是一套 LLM 多 Agent 驱动的自主渗透测试系统 Go人工智能AI 应用AI Agent自主智能体工具调用渗透测试网络安全后端前端MCP ClientsHarvey五个子代理深度剖析Scout、Writer、Sender、Handler、Analyst如何分工协作Harvey五个子代理深度剖析Scout、Writer、Sender、Handler、Analyst如何分工协作 Harvey 是一款自主 AI 销售代理a团队协作神器Pull如何自动分配reviewer和assignee团队协作神器Pull如何自动分配reviewer和assignee 在团队协作开发中代码审查是确保代码质量的关键环节。然而手动分配reviewer和ass开发工具CI/CD上一篇拆解 Awesome Opencode 数据驱动设计YAML 注册表与目录推导类型完整指南下一篇Sales CRM 效率神器用命令菜单CmdK实现秒级操作销售工作流提速指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

pi-interactive-subagents 内置 Agent 团队深度剖析：planner、scout、worker、reviewer 六名专家如何分工协作

相关推荐

Redwood Service 层实战指南：Service Validations 与服务缓存全覆盖，快速搭出毫秒级业务层

样章-第08讲-用状态机管理设备生命周期

Folia PWA 手机化完整指南：3 分钟把全屏歌词动画播放器装进主屏幕

更多资讯

10款免费网络安全抓包工具详解与选型指南

MySQL高可用架构实战：主主复制+HAProxy+Keepalived

灰度放量与准入控制：GATER五段式门控框架落地实践

Hive在电商大数据处理中的核心应用与优化策略

Node-RED 集成 InfluxDB v2.x 实战：写入查询闭环与生产避坑指南

如何准确获取真实屏幕分辨率：跨平台实战指南

今日更新

猫狗目标检测数据集：VOC/COCO/YOLO三格式一体化实战包

HDU2017多校标程复现：算法竞赛工程化真题沙盒

Codex Sandbox 隔离环境拆解：AI Agent 的临时实验室如何运作

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？