关于 chief-loop
chief-loop 是以自动模式推动 chief-agent 完成里程碑的技能,直到目标与契约均满足。它按每批 3–5 项处理任务,将实现交给 builder-agent,并为每项任务单独记录决策报告。
主要功能
- 01分批推进里程碑任务
- 02委派实现给 builder-agent
- 03检查目标与契约是否完成
- 04逐项生成决策报告
- 05通过选项处理任务歧义
适用场景
- 01分批执行里程碑中的任务
- 02记录各任务结果与决策
- 03无需暂停等待人工输入地处理任务歧义
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ thaitype/ chief --skill chief-loop安装后在 Claude Code 中输入/chief-loop确认已加载。
详细介绍
贯穿整个里程碑运行 chief-agent,一批接一批,直到目标和契约均已满足;为每项任务分别记录一份考虑了决策过程的报告,而不是每批只写一份汇总报告。
这直接建立在 chief-autopilot 的自动模式之上。如果你希望遇到歧义时「暂停并询问人工」,请改用 chief-autopilot safe——chief-loop 只以自动模式运行,没有等效的安全模式。
前置条件检查
开始前:
- 找出
.chief/下当前启用的里程碑目录。 - 检查
_goal/下至少有一个非空文件。 - 检查
_contract/下至少有一个非空文件。
如果缺少任一项 → 停止。告知用户:
“chief-loop 需要目标和契约。请先运行
/chief-plan。”
不要继续。
开始前确认
向用户简要列出当前目标和契约(每项包含文件名 + 一句话说明)。
询问一个问题:
“目标和契约看起来正确吗?继续运行 chief-loop,还是先使用
/chief-plan修改?”
如果用户表示要修改 → 停止。 如果用户确认 → 继续。
**可选:**如果可以使用 loop-readiness 技能,可提议在继续前针对该里程碑的计划运行此技能——它会检查计划是否涵盖足够的前馈/反馈机制,以便在无人值守的情况下安全运行。如果它标记出计划所依赖的既有门槛,也可提议运行 loop-preflight 来实际执行这些检查并确认仍然通过。这两项都只是建议,不是必需步骤;如果用户拒绝,直接继续即可。
外层循环(根据需要运行任意多批)
1. 创建或更新 TODO
如有现成的 _plan/_todo.md,先阅读。根据目标、契约和已完成的工作,创建接下来一批包含 3–5 项任务的清单——遵循与 chief-autopilot 相同的小批次原则。
写入 _plan/_todo.md。不要等待审批——这是自动驾驶式流程,不暂停等待计划审核。
2. 逐项处理当前批次中的任务
对当前批次中每项尚未完成的任务:
- 将以下内容交给 builder-agent:
- TODO 条目
- 里程碑目标(
_goal/) - 里程碑契约(
_contract/) - 相关全局规则(
.chief/_rules/) - 验证要求
- 等待 builder 完成。
- 如果 builder 报告阻塞问题或歧义,请先按下文处理歧义中的说明处理,再继续。
- 在
_todo.md中将该任务标记为[x]。 - 编写该任务的报告(见下文任务报告)——立即完成,再开始下一项任务。不要等到最后再集中编写报告。
3. 检查里程碑是否完成
完成当前批次的全部任务后:
- 如果目标尚未全部实现,或实现尚未满足契约 → 返回第 1 步并创建下一批任务。
- 如果目标和契约均已满足 → 停止。里程碑已完成。
批次数量不限——持续运行,直到同时满足这两个条件。
处理歧义
builder-agent 报告任务存在阻塞问题或歧义时:
- 启动一个临时 Agent(调用普通的
Agent工具,而不是持久化的 Agent 类型),并提供自包含的提示词:描述歧义及其已知选项,并要求它提出 2–3 个具体选项,每个选项附上一句话说明其权衡。该 Agent 只负责协助分析选项——不作决定,也不写入任何文件。 - chief-agent 审核提议的选项,并自行选择一项——与
chief-autopilot相同,chief-agent 始终是最终决策者。 - 在该任务的报告中记录问题、考虑过的选项,以及最终选择和理由(见下文)。
如果任务没有歧义,则完全跳过本节——不启动任何 Agent,任务报告只需简短、如实地总结。
任务报告
对于每个任务(不只是有歧义的任务),都要编写:
.chief/<milestone>/_report/task-<task-id>-report.md
使用与 _plan/task-<task-id>.md 相同的 <task-id>,确保两个文件一一对应。
# Task <task-id> Report
## Task
One or two lines on what this task was.
## Outcome
done | blocked
## Decision
(Omit this whole section if the task had no ambiguity.)
- **Issue:** what was ambiguous or blocking
- **Options considered:** the options the decision-support agent proposed
- **Chosen:** which one, and why
## Notes
Anything worth carrying into the next task or batch.
规则
- 目标和契约尚未就绪时,绝不开始。
- 绝不跳过入口确认。
- 遇到歧义时,绝不暂停并等待人工输入——此技能仅采用类似自动模式的行为。如果用户希望暂停并询问,请引导他们使用
chief-autopilot safe。 - 对于任何歧义,最终决策始终由 chief-agent 作出——决策支持 Agent 只提供选项建议,绝不作出决定,也绝不写入文件。
- 每个任务完成后立即编写报告,绝不批量补写报告。
- 遵循小批次原则(每个 TODO 周期包含 3–5 个任务)——改变的只是报告的粒度,规划节奏不变。
- 里程碑完成要求同时达成目标并满足契约——仅达成目标不足以结束。
- 所有实现工作均由 Builder-agent 负责。Chief 绝不编写代码。
- 除非用户明确提出要求,否则不使用 Tester-agent。