@quintinshaw/pi-dynamic-workflows

让 Pi 把复杂请求写成可断点恢复的 JS 编排脚本,扇出至数十上百个隔离模型实例并行执行。

安装命令
pi install npm:@quintinshaw/pi-dynamic-workflows
临时试用 / 替代安装命令
pi -e npm:@quintinshaw/pi-dynamic-workflows
挂接事件钩子与注册入口
input(关键词触发识别)session_startbefore_agent_startcontextsession_shutdown
pi.registerTool()(工作流脚本执行器)pi.registerCommand("workflows" / "workflows-trigger" / "deep-research")ctx.ui.custom()(/workflows 实时进度面板)

1. 是什么

@quintinshaw/pi-dynamic-workflows是面向大规模并行任务与深度研究的工作流编排扩展。

它还内置 /workflows 交互 TUI 与 /deep-research 命令,并附带 workflow-authoring 与 workflow-patterns 两个指导技能。

2. 解决什么问题

当你需要逐文件审计全仓库上百个路由、或对几十份文档做交叉验证时,把所有子结果在对话里来回传递会瞬间撑爆上下文,且一旦中途失败就得从头重跑。

该扩展让中间状态全部留在 JavaScript 脚本变量与磁盘日志里,模型只拿到最终综合后的结果。

3. 作用原理(事件钩子与工具注册层)

将控制流从自然语言多轮对话下沉为确定性的 JS 原语(agent / parallel / pipeline / phase),配合 worktree 隔离与断点日志。

  • 在交互式输入框提交包含独立单词 workflow / workflows 的请求时,触发器自动授权工作流工具(可通过 /workflows-trigger 修改或关闭);也可通过 /workflows run 显式启动。
  • 主模型根据附带的 workflow-authoring 技能生成一段包含 meta(阶段声明)、phase()、agent()、parallel() 和 pipeline() 的标准 JS 编排脚本。
  • 运行时为每个子任务按 tier(small / medium / big)路由对应模型,需要改代码时可传入 isolation: “worktree” 隔离 Git 工作树;默认最多支持 16 路并发与单次编排 1000 个子代理,同时记录 token 与费用账本。
  • 每个已完成阶段持久化写入运行日志(支持中断后 resume),最终在 Verify 阶段交叉核验并只把汇总答案回传主会话。

4. 怎么装与基本配置

  • 运行 pi install npm:@quintinshaw/pi-dynamic-workflows 并在会话内执行 /reload。
  • 输入 /workflows 查看历史与正在运行的工作流状态、费用明细,或通过 /workflows-trigger off 关闭自然语言关键词自动武装。
  • 建议在配置中为 small / medium / big 三个 tier 分别绑定高性价比与强推理模型以控制扇出成本。

5. 和同类怎么选

它是三个子代理代表包中唯一以“代码即编排(Code-based Orchestration)”为核心范式的扩展。

与同类方案的选型对照

聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。

对比对象 机制差异 怎么选
pi-subagents 侧重单次或少量角色委派与常规链式配合,不需要生成整段编排 JS 脚本。 只需派 1–5 个子任务做常规辅助时选 pi-subagents。
@opengsd/gsd-core(方向 08) GSD 是固定的 Discuss→Plan→Execute→Verify→Ship 五步规格驱动框架;dynamic-workflows 允许模型为当前任务现写任意拓扑的 JS 编排图。 一次性大规模扫描、多视角审计或研究型扇出任务选 @quintinshaw/pi-dynamic-workflows。

同方向对比包与顺序阅读

pi-subagents

Pi 生态下载量最高的子代理扩展,支持单代理委派、角色预设、前后台运行与链式工作流。

阅读该包机制详评

@tintinweb/pi-subagents

带实时 Fleet 面板、终端 Widget、运行中 Steering 与 Claude Code 兼容风格的子代理编排器。

阅读该包机制详评

02 子代理与编排

回到该演进方向总论,查看完整痛点拆解、通用安装注意事项与全部收录清单。

返回方向总论页

看完「@quintinshaw/pi-dynamic-workflows」后的下一步

可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)

从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频

已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)

出口 1(配置单与实机演示制作中)

Coding Agent 实战交付课:如何可控地把想法做成线上产品

由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。

出口 2(实战交付课筹备中)