用途:指导搭建基于任务的多智能体系统,用共享任务文件协调多个智能体并行执行,并通过 git worktree 实现隔离。适用于并行智能体执行、多并发工作流管理、任务队列系统,以及突破单智能体规模限制的场景。
主要能力:以 tasks.md 作为协调机制,区分为 To Do、In Progress、Done 三段。状态标记包括 [](待处理,可领取)、[⏰](阻塞,等待前置)、[🟡, {id}](处理中,已被领取)、[✅ {hash}, {id}](成功完成并记录提交哈希)、[❌, {id}](失败并记录错误原因)。支持标签覆盖行为:#opus、#sonnet 指定模型,#adw_plan_implement、#adw_build 指定工作流。架构为 cron 触发器按间隔轮询 tasks.md,为每个满足条件的任务分配独立 worktree 并行执行。
必要用法:创建 tasks.md 并填写任务;定义任务数据模型(Task,含 description、status、adw_id、commit_hash、tags、worktree_name);编写触发器脚本轮询任务文件并 spawn 子进程;编写任务工作流脚本执行具体命令并回写状态;用 git worktree add trees/{task_id} -b task-{task_id} origin/main 为每个任务创建隔离工作区。协调规则:处理前先声明(立即改为 [🟡]),尊重阻塞(前置未完成不处理 [⏰]),完成后必须更新状态(失败也要更新),并保存提交哈希、错误原因与 ADW ID。
限制与反模式:轮询间隔过短(小于 1 秒)、处理前不声明导致竞态、忽略阻塞任务、未记录失败原因、在同一目录运行而未隔离,均应避免。资料未提供具体成本、平台兼容范围与性能数据。版本历史:v1.0.0(2025-12-26)首次发布,最后更新日期 2025-12-26。