面向人类与 AI 代理的轻量级任务协调图,通过依赖 DAG 自动派发多代理并行执行。
Workgraph 是一个基于 Rust 构建的 CLI 工具(命令 wg),将工作任务建模为有向依赖图(DAG),通过后台服务守护进程自动在就绪任务上派发 AI 编码代理。每个代理在独立 git worktree 中隔离执行,支持 Claude Code、OpenCode、Codex 等多种助手。
核心能力#
任务图与依赖管理:--after 声明任务间依赖,上游完成自动解锁下游;支持有界循环(测试→修复→验证迭代);--delay、--not-before、cron 控制调度时机;wg viz 输出 ASCII DAG 可视化。
服务模式协调器:wg service start 启动后台守护进程,自动派发代理到就绪任务;支持并发控制(max_agents)、轮询间隔、心跳超时、死代理检测、多协调器、暂停/恢复/冻结/解冻。
AI 代理隔离执行:git worktree 隔离杜绝并行冲突;--exec-mode 三档控制(shell/light/full);--context-scope 控制上下文量;通过 .claude/skills/wg 技能定义深度集成 Claude Code。
验证与审批门控:--verify 附加机器可检查的验证条件;完成后进入 PendingValidation 状态;FLIP(Fidelity of Latent Intent Probe)探测意图一致性;驳回超阈值(默认 3 次)自动标记失败。
组织合成与进化:代理具有角色和权衡配置;四维评分系统评估任务完成质量;进化器重组最优组合实现自优化;auto_evaluate、auto_assign、auto_triage 自动化开关。
通信渠道:wg chat 交互式协调器对话、wg msg 代理间消息;可选集成 Matrix(含 E2EE)、Telegram、Email、Slack(占位)。
TUI 仪表盘:基于 ratatui 的终端交互界面,实时监控任务图与代理状态,内嵌 PTY(wg nex)、语法高亮。
分析与规划:瓶颈检测、关键路径追踪、完成日期预测、工作负载均衡。
模型路由:内置模型注册表支持多 Provider(Claude、OpenAI、OpenRouter 等),按角色分配不同模型。
数据与部署#
任务图以 JSONL 格式持久化在项目本地 .workgraph/ 目录(核心文件 graph.jsonl),Git 友好无需外部数据库。配置分层:全局 ~/.workgraph/config.toml 与项目级 .workgraph/config.toml。图引擎基于 petgraph 0.6,异步运行时 tokio,TUI 层 ratatui 0.30 + crossterm 0.29。支持 Linux、macOS、Windows 跨平台。可通过 feature flags 按需编译 Matrix/Telegram/Email 等通信模块(默认启用 matrix-lite)。Workgraph 自身使用 Workgraph 协调开发。
待确认信息#
- 首次发布日期未在 README 或 Cargo.toml 中标注
- v0.1.0 功能已极其丰富,版本策略待确认
- 官网自举数据(1,724 任务、2,304 评估)为自述无法独立验证
- Slack 集成疑似占位(feature flag 存在但无对应依赖)
- 尚无外部生产使用案例
amplifierexecutor 选项行为未详细说明- Rust edition 2024 最低工具链版本待确认