autodev

/autodev

/autodev 管理仓库本地的自主开发操作契约。 它不会取代 evolve 或 rpi。

循环中的位置

这是 操作循环 每次迭代读取的配置／意图层——它本身不是循环。/autodev 定义并验证 PROGRAM.md/AUTODEV.md 中声明的契约——可变范围、不可变范围、验证命令、升级规则、停止条件。驱动程序（evolve 和 Factory，即守护进程）会使用该契约并运行循环；autodev 本身不会运行循环。自主运行期间仍须遵守循环纪律：未通过波次有效性检查，不得并行执行波次；未通过映射到 Given/When/Then 的测试，不得关闭切片；捕获的内容必须经过晋级棘轮，而不是丢进垃圾堆。

• PROGRAM.md 或 AUTODEV.md 定义契约：可变范围、不可变范围、实验单元、验证命令、决策策略、升级规则和停止条件。
• ao autodev 会创建、检查并验证该契约。
• evolve 运行 v2 自主改进循环。
• 操作循环运行一次 research -> plan -> implement -> validate 生命周期。

路由

在 Claude Code 中，/autodev 会将工作作为技能调用交给 /evolve 或 /rpi。 终端包装器仍供人类或非技能运行时使用；它们不是默认的技能交接方式。

当用户询问旧的 evolve 流程是否应变成新命令或技能时，请按以下方式区分：

意图	操作
定义或修复仓库本地的自主策略	使用 /autodev 和 ao autodev
运行自主改进循环	调用 /evolve
运行一次有界生命周期	调用 /rpi

PROGRAM.md 的优先级高于 AUTODEV.md。将 AUTODEV.md 视为兼容性别名。

执行步骤

步骤 1：检测契约

if [ -f PROGRAM.md ]; then
  PROGRAM_PATH=PROGRAM.md
elif [ -f AUTODEV.md ]; then
  PROGRAM_PATH=AUTODEV.md
else
  PROGRAM_PATH=
fi

如果契约存在，请先验证再使用：

ao autodev validate --json ${PROGRAM_PATH:+--file "$PROGRAM_PATH"}

如果契约不存在，且用户要求初始化或定义循环，则创建一个：

ao autodev init "<objective>"

如果目标明确，请根据用户请求推断目标。只有当无法从仓库上下文中确定目标，且自行编造会误导契约时，才进行询问。

步骤 2：修复或说明验证失败

验证失败时，检查缺失字段；如果用户要求创建或修复契约，则修补程序文件。必需的部分：

• Objective
• Mutable Scope
• Immutable Scope
• Experiment Unit
• Validation Commands
• Decision Policy
• Escalation Rules
• Stop Conditions

尽量缩小可变范围，并使用具体的验证命令。如果所需工作超出不可变范围，请创建或更新 bead，而不是悄悄扩大契约范围。

步骤 3：交接给循环

ao autodev validate 通过后：

• 对于一次生命周期，在当前会话中运行操作循环；若循环必须在会话外运行，则使用 NTM/Agent Mail 或 ao agent。
• 对于重复的自主循环，调用 /evolve（由技能驱动），或通过 NTM 分派它以在会话外运行。
• 如果 PROGRAM.md 和 GOALS.md 同时存在，GOALS.md 表示战略适应度，PROGRAM.md 是操作执行层。

不要仅仅因为主要测试通过，就将自主周期标记为成功。程序验证套件和停止条件也必须满足。

示例

User: turn this postmortem/analyze/plan/pre-mortem/implement/validate loop into
a v2 command.
Agent: Explain that `evolve` runs the loop, then create or validate
`PROGRAM.md` with `/autodev` so the loop has explicit scope and gates.

ao autodev init "Continuously improve AgentOps skills within explicit scope."
ao autodev validate
# then run the repeated loop: /evolve (skill-driven; /evolve CLI retired, ag-llni)

故障排查

问题	响应
找不到 PROGRAM.md	请求设置时，运行 ao autodev init "<objective>"。
验证报告缺少部分	补齐缺失的必需部分，然后重新运行 ao autodev validate --json。
请求的工作超出不可变范围	停止直接编辑，并创建 bead 或请求明确变更契约。
用户询问“这是 evolve 吗？”	回答：autodev 定义循环契约；evolve 运行循环。

参考文档

• references/autodev.feature — 可执行规范：受契约约束的无人值守循环；管理而非替代 evolve/rpi；自主运行下的循环纪律（soc-qk4b）
• references/autodev-cli.feature — 可执行规范：ao autodev CLI 命令行为，关联到 cmd 测试（soc-jnfgi）