osolmaz/pi-workflows

解决的问题

pi-workflows 解决了管理复杂、多步骤 AI 代理任务的问题，这些任务需要结合 LLM 推理、确定性代码执行和人工监督。与其依赖单一长提示或不可预测的代理循环，它允许开发者定义结构化、持久化的流程，可暂停、恢复并监控。

如何工作

它作为 Pi 编码代理的扩展，允许用户将流程定义为 TypeScript 图。这些图由节点（如 agent 用于 LLM 提示、compute 用于 TS 函数、shell 用于命令、checkpoint 用于人工输入）和决定执行路径的边组成。

关键技术组件包括：

• 持久执行：状态持久化在本地 SQLite 数据库中，意味着流程可以承受重启或暂停以进行人工决策。
• 集成：通过 Pi 对话中的 /workflow 命令触发流程，保持当前讨论的上下文。
• 可视化：专用终端查看器（piw）提供流程进度和历史的实时、框式图表示。
• 资源管理器：声明式系统，用于保持长时间运行的自动化与外部状态（如监控 PR）同步。

适用人群

本工具专为使用 Pi 编码代理的开发者设计，他们需要自动化复杂的软件工程流水线——如自动规划、实现和验证——同时保持对过程的细粒度控制。

主要亮点

• TypeScript 图定义：使用类型安全的 TS API 定义复杂逻辑、循环和分支。
• 人机协同：内置对受保护的人工决策和检查点的支持。
• 实时监控：交互式 TUI 查看器，支持重放步骤和检查追踪。
• 预构建技能：包含自动规划、自动实现和健全性检查的内置流程。
• Herdr 集成：与 Herdr 环境深度集成，实现无缝面板管理。