QuintinShaw/pi-dynamic-workflows

解决的问题

解决在执行广泛且复杂的任务（如代码库全面审计、大规模重构或深度研究）时，单个代理上下文窗口的局限性——这些任务过于庞大，无法通过一个提示和一次会话有效处理。

工作原理

Pi 生成一个确定性的 JavaScript 编排脚本，将高层次请求分解为更小、可管理的任务。该脚本使用一组运行时全局变量来管理执行过程：

• 分发：生成多个相互隔离的子代理，可并行运行（最多同时 16 个）。
• 路由：根据任务复杂度，将任务路由到不同模型层级（small、medium、big）或特定提供者。
• 验证：系统使用内置的 verify() 和 judgePanel() 等模式，交叉验证多个代理的结果，再合成最终答案。
• 隔离：代理可在独立的 git worktree 上运行，防止并行编辑时发生冲突。
• 可恢复性：工作内容被记录在日志中，允许用户在中断后恢复运行，或仅重放脚本中修改的部分，而无需为未更改的步骤浪费 token。

适用人群

使用 Pi 生态系统，需要自动化多步骤、多代理工作流以审计、审查或研究大量数据和代码的开发者和研究人员。

主要亮点

• 并行编排：支持最多 1,000 个子代理并行运行，具备高并发能力。
• 模型分层：根据成本与性能需求，在不同模型大小间动态路由。
• 日志化恢复：支持缓存感知的重放，中断或脚本修改后避免重复 token 消耗。
• Git Worktree 隔离：通过临时分支实现安全的并行文件编辑。
• 内置模式：提供深度研究、对抗性审查和代码库审计的预定义工作流。
• 实时监控：提供进度面板，可实时追踪阶段、token 使用量和成本。