$ cat ~/map/pi-workflow.md

pi-workflow

为 Pi 提供可复用的多步工作流：调研、代码评审、规范检查等。

extensions✓ 10月16日

事实速查

仓库: github.com/AgwaB/pi-workflow ↗
GitHub Stars: ★ 364
Forks: 13
许可证: MIT
npm / 月: —
最后推送: 2026年10月14日

安装

pi install npm:@agwab/pi-workflow

## 速览

pi 的工作流编排——可命名、可复用的多步工作流（深度调研、代码评审、规范一致性、影响面评审），由多个 pi subagent worker 分步执行，并配一个只读 TUI 看板检视每次运行。

## 要点

$基于 @agwab/pi-subagent 构建：跨工作流步骤协调多个 pi subagent worker，在步骤之间传递结果，并记录每次运行，便于检查、停止或恢复。
$一次安装同时提供 /workflow 扩展和两个内置技能：workflow-guide（基于已验证的脚手架模板创建、改造或审查工作流定义）与 execution-router（判断任务该直接做、用定向 verifier，还是走工作流）。
$用自然语言让 pi 按名字调用某个工作流即可，也可以用 /workflow run <name> "task" 确定性地驱动；/workflow dynamic 则规划、扇出、汇总一条自适应的一次性工作流，无需保存定义。
$阶段模式：single（一个提示给一个 subagent）、foreach（按上游控制工件里的 JSON 数组扇出）、reduce（汇总综合）、loop（有界重复）、dag（嵌套图容器）与 dynamic（可信控制器代码用 ctx.agent() 创建任务）。
$内置四个工作流——deep-research、deep-review、spec-review、impact-review——既是可直接运行的默认值也是编写范例，各自产出经审计的 final-report.md；工作流还可声明具名 executionProfiles，用 /workflow run --profile <name> 选择。
$/workflow 看板是一个只读 TUI，可浏览运行、下钻阶段与任务、预览任务输出；编辑器下方的 Active workflows 部件跟踪进度，并通过 .pi/workflows 在会话重载后重建。需要 macOS 或 Linux 上的 Node.js >=22.19.0——原生 Windows 不支持，请用 WSL2。

## 常见问题

Q 怎么创建自己的工作流？

用内置的 workflow-guide 技能，例如 /skill:workflow-guide create a workflow for weekly release readiness——它从常见图结构的已验证脚手架起步，并可把结果保存为可复用的项目工作流。

Q 支持 Windows 吗？

不原生支持。pi-workflow 要求 macOS 或 Linux 上安装 Node.js >=22.19.0；README 建议 Windows 用户使用 WSL2。

Q 怎么更新？

pi update npm:@agwab/pi-workflow。首次 pi install 之后需要重载 pi，/workflow 扩展与内置技能才会加载。

pi-workflow

## 速览

## 要点

## 常见问题

## 参考链接

## 相关条目

## 教程