pi-subagents
pi-subagents 是个给 Pi 编程助手加装子代理能力的扩展。
它把代码审查、侦察、实现这些事拆成多个任务同时跑,不用你一遍遍来回问。
前几天我在 GitHub 上逛到 pi-subagents,两周多 Star 数就破了 2000。
它就是给 Pi 这个 AI 编程助手塞进一套委派机制,你可以在对话里把一个大任务拆成几个子代理,让它们同时干活,然后把结果送回主会话。
平时用 AI 写代码,你问一句它答一句,审查、重构、查文档全挤在一个对话里来回倒。

pi-subagents内置了好几个专业角色。
有侦察代理,专门在你动手改代码之前快速扫描代码库,标出入口文件、数据流向和潜在坑位。
有审查代理,盯着你的 diff 从正确性、测试覆盖、复杂度几个角度出报告。
有执行代理,按规划好的方案改文件、跑验证,遇到拿不准的决策会停下来等确认,而不是瞎猜。
还有个顾问代理,像随时能请教的同事,在你做关键选择时挑战你的假设,提醒你没注意到的地方。
你在对话里说一句用审查员看看这个 diff,Pi 就会自动拉起对应的子进程,把活儿干了再把结果喂回来。

并行审查,多个视角盯同一段代码
安装完扩展,Pi 对话里就多了委派能力。
比如你刚改完一段认证逻辑,不用自己一行行盯,直接说跑并行审查,一个看正确性,一个看测试,一个看多余复杂度。
Pi 会拉起三个独立的审查代理,各拿 diff 跑一遍,出各自报告,最后汇总修复清单。
除了审查,侦察代理能在动手前摸清代码结构;执行代理专门按方案改文件;顾问代理做决策把关。
这套分工最大的好处是子代理不被主对话的噪声干扰。
坏处嘛就是默认模型相同,想差异化配置就得多写一点设置。
把重复流程变成一键工作流
单次审查不难,麻烦的是你的团队要求每次提交都跑代码侦察→实现规划→执行编码→并行审查→修复再审查这一整套固定动作,每次手动给 AI 说一遍不现实。
pi-subagents 支持把多个代理串成链式工作流,存下来以后一句命令就能触发整条流水线。
比如刚才那条流程可以存成 scout 侦察、planner 出方案、worker 改代码、三个 reviewer 并行审查、最后 worker 修 bug。
整个过程可以前台跑,也可以丢到后台。后台跑的时候你继续干别的,跑完了 Pi 发通知。
还有一个比较实际的点就是git 工作树隔离。

并行任务如果都往同一个仓库里写文件,代码冲突几乎是必然的。
打开工作树隔离选项之后,每个并行的子代理拿到的都是独立工作副本,各改各的,跑完生成 diff 和补丁,不会污染主分支。
前提是仓库干净、没有未提交的改动,平时习惯保持整洁工作区的人来说基本零成本,但如果习惯攒一堆临时修改再提交,就得先整理一下。
上手体验
前提是你的环境已经正常用着 Pi 编程助手。
pi install npm:pi-subagents装完就能直接用自然语言支使子代理干活,比如对当前改动说一句用审查员看看这个 diff,审查结果会流式显示在对话里。
如果你还希望后台运行的子代理遇到需要拍板的决策时能主动发消息问回来,再装个通信扩展:
pi install npm:pi-intercom装好之后,子代理在长时间后台实现任务时,不会再自己瞎猜,而是通过通信通道把问题抛回主会话。
需要注意的是,子代理默认继承你当前 Pi 会话的模型配置,想给不同角色指定不同模型,得在 settings.json 里写 agentOverrides 配置块。
worktree 隔离依赖干净的工作区,如果你当前仓库有未提交改动,任务会失败。
后台通知只出现在发起任务的那个会话里,切到别的窗口干活可能就就收不到通知了。
开源地址:https://github.com/nicobailon/pi-subagents当你已经日常用 AI 写代码的时候,它让这个助手从单打独斗变成能调遣一支小团队。
并行审查和工作流编排这两项能力,对单人开发是省掉来回对话的时间,对团队则是把散落在每个人本地会话里的审查经验沉淀成可复用流程。
如果你也对这类前沿开源项目感兴趣,想第一时间看到真正有潜力的 GitHub 热门项目解析,关注本公众号。
后面我还会继续挖更多值得收藏、值得实操、值得思考的开源好东西。
夜雨聆风