auto

name	auto
description	当用户输入 `~auto-技能名 任务`，或要求全自动、无人值守、自动执行、一口气做完、 做完为止、不要问我、无限循环、跑完为止、搞定为止时使用；`~stop`、Ctrl+C 或“中断/停止” 也属于本技能的控制语境。
metadata	{"openclaw":{"emoji":"🤖"}}

auto — 全自动前缀执行技能

执行前置

遵循当前目录 AGENTS.md「技能执行公共契约」；仅按需读取技能正文与 reference。

以 ~auto-<目标技能> <任务> 为前缀包装任意技能为无人值守模式：唯一的一次用户交互 发生在启动时（权限+配置一次性预授权），此后严格 0 交互，自动循环调用目标技能及其 子技能链直至收敛，只有强制中断（Ctrl+C / ~stop）才会停止。

核心原则

1. 前缀式包装，不重复实现：auto 不复制任何目标技能的细节流程，以 ~auto-<skill> 前缀驱动目标技能（all/make/debug/optim/test/...），细节以目标技能 SKILL.md 为权威 （吸收 all 的"编排层不重复发明细节"原则）。
2. 一次性预授权（全程唯一的交互）：启动即请求"本次任务全部权限 + 全部配置"， 授权按级别分级（L1 全授权含破坏性 / L2 常规授权 / 自定义清单），配置含工作目录、 轮数上限、停滞阈值、收尾动作；用户确认后在终端摘要中说明，本任务不再有任何请求。
3. 0 交互承诺：预授权后不发起任何形式的用户请求（不提问、不确认、不征询）； 目标技能流程中的"需确认/需询问"步骤一律按预授权配置自动决定 （L1 直接执行；L2 跳过并在终端摘要说明；自定义按配置项执行）。 0 交互 ≠ 0 报告：每轮简报、停滞报告、中断报告、最终汇总照常输出。
4. 自动循环直至收敛：复用 all 的收敛判据（①通过标准全部达成 ②收益 <5% ③连续两轮无实质变化 ④用户终止），每轮留证据（$ 命令 + 退出码 + 实测输出）， 收敛后自动进入收尾，不空转。
5. 无限循环与停滞保护并存：默认无轮数上限（除非启动配置 max_rounds）； 停滞保护防空转——连续 N 轮（默认 3）无实质进展时自动换方向（先 debug 后 optim， 一轮一动作）；三个不同方向均无进展时输出停滞报告并继续尝试新方向， 除非配置 stop_on_stall=true（默认 true，避免无限空转烧资源）。
6. 强制中断随时生效：Ctrl+C / 用户输入 ~stop/中断/停止/新指令 → 立即停止 循环并产出中断报告（进度/已改动/遗留/恢复方式）；每轮开始前检查中断信号。
7. 收敛后自动收尾：按启动配置执行 diff 复查（--check）→ init 归集（如产物为 agent 生成内容）→ tag 打标（如配置启用）→ 汇总输出；全部自动化，不询问。
8. 诚实原则不豁免：0 交互不豁免验证——每轮结论以实测为证（退出码/数值/输出）， 无法验证的项标注原因；不虚报收敛与收益；授权范围之外的操作一律不做。
9. 安全边界：权限请求只收集本次任务所需，不索取无关权限；不修改系统/工具的 权限配置（预授权是会话内约定，落地为"本会话不再询问"）；破坏性操作仅按 预授权级别执行（L2 自动跳过并在终端摘要说明）。

触发时机

• 用户以前缀形式触发：~auto-<技能名> <任务>（如 ~auto-all 优化xxx、 ~auto-make 做一个xxx、~auto-debug 修复xxx）
• 用户要求全自动执行："全自动"、"无人值守"、"自动执行"、"一口气做完"、 "做完为止"、"不要问我"、"无限循环"、"跑完为止"、"搞定为止"
• 与其他技能配合：目标技能未指定 → 默认 all（全流程收敛编排）； 目标技能不存在 → 启动时列出候选供一次性确认； 纯单步任务（debug/optim/test/analy）→ 直接以单技能为目标的 auto 模式； 多独立子任务 → ~auto-dispatch 并行派发（子代理批量执行后整合）
• 不适用：任务需要持续人工决策/评审（如内容创作风格、架构评审）→ 用对应技能常规模式

工作流程

Step 0. 解析前缀与任务

输入: ~auto-<target> <task>
target = 前缀中的技能名（all/make/debug/optim/test/analy/diff/tag/init/plan/review/
         tdd/skill-creator/up/dispatch/auto 之一）；缺省默认 all
task   = 前缀后的完整任务描述

• target 不在技能表 → 在 Step 1 的清单中列出候选技能供用户一次性选择（唯一交互窗口）；
• 在终端摘要中说明目标技能与任务定义。

Step 1. 一次性授权与配置收集（唯一交互）

输出如下清单并请求一次确认（此后不再有任何请求）： 原则：第一次请求必须问全——预授权清单一次性覆盖本次任务可能产生的所有用户请求 （含 [3] 中按目标技能预判的全部配置项），严禁分批提问、事后补问。

=== ~auto-<target> 预授权清单 ===
任务: <task>
目标技能: <target>（将调用其子技能链: <推断的链>）

[1] 授权级别（必选）:
  L1 全授权 —— 含破坏性操作（删除文件/改写已推送标签/force push），按需执行
  L2 常规授权 —— 常规操作（bash/文件写/本地 Git 查询与改动/网络/长时运行）；
                提交、推送和对外发布仍须用户明确要求，破坏性操作跳过并在终端说明 ← 默认
  自定义 —— 在下方注明放行/禁止项

[2] 关键配置:
  工作目录: <当前目录/指定目录>
  收敛判据: 继承目标技能（通过标准全达成 + 收益<5% + 连续2轮无实质变化）
  停滞阈值: 连续 <3> 轮无实质进展即换方向; 方向穷尽后 stop_on_stall=<true>
  轮数上限: <无限/指定 N>
  收尾动作: diff(必做) / init(按需) / tag(按需)
  中断指令: Ctrl+C 或输入 ~stop/中断/停止

[3] 本次任务的明确配置项（由任务性质决定，如测试设备/精度、目标路径等）:
  <按目标技能需预收集的配置，列于此>

请确认（输入 Y / 选择级别或调整后确认 / N 取消）：

• 用户确认后：授权级别与全部配置在终端摘要中说明，进入 0 交互模式；
• 用户取消（N）→ 结束会话，不执行任务。

Step 2. 0 交互驱动目标技能

按目标技能 SKILL.md 执行，全程不发起请求：

• target=all → 以预配置的收敛判据驱动全流程编排（其内部再调用各子技能）；
• target=make → 单次全流程生成（解析需求→调查规划→实现→测试→优化→复查→归档→打标）；
• target=其他单技能 → 按该技能 SKILL.md 执行；
• 目标技能流程中出现"需用户确认"步骤 → 按预授权自动决定： L1 直接执行；L2 跳过并在终端说明；自定义按配置项执行——不中断、不提问；
• 每次调用子技能在终端摘要中汇总其结果与路径（如有）。

Step 3. 自动循环与停滞保护

目标技能自身有循环（all）时以之为准；无循环（单技能）且任务未收敛时按如下循环：

1. 每轮开始：检查中断信号（用户新指令/Ctrl+C/~stop）→ 有则进入 Step 5 中断收尾；
2. 执行 → 验证 → 记录（$ 命令 + 退出码 + 实测输出）；
3. 收敛检查（判据：通过标准全达成 / 收益<5% / 连续 2 轮无实质变化）→ 满足则进入 Step 4；
4. 未收敛：评估本轮主导问题（失败→debug 轮；性能→optim 轮；修复与优化分轮）； 连续 N 轮（停滞阈值，默认 3）无实质进展 → 换方向（先 debug 后 optim）； 三个不同方向均无进展且 stop_on_stall=true → 输出停滞报告并停止循环进入 Step 4 （记录"方向穷尽"证据）；stop_on_stall=false → 继续换方向尝试；
5. 轮数达上限（如配置）→ 停止，报告权衡，进入 Step 4。

Step 4. 收尾（自动化）

按启动配置依次执行，全程不询问：

1. 改动复查（diff）：git diff --check + git diff --stat 概览 + 逐文件详情； 边界校验（冲突标记/调试残留/未跟踪/二进制/重命名）；
2. skill 归集（init，配置启用时）：agent 生成内容对应的完整 skill 归集到技能库；
3. 版本标签（tag，配置启用时）：先看后打，注释标签消息格式 follow <前一标签>, 1. 变更一; [opencode].；标签操作不自动 push；

Step 5. 中断与恢复

收到中断信号（Ctrl+C / ~stop / 新指令）时：

1. 立即停止当前循环（不启动新一轮）；
2. 产出中断报告：已完成进度、本轮已改动（文件:行号）、遗留项、恢复方式 （下次从何处继续、当前轮次为断点）；
3. 不执行未预授权的收尾动作（如 tag）——中断即终止，收尾仅做 diff 复查与汇总。

Step 6. 汇总（结构化输出）

✓ auto 执行完成/中断
   目标:   <target> / <task>
   授权:   <级别 L1/L2/自定义 + 关键配置摘要>
   收敛:   <判据达成明细 / 中断原因 / 停滞报告摘要>
   轮数:   <N 轮（第 N 轮: <结论>; ...）>
   改动:   <文件清单与关键改动>
   子技能: <各子技能结果/路径，如有>
   标签:   <tag 结果，无则省略>
   Git:    <git diff --check 与定向复查结果；无 Git 或无改动则跳过>
   遗留:   <未收敛项/待用户确认项/恢复建议>

声明前自检：输出"收敛/完成"前逐项核对——每个结论均有本次会话刚运行的 验证输出（退出码/数值）为证；缺失证据的项改为"未验证"或补跑后更新。

错误处理

场景	处理
前缀目标技能不存在	Step 1 清单中列出候选技能，用户一次性选择后继续（唯一交互窗口内解决）
用户取消预授权	结束会话，不执行任务
目标技能强制要求交互（如 brainstorm HARD-GATE）	预授权模式跳过批准闸门，决策在终端摘要中说明；用户可在 Step 1 配置为"仍要求该步骤交互"
停滞且方向穷尽	输出停滞报告（证据：各方向改动与收益）；stop_on_stall=true 停止，false 继续换方向
中断信号	立即停止循环，产出中断报告（进度/改动/遗留/恢复方式）
破坏性操作未预授权（L2）	跳过并在终端摘要中说明，不执行
网络失败/超时	按目标技能错误处理（debug 循环重试/换源），在终端摘要中说明重试
轮数达上限	停止，报告权衡与证据
用户中途改目标	视为中断+新任务：输出中断报告后重新解析前缀，重置轮数
0 交互模式下证据缺失	不宣称完成；补跑验证或标注"未验证"，如实报告

注意事项

• auto 是前缀包装器：不重复实现目标技能的细节流程，细节以各技能 SKILL.md 为权威；
• 0 交互 ≠ 0 报告：每轮简报、停滞/中断报告、最终汇总照常输出（报告不是请求）；
• 权限请求只收集本次任务所需，不索取无关权限；不修改系统/工具的权限配置；
• 破坏性操作只在本会话内按预授权级别执行；改动按公共契约检查，不自动提交或推送；
• 不越界访问工作目录之外的内容；