AgwaB/pi-workflow

解决的问题

pi-workflow 提供了一种运行复杂、多步骤 AI 代理工作流的方法，这些工作流可重复且结构化。它不依赖于单一提示，而是允许用户定义确定性流程——例如深度研究或代码审查——其中多个子代理可以并行或顺序工作，以实现高质量结果。

工作原理

系统将工作组织为“阶段图”，将自然语言任务通过一系列定义步骤进行处理。它使用 @agwab/pi-subagent 协调工作器，并支持多种执行模式：

• Single：针对一个子代理的单一聚焦提示。
• Foreach：动态分叉，一个代理生成项目列表，然后由独立代理处理每个项目。
• Reduce：汇聚合成，将多个上游步骤的结果合并为最终报告。
• Loop：在满足停止条件前进行有限次重复。
• DAG：用于复杂组织结构的嵌套图。
• Dynamic：使用控制器代码动态创建任务的自适应编排。

适用人群

需要自动化重复性高、高风险任务（如架构审查、规范符合性检查、项目特定团队流程）的 Pi 生态系统开发者和团队。

特色亮点

• 预打包工作流：包含 deep-research、deep-review、spec-review 和 impact-review 的预定义模板。
• 可视化监控：内置 TUI 工作流面板（/workflow），可检查运行进度、深入阶段、查看任务工件。
• 可自定义：用户可使用 workflow-guide 技能创建或调整工作流。
• 执行配置文件：支持自定义命名的配置文件（如 low、medium、high），用于控制工作流的执行方式。
• 自适应路由：execution-router 技能可帮助判断任务是否需要单个代理、特定工作流或目标验证器。