pi-workflow：让 Pi 执行可复用多步骤工作流

是什么

pi-workflow 面向 Pi，把单轮对话变成可命名、可重复的多步骤运行，内置 deep-research、deep-review、spec-review、impact-review 四种流程。项目使用 JavaScript，拥有 349 stars。

架构与核心设计

工作流以 JSON 阶段图定义，由 Workflow、Task、Support 分别处理图生命周期、子代理任务与工件/运行状态。single、foreach、reduce、loop、dag、dynamic 覆盖单步、遍历、汇聚、循环、嵌套图和自适应调度；结果可检查、停止或恢复。

值得借鉴

自然语言触发降低重复写提示词的成本，显式产物让扇出、验证、汇总可复用；看板从运行、阶段、任务一路追踪到输出，适合把研究、代码评审和规格核验沉淀成团队流程。

坑与边界

它依赖 @agwab/pi-subagent 和 pi-web-access；替换工具提供方时必须保持工具名、参数及结果形状兼容。要求 Node.js >=22.19.0，原生 Windows 不支持；动态流程还依赖受信任的本地控制器，权限、成本与失败恢复需自行约束。