mcpField
C
chief-loop

chief-loop

github.com/thaitypeAgent 工作流6641 次安装5 周前更新
代码仓库

关于 chief-loop

chief-loop 是以自动模式推动 chief-agent 完成里程碑的技能,直到目标与契约均满足。它按每批 3–5 项处理任务,将实现交给 builder-agent,并为每项任务单独记录决策报告。

主要功能

  1. 01分批推进里程碑任务
  2. 02委派实现给 builder-agent
  3. 03检查目标与契约是否完成
  4. 04逐项生成决策报告
  5. 05通过选项处理任务歧义

适用场景

  1. 01分批执行里程碑中的任务
  2. 02记录各任务结果与决策
  3. 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 只以自动模式运行,没有等效的安全模式。

前置条件检查

开始前:

  1. 找出 .chief/ 下当前启用的里程碑目录。
  2. 检查 _goal/ 下至少有一个非空文件。
  3. 检查 _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. 逐项处理当前批次中的任务

对当前批次中每项尚未完成的任务:

  1. 将以下内容交给 builder-agent:
    • TODO 条目
    • 里程碑目标(_goal/)
    • 里程碑契约(_contract/)
    • 相关全局规则(.chief/_rules/)
    • 验证要求
  2. 等待 builder 完成。
  3. 如果 builder 报告阻塞问题或歧义,请先按下文处理歧义中的说明处理,再继续。
  4. 在 _todo.md 中将该任务标记为 [x]。
  5. 编写该任务的报告(见下文任务报告)——立即完成,再开始下一项任务。不要等到最后再集中编写报告。
3. 检查里程碑是否完成

完成当前批次的全部任务后:

  • 如果目标尚未全部实现,或实现尚未满足契约 → 返回第 1 步并创建下一批任务。
  • 如果目标和契约均已满足 → 停止。里程碑已完成。

批次数量不限——持续运行,直到同时满足这两个条件。

处理歧义

builder-agent 报告任务存在阻塞问题或歧义时:

  1. 启动一个临时 Agent(调用普通的 Agent 工具,而不是持久化的 Agent 类型),并提供自包含的提示词:描述歧义及其已知选项,并要求它提出 2–3 个具体选项,每个选项附上一句话说明其权衡。该 Agent 只负责协助分析选项——不作决定,也不写入任何文件。
  2. chief-agent 审核提议的选项,并自行选择一项——与 chief-autopilot 相同,chief-agent 始终是最终决策者。
  3. 在该任务的报告中记录问题、考虑过的选项,以及最终选择和理由(见下文)。

如果任务没有歧义,则完全跳过本节——不启动任何 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。

评论

支持 Markdown