用途:Saga 用于中大型功能的自主开发,目标是除少数离散节点外基本无需人工干预。编排者负责把粗略提示词变成严密规格,再把实现委派给 worker 子智能体,同时保持自身上下文干净。
主要能力:核心原则包括以严密契约取代良好意愿(任务的验证标准必须明确到几乎不可能做错)、规划阶段不留空白、保护编排者上下文、把验证作为一等公民、保留少量人工触点。每个 saga 存放在仓库外的 ~/.sagas/ 目录下,含 SAGA.md、PROGRESS.md 及 milestones 下的 MILESTONE.md 与任务规格文件,各层级自带验证标准。
使用方式:分三阶段。阶段一为规划与规格生成,与用户协作,用 ask_user_question 提供具体选项,确认环境与工具链,定义 saga 退出标准,拆解里程碑与任务,最后请用户批准规格。阶段二为并行实现与验证,用 run_agents 批量启动 worker,本地 worker 各自使用 git worktree 与分支,命名如 saga/<saga-name>/m<M>t<T>-<task-slug>,创建命令为 git worktree add ../saga-<saga-name>-m<M>t<T> -b saga/<saga-name>/m<M>t<T>-<task-slug> <base>;worker 需自验证、持久化交付后再用 git worktree remove <worktree-path> --force 清理,并紧凑回报。阶段三为最终验证与用户手动验收。
适用场景:需要较少人工干预的中大型功能开发,尤其是可拆分为可并行任务、且能用计算机操作、交互式 CLI 或测试进行验证的工作。
限制:质量取决于阶段一规格的严密程度;需要用户批准规格并做最终验收;验证方法受机器与运行时能力约束;约 10 个以上并发 worker 时建议改用远程执行;除非用户要求,不应提交或开 PR。恢复 saga 需阅读 references/continuing-a-saga.md。