flower-trellis 0.3.1 → 0.4.0-beta.1

package/README.md

@@ -82,7 +82,7 @@ flower-trellis -v
 | `--target <dir>` | 目标目录(默认当前目录) |
 | `--no-update-check` | 本次跳过 flower-trellis 新版本检测(等价环境变量 `FLOWER_NO_UPDATE_CHECK=1`) |
 
-未指定平台时,交互模式会弹出多选菜单(默认勾选 Claude Code + Codex);也可直接传 `--claude` / `--codex` / `--cursor` 等指定,或用 `-y` 跳过菜单。其余未识别的 flag(如 `-u`、`-f`、`--template`)一律透传给 Trellis。
+未指定平台时,交互模式会弹出多选菜单(默认勾选 Claude Code + Codex);也可直接传 `--claude` / `--codex` / `--cursor` / `--devin` / `--zcode` / `--trae` 等指定,或用 `-y` 跳过菜单。`--windsurf` 仍作为 Devin 的旧别名透传给 Trellis。其余未识别的 flag(如 `-u`、`-f`、`--template`、`--with-statusline`)一律透传给 Trellis。
 
 ### 自动版本检测
 

package/enhancements/0.6/.agents/skills/trellis-auto-loop/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: trellis-auto-loop
+description: "启动、恢复和推进 Trellis 自动任务循环。用于用户明确要求 auto loop、自动跑任务、/goal 类似流程、一次跑多个任务、继续自动 run、查看/停止 auto-loop，或压缩恢复后需要从 .trellis/scripts/auto_loop.py 读取下一步。"
+---
+
+# Trellis Auto Loop
+
+用 `.trellis/scripts/auto_loop.py` 驱动一个接近 `/goal` 的任务循环。Python runner 是状态权威；本 skill 只负责把用户意图映射到 runner 命令，并按 runner 返回的 action 调用现有 Trellis workflow / skill / subagent。
+
+## 核心规则
+
+- 只有用户明确要求自动跑、auto loop、goal-like、继续自动 run、批量任务队列时才启动或恢复；不要把普通实现请求自动升级为 auto-loop。
+- 每次开始、恢复、压缩后继续时，先运行 runner 的 `resume` 或 `next`，不要凭聊天摘要推断下一步。
+- 每完成一个 action，必须用 `record --action <next 返回的 action>` 精确写回结果；runner 会拒绝缺失或不匹配的 action。写回后立即再调用 `next`，直到 `done`、`blocked` 或需要用户决策。
+- 默认 profile 是 `commit-only`：自动推进到本地 commit，不 push、不发布、不归档。
+- 多任务只按用户显式给出的任务顺序执行；同一 worktree 不并发。
+- 启动 runner 前先完成 route 准备度判断：已有当前任务 runtime route 决策或个人 `.trellis/.route-prefs.tmp` 时可启动；没有时先进入 `trellis-route` 正常询问 / fallback，写入真实决策后再启动。
+- auto-loop 不默认写 `route_authorization`；如果未来显式传 route 参数，只能表示用户本次明确给出的临时策略，不能当成模型真实执行结果。
+- 代码提交必须走 `trellis-push` 的 commit-only 语义；不要裸 `git commit` / `git push`。
+
+## 启动
+
+用户给了任务列表时，按原顺序传入；用户只说当前任务时，用 `task.py current --source` 的当前任务。
+
+启动前对当前任务执行 route 准备度检查：
+
+```bash
+python3 .agents/skills/trellis-route/scripts/route_state.py resolve --target implement
+python3 .agents/skills/trellis-route/scripts/route_state.py resolve --target check
+```
+
+如果任一 target 返回 `status=miss`，先按 `trellis-route` 的正常 numbered fallback 询问用户并写入 runtime；不要替用户默认 inline 或 subagent。route 准备完成后启动 runner：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py start \
+  --tasks <task> [<task> ...] \
+  --profile commit-only
+```
+
+多任务队列中，当前任务切换到下一个任务且缺少该任务 route 决策时，回到 `trellis-route` 获取该任务真实选择，再继续 `next` / `record`。个人 `.trellis/.route-prefs.tmp` 会由 `trellis-route` 统一复用并写回 runtime。
+
+启动后立即运行：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py next
+```
+
+## 恢复
+
+压缩、重开会话、用户说“继续自动跑 / continue auto loop”时：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py resume
+python3 ./.trellis/scripts/auto_loop.py next
+```
+
+`resume_capsule` 只用于展示；下一步以 `next` 返回的 JSON 为准。
+
+## Action 映射
+
+| runner action | 主 agent 动作 | 成功 record |
+| --- | --- | --- |
+| `refresh_brief` | 使用 `trellis-task-brief` 生成并展示 brief | `record --action refresh_brief --result ok` |
+| `start_task` | 执行返回的 `task.py start ...` 命令 | `record --action start_task --result ok` |
+| `run_implement` | 进入 Phase 2.1，先用 `trellis-route(target=implement)` 决定 inline/subagent，再实现 | `record --action run_implement --result ok --route-mode <mode> --route-source <source>` |
+| `run_check_all` | 进入 Phase 2.2，先用 `trellis-route(target=check)`，执行 check-all | `record --action run_check_all --result ok --route-mode <mode> --route-source <source>` |
+| `run_fix` | 根据 `last_failure` 修复，复用当前任务 implement route | `record --action run_fix --result ok --route-mode <mode> --route-source <source>` |
+| `run_recheck` | 复用当前任务 check route，重新 check-all | `record --action run_recheck --result ok --route-mode <mode> --route-source <source>` |
+| `run_spec_update` | 有代码/测试证据时用 `trellis-update-spec`；无必要更新也 record ok | `record --action run_spec_update --result ok` |
+| `commit_only` | 进入 `trellis-push` commit-only 语义：先由 AI 基于 task artifacts 与 git diff 生成提交计划，只提交当前任务可归属文件 | 执行成功后 `record --action commit_only --result ok --commit <hash>` |
+
+失败时写回：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py record \
+  --action <action> \
+  --result failed \
+  --failure-type <type> \
+  --summary "<失败摘要>" \
+  --files <file> [<file> ...]
+```
+
+需要用户产品决策或越权时写回 blocked：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py record \
+  --action <action> \
+  --result blocked \
+  --failure-type <type> \
+  --summary "<阻塞原因>"
+```
+
+runner 会按 3 轮 fix/recheck 预算决定继续、跳过当前任务或结束队列。
+
+route action 成功回写时必须带上 `trellis-route` 输出里的真实 `mode` / `source`，例如
+`--route-mode inline --route-source route-prefs` 或
+`--route-mode check-all-subagent --route-source trellis-route`；不要写 auto-loop 默认值。
+
+## Commit-Only 预授权
+
+auto-loop 的 `commit-only` profile 是用户对“当前 run 内任务相关本地提交”的一次性预授权。只有同时满足这些条件时，`trellis-push` 可以跳过二次聊天确认：
+
+- `.trellis/scripts/auto_loop.py status` 显示当前 `run_status=running`，且 `outstanding_action.action=commit_only`、`outstanding_action.task` 等于当前活动任务。
+- profile 是 `commit-only`。
+- 模式是 commit-only，不 push、不 merge、不发布、不归档。
+- AI 已基于当前任务 artifacts、`git status`、`git diff` 和必要的文件内容生成提交计划，并能说明每个 planned file 为什么属于当前任务。
+- 提交计划只包含当前任务可归属文件；未识别 dirty 文件保留未提交并写入结果摘要。
+- 执行前复核 git 状态仍与计划一致。
+
+如果计划包含未识别 staged 文件、冲突、push/merge/release/archive、真实外部系统或生产数据效果，停止并把当前任务记为 blocked。
+
+不要用脚本基于时间差或 dirty baseline 猜测文件归属；语义归属由 AI 负责判断，`trellis-push` 负责展示/复核计划、精确暂存 planned files、执行本地 commit，并把 commit hash 回写 runner。预检不安全时只把当前队列项记为 blocked/skipped，并让 auto-loop 可继续后续任务。
+
+## 状态与停止
+
+查看：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py status
+```
+
+停止：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py stop --reason "<原因>"
+```
+
+## 不要做
+
+- 不要手写或手改 `.trellis/.runtime/auto-loop/*.json`。
+- 不要把 `.trellis/.runtime/` 或 `.trellis/.route-prefs.tmp` 加入提交。
+- 不要在 auto-loop 外把普通 check 的 post-check stop gate 当成可跳过。
+- 不要为模糊需求自动创建任务并开跑；先回到 Trellis planning。

package/enhancements/0.6/.agents/skills/trellis-push/SKILL.md

@@ -8,6 +8,8 @@ description: "提交并推送配置仓库，可选合并到目标分支，并同
 
 核心原则：**先计划、一次确认、后执行**。在任何 `git add`、`git commit`、`git push`、`git merge` 之前，必须先展示完整执行计划，并获得用户确认。
 
+例外：当 `trellis-auto-loop` 已显式以 `profile=commit-only` 启动，且 runner 当前有 `outstanding_action.action=commit_only` 时，用户启动 auto-loop 本身就是本次 run 内任务相关本地提交的预授权。此时仍必须由 AI 生成并自检提交计划，但可跳过二次聊天确认；计划只允许 commit-only、不 push/merge/release/archive，并在成功后把 commit hash 回写 runner。预检不安全时只标记当前 auto-loop item blocked/skipped，后续队列仍可继续。
+
 支持多仓库（frontend / backend 等），merge 目标分支记录在 `.trellis/config.yaml` 的 `packages.<name>.merge_target` 中。
 
 ---
@@ -62,9 +64,24 @@ Step 6  输出结果
 | 重新配置 | 本次允许重新指定 merge 目标，并回写 `merge_target` | `重新配置 push 目标分支` / `reconfigure push` |
 | 临时目标 | 本次临时指定 merge 目标，不修改配置 | `push 到 hotfix 分支` |
 | snapshot-only | 不提交业务代码，只写入 / 同步任务进度快照 | `只更新 snapshot` / `snapshot-only` |
+| auto-loop commit-only | 由 `trellis-auto-loop` runner 的 `commit_only` action 触发，只提交本任务可归属文件，不二次确认、不 push | `trellis-auto-loop` 内部触发 |
 
 `snapshot-only` 只在用户明确要求时使用。它仍必须展示统一执行计划；`pushed_commits` 取计划中确认的现有 commit，或按用户说明记录。
 
+### 0.1.1 auto-loop commit-only 判定
+
+只有同时满足以下条件，才可走 auto-loop 预授权路径：
+
+- `.trellis/scripts/auto_loop.py status` 显示当前 `run_status=running`，profile 为 `commit-only`。
+- status 摘要里的 `outstanding_action.action` 是 `commit_only`，且 `outstanding_action.task` 等于当前活动任务。
+- 本次 `trellis-push` 语义是 commit-only，不包含 push / merge / release / archive。
+- 计划拟提交文件全部能归属当前任务；未识别 dirty 文件不纳入提交。
+- 执行前复核 git 状态与计划一致。
+
+任一条件不满足时，不得使用预授权。普通 `trellis-push` 继续走“展示计划并等待确认”的规则。
+
+auto-loop 预授权路径不使用额外提交 helper。AI 负责根据当前任务 artifacts、`git status`、`git diff` 和必要的文件内容判断文件归属，输出 planned files / retained files / commit message / 归属理由；`trellis-push` 负责边界复核：当前 action/profile/task 匹配、staged 区为空、无冲突、planned files 当前 dirty、planned files 不含 `.trellis/.runtime/`、`.trellis/.route-prefs.tmp`、其他任务目录或未解释文件。通过后只 `git add` planned files 并执行本地 commit，随后回写 `auto_loop.py record --action commit_only --result ok --commit <hash> ...`。预检失败时回写 `record --result blocked`，该 blocked 只影响当前 item；auto-loop runner 后续 `next` 应继续寻找后续 pending 任务。只有 merge/rebase 冲突、repo 状态不可读、脚本损坏或用户明确 stop 才停止整个 run。
+
 ### 0.2 发现候选 Git 仓库
 
 读取 `.trellis/config.yaml` 中的 `packages` 配置，但不要把 `git: true` 当作唯一仓库发现规则。`git: true` 主要用于 Trellis session context 展示独立包仓库状态；`trellis-push` 必须以实际 Git root 为准发现可提交仓库：
@@ -131,7 +148,7 @@ git log <base_branch>..HEAD --oneline
 
 ## Step 2: 生成统一执行计划
 
-这是唯一的常规确认点。**确认前禁止执行任何 `git add` / commit / push / merge / task.json 写入。**
+这是唯一的常规确认点。**确认前禁止执行任何 `git add` / commit / push / merge / task.json 写入。** 唯一例外是已满足 Step 0.1.1 的 auto-loop commit-only 预授权；该路径仍要生成计划并执行自检，只是不再等待用户二次确认。
 
 ### 2.1 生成业务提交计划
 

package/enhancements/0.6/.agents/skills/trellis-route/SKILL.md

@@ -13,9 +13,9 @@ description: |
 
 # Trellis 路由器：implement / check 执行模式选择
 
-主 agent 进入 Phase 2.1 实现路由或 Phase 2.2 检查路由时调用本 skill。当前上下文或 session runtime state 内已有合法来源的最近 route 决策时，后续实现、修复、重检默认复用该决策；没有合法决策时才进入本 skill 或同编号 fallback。提交前确实需要最终复查时，回到 Phase 2.2 并复用当前任务的合法 check route，除非用户明确要求重选。
+主 agent 进入 Phase 2.1 实现路由或 Phase 2.2 检查路由时调用本 skill。当前上下文或 session runtime state 内已有合法来源、target 匹配、且 task 等于当前任务路径的最近 route 决策时，后续实现、修复、重检默认复用该决策；没有合法决策时才进入本 skill 或同编号 fallback。提交前确实需要最终复查时，回到 Phase 2.2 并复用当前任务的合法 check route，除非用户明确要求重选。
 
-个人配置只写入 `.trellis/.route-prefs.tmp`。该文件匹配 `.trellis/.gitignore` 的 `*.tmp` 规则，属于开发者本地偏好，不纳入 git，也不影响其他开发者。
+个人配置只写入 `.trellis/.route-prefs.tmp`。该文件匹配 `.trellis/.gitignore` 的 `*.tmp` 规则，属于开发者本地偏好，不纳入 git，也不影响其他开发者。auto-loop 可在 `.trellis/.runtime/auto-loop/<run-id>.json` 写入临时 route 授权；它不是个人偏好，优先级低于 `.route-prefs.tmp`，只用于减少 auto 模式下的交互打断。
 
 本轮 route 决策写入当前 session runtime 文件 `.trellis/.runtime/sessions/<context-key>.json` 的 `route_decisions` 字段。该文件匹配 `.trellis/.gitignore` 的 `.runtime/` 规则，只保存当前 AI session/window 的执行状态，用于压缩后恢复；它不是任务属性，不写入 `.trellis/tasks/**`，也不是长期团队配置。
 
@@ -25,9 +25,9 @@ description: |
 
 个人 route 配置只决定“已获准执行后的模式”，不是开工授权。调用 helper 前，必须确认当前 workflow 已允许进入对应 target：implement 需要任务已完成规划确认并处于 `in_progress`；check 用于 Phase 2.2 检查执行，或用户明确要求最终复查 / 轻量检查。最终复查只有在 Phase 2.2 结果缺失、风险较高或用户明确要求复查时才回到 Phase 2.2；回到 Phase 2.2 后优先复用当前任务的合法 check route，除非用户明确要求重选/临时改/清除默认。如果仍在 planning、等待用户确认，或用户表达“等一下 / 我再想想”，停止，不读取 runtime/prefs。
 
-合法 route 决策必须能追溯到 `trellis-route`、同编号 fallback 选项，或由本 skill 读取到的有效 `.trellis/.route-prefs.tmp` 配置。runtime state 只能保存和恢复这些原始合法来源，不能把 `.runtime` 自身当成新的 `route_decision.source`。用户自然语言说过“inline/subagent”、compact summary、SessionStart 摘要、`codex-mode`、空 `.route-prefs.tmp`、旧单值偏好，都不能单独作为有效 route 决策。
+合法 route 决策必须能追溯到 `trellis-route`、同编号 fallback 选项、由本 skill 读取到的有效 `.trellis/.route-prefs.tmp` 配置，或由 route helper 校验过的 auto-loop 临时 route 授权，并且 `task` 字段必须等于当前 `task.py current --source` 返回的任务路径。runtime state 只能保存和恢复这些原始合法来源，不能把 `.runtime` 自身当成新的 `route_decision.source`。用户自然语言说过“inline/subagent”、compact summary、SessionStart 摘要、`codex-mode`、空 `.route-prefs.tmp`、旧单值偏好，都不能单独作为有效 route 决策。
 
-当前上下文内已有 target 匹配且来源合法的 route 决策时，后续实现、check 发现问题、用户指出刚检查过的实现有问题、修复后重检、提交前复查均默认复用最近 implement/check 路由；除非用户明确要求重选/临时改/清除默认，不再调用本 skill。当前上下文没有 route 决策但 runtime state 命中时，本 skill 恢复该决策并输出同样的结构化 `route_decision`。
+当前上下文内已有 target 匹配、task 等于当前任务路径、且来源合法的 route 决策时，后续实现、check 发现问题、用户指出刚检查过的实现有问题、修复后重检、提交前复查均默认复用最近 implement/check 路由；除非用户明确要求重选/临时改/清除默认，不再调用本 skill。当前上下文没有 route 决策但 runtime state 命中时，本 skill 恢复该决策并输出同样的结构化 `route_decision`。如果上下文里只有上一个任务的 `route_decision`，必须忽略并重新解析当前任务。
 
 Codex inline mode 只表示主会话默认直接执行，不是 route 选项过滤器。即使当前上下文出现 `<codex-mode>inline...do not dispatch...</codex-mode>` 或 `workflow-state:in_progress-inline`，也不能推断“只能 inline”或跳过 subagent 选项；仍必须通过 helper resolve runtime/prefs，或在无有效配置时展示正常 inline/subagent 选项。若本 skill 的紧邻路由决定是 subagent，本步骤允许主 agent dispatch 对应 implement/check sub-agent；禁止的是绕过 `trellis-route` 直接 dispatch。
 
@@ -50,7 +50,7 @@ Codex inline mode 只表示主会话默认直接执行，不是 route 选项过
 
 ## Step 0.5: 解析已有 route state
 
-仅在没有覆盖意图、当前上下文没有 target 匹配的合法 `route_decision` 时调用 helper 解析已有状态。helper 的解析顺序固定为：当前 session runtime 文件里的 `route_decisions` → `.trellis/.route-prefs.tmp`。命中 `.route-prefs.tmp` 时，helper 会自动把 `source=route-prefs` 的决策写回当前 session runtime，后续压缩恢复不需要再次读 prefs。
+仅在没有覆盖意图、当前上下文没有 target + 当前 task 匹配的合法 `route_decision` 时调用 helper 解析已有状态。helper 的解析顺序固定为：当前 session runtime 文件里的 `route_decisions` → `.trellis/.route-prefs.tmp` → `.trellis/.runtime/auto-loop/<run-id>.json` 临时授权。命中 `.route-prefs.tmp` 或 auto-loop 临时授权时，helper 会自动把对应决策写回当前 session runtime，后续压缩恢复不需要再次读 prefs 或 auto-loop 状态。
 
 调用随本 skill 分发的 helper；不要在对话中内嵌或改写 helper 逻辑：
 
@@ -60,7 +60,7 @@ python3 .agents/skills/trellis-route/scripts/route_state.py resolve --target <im
 python3 .claude/skills/trellis-route/scripts/route_state.py resolve --target <implement|check>
 ```
 
-helper 只接受当前 session 或唯一 session fallback 的 `.trellis/.runtime/sessions/<context-key>.json`，并只从 `route_decisions.<target>` 恢复决策。命中时输出 `{"status":"hit", ...}`，其中默认输出里的 `mode` / `source` 已经过 task/target/source/mode/scope 校验，可跳过 Step 2 并进入 Step 3 输出决策。`origin=route-prefs` 表示来自个人 route 配置，并且 helper 已写回 session runtime state；`origin=runtime` 表示来自 session runtime state。
+helper 只接受当前 session 或唯一 session fallback 的 `.trellis/.runtime/sessions/<context-key>.json`，并只从 `route_decisions.<target>` 恢复当前任务的决策。命中时输出 `{"status":"hit", ...}`，其中默认输出里的 `task` / `mode` / `source` 已经过 task/target/source/mode/scope 校验，可跳过 Step 2 并进入 Step 3 输出决策。`origin=route-prefs` 表示来自个人 route 配置，并且 helper 已写回 session runtime state；`origin=auto-loop` 表示来自 auto-loop 临时授权且 helper 已写回 session runtime state；`origin=runtime` 表示来自 session runtime state。
 
 helper 默认输出为精简 JSON，只包含 route 执行必需的 `status`、`origin`、`mode`、`source`/`reason` 等字段。需要排查完整 `decision`、session 文件、context key、任务路径、个人配置路径或写回标记时，在同一命令末尾加 `--verbose`；不要为了诊断信息额外读取 runtime 文件。
 
@@ -181,7 +181,9 @@ python3 .agents/skills/trellis-route/scripts/route_state.py clear-pref --target
 python3 .claude/skills/trellis-route/scripts/route_state.py clear-pref --target <implement|check>
 ```
 
-helper 写入规则：保留另一个 target 的 runtime 决策和偏好；覆盖当前 target；`source` 保持原始合法来源，正常 skill 交互用 `trellis-route`，普通聊天编号 fallback 用 `numbered-fallback`，prefs 命中由 helper 写 `route-prefs`；保留 session runtime 文件中的 `platform`、`current_task`、`current_run` 等既有字段；内部 `task` 必须写当前 `task.py current --source` 的任务路径。写入失败不阻塞本次 route 输出，但要在回复中简短说明未持久化，压缩后可能再次询问。
+helper 写入规则：保留另一个 target 的 runtime 决策和偏好；覆盖当前 target；`source` 保持原始合法来源，正常 skill 交互用 `trellis-route`，普通聊天编号 fallback 用 `numbered-fallback`，prefs 命中由 helper 写 `route-prefs`，auto-loop 临时授权命中由 helper 写 `auto-loop`；保留 session runtime 文件中的 `platform`、`current_task`、`current_run`、`current_auto_run` 等既有字段；内部 `task` 必须写当前 `task.py current --source` 的任务路径。写入失败不阻塞本次 route 输出，但要在回复中简短说明未持久化，压缩后可能再次询问。
+
+当同一 session 从一个任务切换到另一个任务时，helper 写入当前任务任一 target 的决策前会清理 runtime 中属于其他任务的 `route_decisions`。个人默认仍保留在 `.trellis/.route-prefs.tmp`；清理只影响当前 session 的临时恢复状态，目的是避免新任务的 check 阶段误复用上一个任务的 check 路由。
 
 ---
 
@@ -205,6 +207,7 @@ helper 写入规则：保留另一个 target 的 runtime 决策和偏好；覆
 ```markdown
 路由决定：<inline/subagent> <implement | check-all | check>
 [来自个人 route 配置：`.trellis/.route-prefs.tmp` (<key>=<value>)。]
+[来自 auto-loop 临时 route 授权：`.trellis/.runtime/auto-loop/<run-id>.json`。]
 [来自 session runtime route state：`.trellis/.runtime/sessions/<context-key>.json` 的 `route_decisions`。]
 [已写入 session runtime route state：`.trellis/.runtime/sessions/<context-key>.json` 的 `route_decisions`。]
 [说明：用户明确请求轻量检查，使用隐藏逃生口。]
@@ -212,8 +215,9 @@ helper 写入规则：保留另一个 target 的 runtime 决策和偏好；覆
 route_decision:
   target: <implement | check>
   mode: <inline | subagent | check-all-inline | check-all-subagent | check-inline | check-subagent>
-  source: <trellis-route | route-prefs | numbered-fallback>
+  source: <trellis-route | route-prefs | auto-loop | numbered-fallback>
   scope: task
+  task: <current task path>
 
 接下来主 agent 应当：
 - <路由表里对应的工具调用形式>
@@ -223,7 +227,7 @@ route_decision:
 - <要避免的工具调用>
 ```
 
-中括号内行为条件性出现：仅命中个人配置时显示配置行；仅命中 runtime state 时显示“来自”行；写入 runtime state 成功时显示“已写入”行；仅轻量 check 时显示隐藏逃生口说明；仅 implement subagent + skip_compile=true 时附加“跳过编译”段。`route_decision` 必须保留在回复中，但默认只保留 target/mode/source/scope；需要 task/path/decided_at 等诊断字段时重新调用 helper 并加 `--verbose`。compact summary 若只有自然语言描述，后续 agent 仍应优先读取 runtime state，而不是把 summary 当证据。
+中括号内行为条件性出现：仅命中个人配置时显示配置行；仅命中 runtime state 时显示“来自”行；写入 runtime state 成功时显示“已写入”行；仅轻量 check 时显示隐藏逃生口说明；仅 implement subagent + skip_compile=true 时附加“跳过编译”段。`route_decision` 必须保留在回复中，并至少保留 target/mode/source/scope/task；需要 path/decided_at 等诊断字段时重新调用 helper 并加 `--verbose`。compact summary 若只有自然语言描述，后续 agent 仍应优先读取 runtime state，而不是把 summary 当证据。
 
 ---
 
@@ -233,13 +237,14 @@ route_decision:
 2. **runtime state 私有**：`.trellis/.runtime/sessions/` 是 session/window 状态，gitignored，不能进入提交计划。
 3. **压缩恢复少打断**：当前上下文没有 route 决策时，先读 runtime state；命中当前任务/target 的合法决策就复用，不查 `trellis mem`，也不重问。
 4. **个人默认次于本轮决策**：runtime state 表示“本轮已选”，优先于 `.route-prefs.tmp`。
-5. **显式覆盖优先于一切**：用户要求临时改、重新选择或清除默认时，必须重新展示选项，不能让 runtime state 或配置优先。
-6. **当前任务复用路由**：当前任务内已有合法来源的最近 implement/check 路由时，后续实现、修复、重检和复查默认沿用，不再次询问模式。
-7. **check 默认全面检查**：普通 check 路由只展示 `check-all` inline/subagent，不推荐轻量 `trellis-check`。
-8. **轻量 check 是隐藏逃生口**：只有用户明确请求 `light check` / `轻量检查` 时才可走轻量 `trellis-check`。
-9. **决策与执行分离**：本 skill 只输出指令，下一轮由主 agent 调工具。
-10. **严格执行用户选择**：路由结论一旦输出，主 agent 必须按指令执行，不可“出于谨慎”再换路径。
-11. **Codex inline 不裁剪选项**：Codex inline 是默认执行模式，不是只能 inline 的强制模式；route 明确选中 subagent 时，本步骤可按 subagent 路径执行。
+5. **auto 授权低于个人默认**：auto-loop 临时授权只在 runtime 和个人偏好都 miss 时生效。
+6. **显式覆盖优先于一切**：用户要求临时改、重新选择或清除默认时，必须重新展示选项，不能让 runtime state 或配置优先。
+7. **当前任务复用路由**：当前任务内已有合法来源的最近 implement/check 路由时，后续实现、修复、重检和复查默认沿用，不再次询问模式。
+8. **check 默认全面检查**：普通 check 路由只展示 `check-all` inline/subagent，不推荐轻量 `trellis-check`。
+9. **轻量 check 是隐藏逃生口**：只有用户明确请求 `light check` / `轻量检查` 时才可走轻量 `trellis-check`。
+10. **决策与执行分离**：本 skill 只输出指令，下一轮由主 agent 调工具。
+11. **严格执行用户选择**：路由结论一旦输出，主 agent 必须按指令执行，不可“出于谨慎”再换路径。
+12. **Codex inline 不裁剪选项**：Codex inline 是默认执行模式，不是只能 inline 的强制模式；route 明确选中 subagent 时，本步骤可按 subagent 路径执行。
 
 ---
 

package/enhancements/0.6/.agents/skills/trellis-route/scripts/route_state.py

@@ -12,7 +12,7 @@ from pathlib import Path
 from typing import Any
 
 
-VALID_SOURCES = {"trellis-route", "numbered-fallback", "route-prefs"}
+VALID_SOURCES = {"trellis-route", "numbered-fallback", "route-prefs", "auto-loop"}
 VALID_MODES = {
     "implement": {"inline", "subagent"},
     "check": {
@@ -83,6 +83,7 @@ def _output(args: argparse.Namespace, data: dict[str, Any], verbose: dict[str, A
 def _decision_summary(decision: dict[str, Any]) -> dict[str, Any]:
     """提取默认输出需要的最小 route 决策字段。"""
     return {
+        "task": decision.get("task"),
         "mode": decision.get("mode"),
         "source": decision.get("source"),
     }
@@ -129,6 +130,16 @@ def _pref_path(repo_root: Path) -> Path:
     return repo_root / ".trellis/.route-prefs.tmp"
 
 
+def _auto_loop_dir(repo_root: Path) -> Path:
+    """返回 auto-loop runtime 目录。"""
+    return repo_root / ".trellis/.runtime/auto-loop"
+
+
+def _auto_loop_pointer(repo_root: Path) -> Path:
+    """返回当前 auto-loop run 指针文件。"""
+    return _auto_loop_dir(repo_root) / "current.json"
+
+
 def _read_prefs(repo_root: Path) -> dict[str, str]:
     """读取个人 route 默认配置，只保留合法 key-value。"""
     path = _pref_path(repo_root)
@@ -149,6 +160,74 @@ def _read_prefs(repo_root: Path) -> dict[str, str]:
     return prefs
 
 
+def _running_auto_run_paths(repo_root: Path) -> list[Path]:
+    """扫描当前项目内所有 running auto-loop run。"""
+    running: list[Path] = []
+    for path in sorted(_auto_loop_dir(repo_root).glob("auto-*.json")):
+        state = _read_json(path)
+        if state.get("status") == "running":
+            running.append(path)
+    return running
+
+
+def _auto_state_path(repo_root: Path, run_id: Any) -> Path | None:
+    """把 run id 转成状态文件路径，非法值返回 None。"""
+    if not isinstance(run_id, str) or not run_id.strip():
+        return None
+    return _auto_loop_dir(repo_root) / f"{run_id.strip()}.json"
+
+
+def _auto_route_mode(repo_root: Path, context_key: str, target: str) -> tuple[str | None, Path | None, str | None]:
+    """读取当前 running auto-loop run 的临时 route 授权。
+
+    auto 授权低于个人 `.route-prefs.tmp`，只在当前 session runtime 绑定了
+    running `current_auto_run`，或全局 current 指针能指向 running run 时生效。
+    如果这些指针 stale，则忽略 stale pointer，并 fallback 到唯一 running run。
+    """
+    session_path = _session_path(repo_root, context_key)
+    session = _read_json(session_path)
+    candidate_paths: list[Path] = []
+    stale_paths: list[Path] = []
+
+    for run_id in (session.get("current_auto_run"), _read_json(_auto_loop_pointer(repo_root)).get("run_id")):
+        path = _auto_state_path(repo_root, run_id)
+        if path is None:
+            continue
+        state = _read_json(path)
+        if state.get("status") == "running":
+            candidate_paths.append(path)
+        else:
+            stale_paths.append(path)
+
+    if not candidate_paths:
+        candidate_paths = _running_auto_run_paths(repo_root)
+    unique_paths = []
+    seen: set[str] = set()
+    for path in candidate_paths:
+        key = str(path)
+        if key in seen:
+            continue
+        seen.add(key)
+        unique_paths.append(path)
+    if len(unique_paths) != 1:
+        reason = "no-unique-auto-run"
+        if stale_paths and not unique_paths:
+            reason = "stale-auto-run-pointer"
+        return None, stale_paths[0] if stale_paths else None, reason
+
+    path = unique_paths[0]
+    state = _read_json(path)
+
+    auth = state.get("route_authorization")
+    if not isinstance(auth, dict):
+        return None, path, "no-route-authorization"
+
+    mode = auth.get(target)
+    if mode in PREF_MODES[target]:
+        return mode, path, None
+    return None, path, "invalid-auto-route-mode"
+
+
 def _write_prefs(repo_root: Path, prefs: dict[str, str]) -> None:
     """写入个人 route 默认配置；为空则删除文件。"""
     path = _pref_path(repo_root)
@@ -218,6 +297,13 @@ def _write_runtime_decision(
     decisions = context.get("route_decisions")
     if not isinstance(decisions, dict):
         decisions = {}
+    # 同一 AI session 可能连续处理多个 Trellis 任务。写入新任务的任一路由时，
+    # 先丢弃旧任务的 runtime 决策，避免后续 check 阶段绕过 helper 时误复用上个任务的选择。
+    decisions = {
+        key: value
+        for key, value in decisions.items()
+        if isinstance(value, dict) and value.get("task") == current_task
+    }
     decision = _decision(target, mode, source, current_task)
     decision["decided_at"] = now
     decisions[target] = decision
@@ -280,7 +366,7 @@ def read_runtime(args: argparse.Namespace) -> int:
 
 
 def resolve_route(args: argparse.Namespace) -> int:
-    """按 runtime → prefs 的优先级解析 route 决策。"""
+    """按 runtime → prefs → auto-loop 的优先级解析 route 决策。"""
     repo_root = _repo_root()
     if repo_root is None:
         return _print({"status": "miss", "reason": "not-trellis-project"})
@@ -337,15 +423,45 @@ def resolve_route(args: argparse.Namespace) -> int:
             }
         )
 
+    auto_mode, auto_path, auto_reason = _auto_route_mode(repo_root, context_key, args.target)
+    if auto_mode in PREF_MODES[args.target]:
+        written_path, auto_decision = _write_runtime_decision(
+            repo_root,
+            context_key,
+            current_task,
+            args.target,
+            auto_mode,
+            "auto-loop",
+        )
+        return _output(
+            args,
+            {
+                "status": "hit",
+                "origin": "auto-loop",
+                **_decision_summary(auto_decision),
+            },
+            {
+                "decision": auto_decision,
+                "path": _rel_path(repo_root, written_path),
+                "auto_path": _rel_path(repo_root, auto_path) if auto_path else None,
+                "pref_path": _rel_path(repo_root, _pref_path(repo_root)),
+                "context_key": context_key,
+                "task": current_task,
+                "wrote_runtime": True,
+            }
+        )
+
     return _output(
         args,
         {
             "status": "miss",
-            "reason": "no-valid-decision-or-pref",
+            "reason": "no-valid-decision-pref-or-auto",
         },
         {
             "path": _rel_path(repo_root, path),
             "pref_path": _rel_path(repo_root, _pref_path(repo_root)),
+            "auto_reason": auto_reason,
+            "auto_path": _rel_path(repo_root, auto_path) if auto_path else None,
             "context_key": context_key,
             "task": current_task,
         }

package/enhancements/0.6/.claude/skills/trellis-auto-loop/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: trellis-auto-loop
+description: "启动、恢复和推进 Trellis 自动任务循环。用于用户明确要求 auto loop、自动跑任务、/goal 类似流程、一次跑多个任务、继续自动 run、查看/停止 auto-loop，或压缩恢复后需要从 .trellis/scripts/auto_loop.py 读取下一步。"
+---
+
+# Trellis Auto Loop
+
+用 `.trellis/scripts/auto_loop.py` 驱动一个接近 `/goal` 的任务循环。Python runner 是状态权威；本 skill 只负责把用户意图映射到 runner 命令，并按 runner 返回的 action 调用现有 Trellis workflow / skill / subagent。
+
+## 核心规则
+
+- 只有用户明确要求自动跑、auto loop、goal-like、继续自动 run、批量任务队列时才启动或恢复；不要把普通实现请求自动升级为 auto-loop。
+- 每次开始、恢复、压缩后继续时，先运行 runner 的 `resume` 或 `next`，不要凭聊天摘要推断下一步。
+- 每完成一个 action，必须用 `record --action <next 返回的 action>` 精确写回结果；runner 会拒绝缺失或不匹配的 action。写回后立即再调用 `next`，直到 `done`、`blocked` 或需要用户决策。
+- 默认 profile 是 `commit-only`：自动推进到本地 commit，不 push、不发布、不归档。
+- 多任务只按用户显式给出的任务顺序执行；同一 worktree 不并发。
+- 启动 runner 前先完成 route 准备度判断：已有当前任务 runtime route 决策或个人 `.trellis/.route-prefs.tmp` 时可启动；没有时先进入 `trellis-route` 正常询问 / fallback，写入真实决策后再启动。
+- auto-loop 不默认写 `route_authorization`；如果未来显式传 route 参数，只能表示用户本次明确给出的临时策略，不能当成模型真实执行结果。
+- 代码提交必须走 `trellis-push` 的 commit-only 语义；不要裸 `git commit` / `git push`。
+
+## 启动
+
+用户给了任务列表时，按原顺序传入；用户只说当前任务时，用 `task.py current --source` 的当前任务。
+
+启动前对当前任务执行 route 准备度检查：
+
+```bash
+python3 .agents/skills/trellis-route/scripts/route_state.py resolve --target implement
+python3 .agents/skills/trellis-route/scripts/route_state.py resolve --target check
+```
+
+如果任一 target 返回 `status=miss`，先按 `trellis-route` 的正常 numbered fallback 询问用户并写入 runtime；不要替用户默认 inline 或 subagent。route 准备完成后启动 runner：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py start \
+  --tasks <task> [<task> ...] \
+  --profile commit-only
+```
+
+多任务队列中，当前任务切换到下一个任务且缺少该任务 route 决策时，回到 `trellis-route` 获取该任务真实选择，再继续 `next` / `record`。个人 `.trellis/.route-prefs.tmp` 会由 `trellis-route` 统一复用并写回 runtime。
+
+启动后立即运行：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py next
+```
+
+## 恢复
+
+压缩、重开会话、用户说“继续自动跑 / continue auto loop”时：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py resume
+python3 ./.trellis/scripts/auto_loop.py next
+```
+
+`resume_capsule` 只用于展示；下一步以 `next` 返回的 JSON 为准。
+
+## Action 映射
+
+| runner action | 主 agent 动作 | 成功 record |
+| --- | --- | --- |
+| `refresh_brief` | 使用 `trellis-task-brief` 生成并展示 brief | `record --action refresh_brief --result ok` |
+| `start_task` | 执行返回的 `task.py start ...` 命令 | `record --action start_task --result ok` |
+| `run_implement` | 进入 Phase 2.1，先用 `trellis-route(target=implement)` 决定 inline/subagent，再实现 | `record --action run_implement --result ok --route-mode <mode> --route-source <source>` |
+| `run_check_all` | 进入 Phase 2.2，先用 `trellis-route(target=check)`，执行 check-all | `record --action run_check_all --result ok --route-mode <mode> --route-source <source>` |
+| `run_fix` | 根据 `last_failure` 修复，复用当前任务 implement route | `record --action run_fix --result ok --route-mode <mode> --route-source <source>` |
+| `run_recheck` | 复用当前任务 check route，重新 check-all | `record --action run_recheck --result ok --route-mode <mode> --route-source <source>` |
+| `run_spec_update` | 有代码/测试证据时用 `trellis-update-spec`；无必要更新也 record ok | `record --action run_spec_update --result ok` |
+| `commit_only` | 进入 `trellis-push` commit-only 语义：先由 AI 基于 task artifacts 与 git diff 生成提交计划，只提交当前任务可归属文件 | 执行成功后 `record --action commit_only --result ok --commit <hash>` |
+
+失败时写回：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py record \
+  --action <action> \
+  --result failed \
+  --failure-type <type> \
+  --summary "<失败摘要>" \
+  --files <file> [<file> ...]
+```
+
+需要用户产品决策或越权时写回 blocked：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py record \
+  --action <action> \
+  --result blocked \
+  --failure-type <type> \
+  --summary "<阻塞原因>"
+```
+
+runner 会按 3 轮 fix/recheck 预算决定继续、跳过当前任务或结束队列。
+
+route action 成功回写时必须带上 `trellis-route` 输出里的真实 `mode` / `source`，例如
+`--route-mode inline --route-source route-prefs` 或
+`--route-mode check-all-subagent --route-source trellis-route`；不要写 auto-loop 默认值。
+
+## Commit-Only 预授权
+
+auto-loop 的 `commit-only` profile 是用户对“当前 run 内任务相关本地提交”的一次性预授权。只有同时满足这些条件时，`trellis-push` 可以跳过二次聊天确认：
+
+- `.trellis/scripts/auto_loop.py status` 显示当前 `run_status=running`，且 `outstanding_action.action=commit_only`、`outstanding_action.task` 等于当前活动任务。
+- profile 是 `commit-only`。
+- 模式是 commit-only，不 push、不 merge、不发布、不归档。
+- AI 已基于当前任务 artifacts、`git status`、`git diff` 和必要的文件内容生成提交计划，并能说明每个 planned file 为什么属于当前任务。
+- 提交计划只包含当前任务可归属文件；未识别 dirty 文件保留未提交并写入结果摘要。
+- 执行前复核 git 状态仍与计划一致。
+
+如果计划包含未识别 staged 文件、冲突、push/merge/release/archive、真实外部系统或生产数据效果，停止并把当前任务记为 blocked。
+
+不要用脚本基于时间差或 dirty baseline 猜测文件归属；语义归属由 AI 负责判断，`trellis-push` 负责展示/复核计划、精确暂存 planned files、执行本地 commit，并把 commit hash 回写 runner。预检不安全时只把当前队列项记为 blocked/skipped，并让 auto-loop 可继续后续任务。
+
+## 状态与停止
+
+查看：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py status
+```
+
+停止：
+
+```bash
+python3 ./.trellis/scripts/auto_loop.py stop --reason "<原因>"
+```
+
+## 不要做
+
+- 不要手写或手改 `.trellis/.runtime/auto-loop/*.json`。
+- 不要把 `.trellis/.runtime/` 或 `.trellis/.route-prefs.tmp` 加入提交。
+- 不要在 auto-loop 外把普通 check 的 post-check stop gate 当成可跳过。
+- 不要为模糊需求自动创建任务并开跑；先回到 Trellis planning。