Task Coordinator 提供将 Claude Code 原生 Task 系统(TaskCreate、TaskUpdate、TaskGet、TaskList)集成到工作流编排中的模式。
用途:适用于含 3 个以上顺序步骤、需要进度可见性的工作流;带依赖跟踪的并行执行;需要崩溃恢复的长时工作流;需要持久状态的跨会话工作。
主要能力:任务生命周期管理(创建、置为 in_progress、完成);通过 metadata 约定(workflow、step、milestone、phase、parallel_group)组织任务;依赖映射(addBlockedBy,先建全部任务再设依赖);并行执行(所有 Task() 调用须在同一消息中发出);结果聚合;基于 YAML 账本的里程碑检查点与崩溃恢复;跨会话持久化(通过 CLAUDE_CODE_TASK_LIST_ID 环境变量);自动清理与错误处理。
使用方式:先做配置检查(task_tracking.enabled 等),未启用则跳过所有 Task 操作。按完整步骤模式创建任务、更新状态、在里程碑写检查点。恢复时读取账本,依据状态(无文件、completed、in_progress、failed、解析错误)决定全新开始或从检查点继续。
限制:任务跟踪失败不得阻塞工作流执行,需优雅降级;原生 Tasks 为主、账本为辅,冲突时以 Tasks 为准;跨会话持久化需将任务列表 ID 外部存储。具体配置项默认值与平台支持以实际环境为准。