flower-trellis 0.5.5 → 0.5.6-beta.1

package/README.md

@@ -64,6 +64,9 @@ flower-trellis self-update --target . --yes
 # 管理启动更新检查策略
 flower-trellis update-check get --target .
 
+# 查看或修改匿名安装遥测开关
+flower-trellis telemetry status
+
 # 卸载:移除 Trellis 本体并清理强化包残留
 flower-trellis uninstall
 
@@ -73,6 +76,8 @@ flower-trellis -v
 
 > 已全局安装时可直接写 `flower-trellis`、`ftl` 或 `ft`(三者等价);未安装则在命令前加 `npx`。
 
+为统计安装活跃度和版本分布，CLI 默认在远程版本检查及 `init` / `update` 成功后上报随机设备 ID、Flower/Trellis 版本、项目 `.trellis/.developer` 名称和运行平台；不采集 MAC、主机名、系统用户名、项目路径或仓库地址。可用 `flower-trellis telemetry disable` 持久停用，或用 `FLOWER_NO_TELEMETRY=1` 临时停用。
+
 ### 命令
 
 | 命令 | 说明 |
@@ -82,6 +87,7 @@ flower-trellis -v
 | `self-check` | 输出启动更新检查 JSON,供 Codex / Claude Code hook 和 AI 自动化读取 |
 | `self-update` | 受控升级 flower-trellis 并对目标项目执行完整 `flower-trellis update` 重叠加 |
 | `update-check` | 管理 `.trellis/.flower-manifest.json` 内的启动更新检查策略 |
+| `telemetry` | 查询、启用或停用用户级匿名安装遥测 |
 | `plugin` | 管理 Flower Plugin、Marketplace 来源、GitLab 授权和作者校验 |
 | `uninstall` | 移除 Trellis 本体并清理强化包残留(支持 `-y` / `--dry-run`) |
 | `<其它命令>` | 原样透传给 Trellis,覆盖其现有及未来子命令 |
@@ -113,6 +119,8 @@ flower-trellis plugin
 
 交互管理器采用 `发现 / 已安装 / 来源 / 问题` 四个页签。Trellis 项目的 `发现` 页会展示 `flower/skill-garden` 内置入口，按 Enter 直接管理工作流强化与可选通用技能；原 `flower-trellis skill` 命令继续保留为高级兼容入口。`发现` 同时合并全部已启用来源的 Plugin，并保留来源标签和即时搜索；未登录 GitLab 来源会直接进入 Device Flow，GitHub 公共来源无需登录。`来源` 页的“新增来源”可选择 GitHub 公共仓库或 GitLab Marketplace；GitHub 会先在临时缓存中下载固定快照、检测格式、展示可导入与忽略组件，确认后才保存。ref 留空时使用仓库默认分支；出现多个格式入口时会要求选择，公开 GitHub 跨仓 Marketplace 条目和 `plugins/*` 多 Plugin 仓库也可识别。
 
+可选通用技能包含 `aliyun-sls-query`，可为 Codex / Claude 项目安装零第三方依赖的阿里云 SLS 查询脚本与排障知识；默认不安装，也不会复制用户私有 AK/SK 配置。
+
 安装、更新和卸载都会先展示 dry-run、依赖、capability 和目标文件变化，确认后才写入项目。Plugin 作者使用的 `plugin init`、`plugin validate` 继续保留在高级命令中，不占用普通用户的管理器首页。
 
 独立的 `plugin add` 只建立最小 Plugin Runtime,安装目标 Plugin 及其显式依赖,不会隐式安装 `skill-garden`,因此交互管理器也可以在没有 `.trellis/` 的普通项目中使用。

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

@@ -16,7 +16,7 @@ description: "启动、恢复和推进 Trellis 自动任务循环。用于用户
 - `record` 返回 `status=retryable` 时保留的是同一个 outstanding Check action：不得运行 `next`，必须先按返回指令消解漂移并重录。
 - 本地提交是自动终点。不得 push、merge、release、deploy、finish-work 或 archive；queue item 完成后 Trellis task 仍保持 `in_progress`。
 - 任务顺序只决定稳定调度顺序，不隐含依赖。依赖必须通过 `--depends-on dependent=dependency` 明确传入或由 planning artifacts 明确声明。
-- 任务级失败只阻塞自身及显式依赖项；独立任务继续。fix/recheck 与 planning repair 各最多 3 轮，队列结束后不自动执行第二遍恢复扫描。
+- 任务级失败只阻塞自身及显式依赖项；独立任务继续。fix/recheck、planning repair 与安全的 commit-only repair 各最多 3 轮，队列结束后不自动执行第二遍恢复扫描。
 - schema 1 runtime 继续按 runner 返回的旧 action 恢复，包括 outstanding `confirm_brief`；不要把旧 run 改写成 schema 2。
 
 启动或恢复前静默清除交互式 pre-check hold；miss、task mismatch 或损坏诊断不阻断 runner：
@@ -105,7 +105,7 @@ python3 ./.trellis/scripts/auto_loop.py decide \
 | `run_fix` | 根据 `last_failure` 修复并复用 implement route | `record --action run_fix --result ok --route-mode <mode> --route-source <source>` |
 | `run_recheck` | 复用 check route，且不得低于 `minimum_check_depth` | 同 `run_check_all`，action 改为 `run_recheck` |
 | `run_spec_update` | 执行 `trellis-update-spec` | `no-op|written` 用 ok；`needs-review` 用 blocked + `spec-needs-review` |
-| `commit_only` | 复用 `trellis-push` 内部精确本地提交能力，不 push | `record --action commit_only --result ok --commit <hash> --files <exact...> --commit-message "..."` |
+| `commit_only` | 复用 `trellis-push` 内部多仓精确本地提交能力，不 push | `record --action commit_only --result ok --commit <primary-or-last-hash> [--repo-commit <repository>::<hash> ...] --files <exact...> --commit-message "..."` |
 
 失败或越权时必须回写，runner 决定重试、blocked 或继续队列：
 
@@ -113,6 +113,7 @@ python3 ./.trellis/scripts/auto_loop.py decide \
 python3 ./.trellis/scripts/auto_loop.py record \
   --action <action> --result failed|blocked \
   --failure-type <type> --summary "<摘要>" \
+  [--repo-commit <repository>::<hash> ...] \
   [--files <repository>::<path> ...]
 python3 ./.trellis/scripts/auto_loop.py next
 ```
@@ -128,17 +129,20 @@ Check-All 自动修复当前任务 `implement.md` 或 `brief.md` 时，每个实
 3. 若是合法 `implement.md` / `brief.md` DOC 修复，补齐精确 `--doc-remediation-file` 后重录。
 4. 若无法安全归因，使用原 action、`--result blocked --failure-type artifact-drift` 重录并停止。
 
-同一 Check action 最多允许 3 次 retryable 自纠，第 4 次进入 terminal blocked。实现、spec update、commit-only 等其它 action 的 artifact drift 不使用该预算。
+同一 Check action 最多允许 3 次 retryable 自纠，第 4 次进入 terminal blocked。实现、spec update、commit-only 等其它 action 的 artifact drift 不使用该预算；commit-only 只有下方明确的 `commit-repairable` 本地失败可以使用独立三轮预算。
 
 ## Commit-Only
 
 收到 `commit_only` 后：
 
 1. 用 `status` 确认 active run、profile、outstanding action 和 task 一致。
-2. 读取任务 artifacts、Git status/diff，生成 exact files、message 和归属理由。
-3. staged 必须为空；不得包含冲突、未完成集成、runtime、route prefs、其它任务目录或 protected-retained。
-4. 使用 `trellis-push` 内部 commit-only 提交 exact files。不得裸 `git add .`、`git add -A`、push 或按时间差猜归属。
-5. 用提交 hash 和 exact files record，然后立即 next。
+2. 调用 `trellis-push` 内部 `commit-only`，由它根据任务 artifacts、项目 SOP/spec、受版本控制脚本和可验证 Git/submodule 关系，从当前真实 Git 状态生成有序 `commit -> generate -> commit` 链。不得仅因多个仓库、submodule pin 或证据充分的本地生成命令返回 `multi-repo-commit-boundary`。
+3. 仓库发现、证据冲突处理、生成入口校验、exact/retained 归属和逐步 Git 预检都由 `trellis-push` 负责；本 skill 不另行猜测依赖、拼接命令或绕过其计划。只有本地生成入口确定性、可重复、受版本控制且无外部副作用，并且计划外 dirty、retained、staged、分支和 HEAD 都满足其安全契约时才继续。
+4. 按 `trellis-push` 的计划精确提交和运行生成入口。不得裸 `git add .`、`git add -A`、push、按时间差猜归属或撤销已经成功的本地 commit。
+5. 确定性生成失败、生成结果尚未收敛或可重新规划的本地预检失败时，用 `--result failed --failure-type commit-repairable` 回写全部已完成 `--repo-commit`，然后立即 `next`。runner 前 3 次会重新发出同一个 action；每次都从真实 Git 状态重建计划，验证并跳过已完成提交，安全重跑生成，后续仓 clean 时跳过空提交。第 4 次失败进入 `commit-repair-budget-exhausted`。
+6. 全部完成后，用主仓或最后提交传 `--commit`，并为每个已完成仓库重复传入 `--repo-commit <repositories[].root>::<hash>`；同时传 `--files`、`--retained-files` 和 `--commit-message`，record 成功后立即 next。
+
+`commit-repairable` 只用于继续执行仍然安全的本地确定性链。外部副作用风险或任何 Git 安全边界问题必须用 `blocked` 或非 repairable `failed` 立即结束当前项。部分成功提交跨 retry/resume 保留，不回滚、不 amend、不重复创建。
 
 `decisions.jsonl` 属于当前任务文件，发生决策时应进入该任务最终精确提交。任务 `task.json.status` 不因 queue item completed 而改写。
 

package/enhancements/0.6/.agents/skills/trellis-check-all/SKILL.md

@@ -12,12 +12,13 @@ description: "统一 Check-All 入口：确认范围与运行上下文，按 req
 
 ## 入口职责
 
-1. 确认本轮检查范围、任务材料、项目规范和运行上下文。
+1. 确认本轮检查范围、task artifacts 或 untracked state、项目规范和运行上下文。
 2. 解析 `requested_depth`，生成 `check_profile`，决定 `effective_depth=light|full`。
 3. 按有效深度读取并执行对应 profile。
 4. 全程收集普通问题到 `CHK-*`，收集低风险文档漂移到 `DOC-*`。
 5. 在最终报告前处理允许自动修复的文档漂移，并把修复内容展示在报告里。
 6. 根据 interactive / validated auto-loop 边界输出下一步或完成 runner `record + next`。
+7. untracked 上下文在最终 diff 稳定后调用 `untracked_flow.py record-check`；只有严格通过且 disposition 确认继续时才 `advance --stage spec`。
 
 ---
 
@@ -62,7 +63,7 @@ description: "统一 Check-All 入口：确认范围与运行上下文，按 req
 
 | 顺序 | 维度 | 检查内容 | 对照物 |
 | --- | --- | --- | --- |
-| 1 | 三件套实现 | 规划是否正确落地 | `prd.md` + 可选 `design.md` / `implement.md` |
+| 1 | 三件套实现 | 规划是否正确落地 | task 的 `prd.md` + 可选 `design.md` / `implement.md`；untracked 为 `N/A` |
 | 2 | 实现假设 | API、组件、历史数据、数据流和测试假设是否成立 | 源码、真实契约、可用验证证据 |
 | 3 | 完整性与规范 | 影响面是否同步、代码是否符合 spec、验证是否通过 | 实际变更范围 + 项目 spec |
 

package/enhancements/0.6/.agents/skills/trellis-check-all/references/depth-routing.md

@@ -23,9 +23,9 @@ git log --oneline -10
 
 如果确认范围内确实无变更，提示用户并终止。
 
-### 0.2 读取任务与规范
+### 0.2 读取工作上下文与规范
 
-读取当前任务：
+存在当前 task 时读取：
 
 - `prd.md`；没有时三件套实现维度标记 `N/A`。
 - `design.md`（若存在）。
@@ -35,6 +35,14 @@ git log --oneline -10
 
 不得只依赖 session 摘要推断规划内容，必须读取实际文件。
 
+没有当前 task 时运行 `python3 ./.trellis/scripts/untracked_flow.py status --verbose`：
+
+- `hit`：读取 work id、summary、stage、scope、baseline/current fingerprint 和已有验证证据；三件套实现维度标记 `N/A`，其余维度仍对实际 diff 与相关 spec 负责。
+- `miss`：仅当用户明确要求检查一个无状态的已知 diff 时继续，并把工作上下文缺失列为风险；否则停止并回到 Request Triage。
+- `error` 或 workspace drift：按阻塞报告，禁止用聊天摘要恢复或覆盖状态。
+
+untracked 检查必须处于 `stage=check`，且只读取个人 check 偏好，不创建 task-scoped route decision。
+
 ### 0.3 验证运行上下文
 
 默认 `context=interactive`。只有调用方声称来自 auto-loop 时，才通过 runner 的 `status` / `next` 验证以下事实：

package/enhancements/0.6/.agents/skills/trellis-check-all/references/full-profile.md

@@ -6,6 +6,8 @@ Full 是完整验收映射和全影响面审查。只有 `check_profile.effectiv
 
 ## Step 1：对照规划三件套检查实现
 
+untracked 上下文没有 task artifacts，本 Step 标记 `N/A`；不得把 summary、scope 或聊天记录当成 PRD。仍须完整执行 Step 2 与 Step 3，并对实际 diff、相关 spec、状态机证据和多仓分发边界负责。
+
 ### 1.1 验收依据
 
 - PRD Requirement / Acceptance Criteria：行为基线。

package/enhancements/0.6/.agents/skills/trellis-check-all/references/light-profile.md

@@ -20,6 +20,8 @@ Light 是局部且可穷举的检查，不是“少看一点”的检查。只
 
 ## 维度 1：三件套实现
 
+untracked 上下文没有 task artifacts，本维度标记 `N/A`，不得根据事项摘要伪造验收条目；直接进入实现假设和完整性/规范检查。
+
 只提取受影响的 PRD / design / implement 条目。每条必须记录来源位置，并阅读对应实现后判断：
 
 - 需求、AC、业务规则是否被本次局部变更影响；

package/enhancements/0.6/.agents/skills/trellis-check-all/references/reporting-and-disposition.md

@@ -33,7 +33,7 @@ interactive 模式完成所有可继续检查和允许的 `DOC-*` 自动修复
 
 [<通过/未通过/阻塞>] <N> 个维度 · CHK <N> · 自动修复 DOC <N> · P0 <N> / P1 <N> / P2 <N> · 验证 <通过>/<总数>
 
-任务：<任务名称或无活动任务>
+工作：<任务名称 | Untracked work: work-id | 无活动工作>
 范围：<文件数与层级摘要；包含自动修复产生的文档 diff>
 画像：requested=<auto/light/full> · effective=<light/full> · confidence=<high/fallback-full/escalated> · <原因摘要>
 结论：<一句话结论>
@@ -94,7 +94,7 @@ interactive 模式完成所有可继续检查和允许的 `DOC-*` 自动修复
 
 用户选择修复范围后：
 
-1. 主会话复用当前任务已有的合法 implement route，批量修复选中的无歧义 `CHK-*`；不存在合法 implement route 时先进入 `trellis-route(target=implement)`，不得自行默认 inline/subagent。
+1. 主会话复用当前 task 已有的合法 implement route；untracked 则重新直接读取个人 pref。不存在合法 route 时进入 `trellis-route(target=implement)`，不得自行默认 inline/subagent。
 2. 修复过程中不对每个问题重复确认。
 3. 新增业务歧义、破坏性风险或范围扩张时才暂停，并一次性说明受影响问题。
 4. 完成定向验证后复用当前 check route 重新执行 Check-All。
@@ -125,6 +125,8 @@ interactive 模式完成所有可继续检查和允许的 `DOC-*` 自动修复
 
 检查通过后的动作由下方 `Interactive Post-Check Stop Gate` 判断：普通交互停止等待，符合 direct Git 严格通过条件时同轮进入 Phase 3.3 `trellis-update-spec`，再到 Phase 3.4 `trellis-push`。仍有 `CHK-*` 时停留在修复/重检循环。
 
+untracked 在最终报告前调用 `untracked_flow.py record-check`：严格通过记录 `pass`，有问题记录 `findings`，部分验证记录 `partial`，真正阻塞记录 `blocked`。普通严格通过但尚未继续时保持 `stage=check`；只有 direct Git 同轮继续或用户后续明确继续时才 `advance --stage spec`。任何报告后的新编辑先回到 `prepare-edit`，旧检查证据随 fingerprint 失效。
+
 ---
 
 ## Auto-Loop Return Gate

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

@@ -5,7 +5,7 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
 
 # Trellis Push
 
-`trellis-push` 是 Phase 3.4 唯一的代码提交入口。它只负责生成最小计划、精确提交、普通推送，以及触发当前任务进度同步。
+`trellis-push` 是 Phase 3.4 唯一的代码提交入口。它只负责生成最小计划、精确提交、普通推送，以及在 task 上触发进度同步或在 untracked 上完成状态清理。
 
 ## 职责边界
 
@@ -13,10 +13,11 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
 - 普通多仓计划可以包含本地确定性生成命令；生成后没有新增计划外文件时沿用同一次确认。
 - 普通模式把当前任务产物与更新后的 `task.json` 纳入同一次确认下的独立任务记录提交。
 - 用户明确要求“只提交不推送”时使用 `commit-only`。
-- auto-loop 可调用内部 `commit-only`，但必须传入已经校验过的 exact files 与 commit message；本 skill 只执行该提交。
+- auto-loop 可调用内部 `commit-only`，复用本 skill 的仓库发现、动态多仓计划、确定性本地生成、精确提交和失败保留能力；不再次确认、不 push，也不执行 Step 5 的任务进度写入、进度 commit 或 progress push。Auto-Loop runner 仍按自己的状态契约写入本地 `task.json.progress`。
 - 不发起、终止或解决分支合并；只允许普通模式完成已经开始、冲突已清零且索引完全可归属的 merge commit。
 - 不处理上线核对、任务归档、会话日志或自动任务队列状态。
 - 不使用 `git add .`、`git add -A`，不要求工作区整体干净，也不提交计划外文件。
+- untracked 上下文只接受 `stage=push` 且 Check-All / Update-Spec 证据与当前 workspace fingerprint 一致；不生成任务进度提交。
 
 ## 模式
 
@@ -24,9 +25,9 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
 | --- | --- | --- | --- |
 | 普通 | 展示最小计划并确认一次 | exact commit；已有 merge 就绪时完成双父提交；然后 push | 有活动任务时立即同步 |
 | 用户 `commit-only` | 展示最小计划并确认一次 | exact local commit | 跳过 |
-| auto-loop 内部 `commit-only` | 复用 auto-loop 预授权 | exact local commit | 跳过 |
+| auto-loop 内部 `commit-only` | 复用 auto-loop 预授权 | exact local commit chain | 由 Auto-Loop runner 写本地 progress；本 skill 跳过 Step 5 |
 
-内部 `commit-only` 不接受临时扩大文件范围、远端推送或其他附加动作。安全条件不满足时返回失败，由调用方决定后续状态。
+内部 `commit-only` 不接受超出当前任务证据、runner owned dirty 和 protected-retained 边界的文件，不执行远端推送或其他附加动作。安全条件不满足时返回失败，由调用方决定后续状态。
 
 ## Step 0：记录完成链证据
 
@@ -39,6 +40,8 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
 
 auto-loop 内部 `commit-only` 已由 runner 的 `run_check_all -> run_spec_update -> commit_only` 状态机和预授权保证顺序，因此不重复记录或判断本交互证据。
 
+没有活动 task 时运行 `python3 ./.trellis/scripts/untracked_flow.py status --verbose`。命中 untracked 后，以 helper 返回的 stage、scope、baseline、current fingerprint、Check-All 和 Update-Spec 证据填写上述完成链；必须为 `stage=push` 且证据仍有效。`miss` 才按既有“无活动任务”普通 Git 路径处理；`error` 或 workspace drift 停止，不从摘要猜测。
+
 ## Step 1：发现仓库与任务
 
 候选仓库包括：
@@ -51,7 +54,7 @@ auto-loop 内部 `commit-only` 已由 runner 的 `run_check_all -> run_spec_upda
 
 为每个候选仓库生成用户可见名称：优先使用 `.trellis/config.yaml` 中匹配的 package 名；没有配置时使用 Git top-level 目录名。`root`、`parent`、`main repo` 只允许作为输入别名，禁止直接显示在计划或结果中。
 
-活动任务是可选上下文：
+活动 task 或 untracked work 都是可选上下文：
 
 ```bash
 python3 ./.trellis/scripts/task.py current --source || true
@@ -64,7 +67,7 @@ python3 ./.trellis/scripts/task_progress.py status --json || true
 git status --short --untracked-files=all -- <task-dir>
 ```
 
-不得把默认 `git status --short` 可能返回的 `?? <task-dir>/` 折叠目录当成 exact file、展示条目或 pathspec。无活动任务时仍可提交相关代码，但不生成任务进度。存在活动任务时，结合 `brief.md`、`implement.md`、当前 diff 与本轮执行范围生成一行语义进度；同时识别当前任务目录中已存在且可归属的 dirty/untracked 产物，供 Step 5 生成任务记录 exact files。不得从旧进度推断 Git 动作。
+不得把默认 `git status --short` 可能返回的 `?? <task-dir>/` 折叠目录当成 exact file、展示条目或 pathspec。无活动 task 时仍可提交相关代码，但不生成任务进度。untracked 命中时，所有业务 `planned` 文件必须能由当前 state scope 与实际 diff 归属，计划同时显示 work id；scope 外文件只能保留或作为归属风险。存在活动 task 时，结合 `brief.md`、`implement.md`、当前 diff 与本轮执行范围生成一行语义进度；同时识别当前任务目录中已存在且可归属的 dirty/untracked 产物，供 Step 5 生成任务记录 exact files。不得从旧进度推断 Git 动作。
 
 ## Step 2：预检与文件归属
 
@@ -100,12 +103,25 @@ git log @{u}..HEAD --oneline 2>/dev/null || true
 
 普通模式存在活动任务时，当前任务目录中已存在且可归属的 dirty/untracked 产物不进入业务 `planned`，也不进入 `retained`；它们与预计由 helper 更新的 `<task-dir>/task.json` 组成 Step 5 的任务记录 exact files。其他任务目录和无法归属当前任务的文件仍属于 `retained` 或风险，不得顺带提交。
 
-普通 `PUSH` 需要在仓库间运行本地生成命令时，首次计划同时展示命令、工作目录和后续仓预计 exact files。仅在后续仓没有 retained dirty 时使用；命令必须本地、可重复且无外部副作用。
+普通 `PUSH` 或 auto-loop 内部 `commit-only` 需要在仓库间运行本地生成命令时，计划必须包含命令、工作目录、依赖顺序和后续仓预计 exact files。执行链可包含任意数量的仓库和生成步骤，不硬编码具体仓库、两仓三阶段或命令名称。
+
+动态执行链按以下证据优先级生成：
+
+1. 当前任务 `design.md` / `implement.md` 明确记录的顺序、命令和路径。
+2. 项目 SOP/spec 中的 canonical、生成和分发约定。
+3. 受版本控制的 `package.json`、Makefile 或仓库脚本入口，以及可确认的输入输出路径。
+4. 可验证的 Git/submodule 父子关系。
+
+上述优先级用于发现意图和执行顺序，不允许用文档覆盖当前仓库事实。命令入口、工作目录和输出路径必须由受版本控制内容验证；任务 artifacts、SOP/spec、脚本实际行为或 Git 关系互相冲突时失败关闭。
+
+命令必须是受版本控制的稳定入口，并且本地、确定性、可重复、无外部副作用。工作目录和预期影响路径必须可审计；只有名称相似、mtime、目录邻近或惯例不足以执行。禁止任意 shell 字符串、管道、重定向、命令替换、push、release、deploy、archive、凭证和生产数据操作；证据不足时失败关闭。
 
 `retained` 只是内部集合名。用户可见输出统一写“保留未提交的变更（dirty）”，并逐项标注 `[untracked]`、`[unstaged]`、`[staged]`。unknown ahead、branch/upstream 异常、归属不确定等真正需要处理的事项单独进入“风险”区；普通 retained dirty 不默认视为阻塞。
 
 普通模式允许 `retained` 存在。执行前记录计划外 staged set，提交后确认这些 staged 文件仍保持原状。用户明确要求新增文件时，重新生成计划并确认，不能在执行中静默扩大范围。
 
+auto-loop 内部 `commit-only` 也允许 retained dirty 存在，但每个生成/提交步骤前后都必须验证 retained exact paths 的内容摘要不变，并确认它们与 planned/generated paths 不冲突。内部模式仍要求 staged 区为空；计划外 dirty、retained 漂移、未知 staged、无法由当前计划或已记录提交解释的分支/HEAD 漂移，或归属歧义立即停止后续副作用。
+
 已有 merge 会提交整个索引，因此 planned 必须覆盖全部 staged paths，`retained` 中不得存在 `[staged]`；未跟踪或未暂存 retained 仍可保留。
 
 ## Step 3：展示最小计划
@@ -116,7 +132,7 @@ git log @{u}..HEAD --oneline 2>/dev/null || true
 ## Trellis Push 计划
 
 [<PUSH / PUSH · MERGE / COMMIT-ONLY>] <N> 个仓库 · <N> 个 commit · <N> 个文件 · 保留未提交 <N> · 风险 <N>
-[无活动任务时追加：无活动任务]
+[无活动 task 时追加：无活动任务；untracked 命中时改为 `Untracked work: <work-id>`]
 顺序：<repo-a> [-> `<local generation command>`] -> <repo-b> [-> task progress]
 
 ### 完成链证据
@@ -135,7 +151,7 @@ git log @{u}..HEAD --oneline 2>/dev/null || true
 
 Push：<执行 / 跳过（commit-only）>
 
-[生成（仅普通多仓需要时显示）：前置仓成功后，在 `<working-directory>` 运行 `<exact local command>`；预计只影响 <后续仓 exact files 或分组摘要>]
+[生成（多仓需要时显示）：前置仓成功后，在 `<working-directory>` 运行 `<exact local command>`；预计只影响 <后续仓 exact files 或分组摘要>]
 
 ### 保留未提交的变更（dirty，仅数量大于 0 时显示）
 - [untracked] <path>
@@ -161,19 +177,21 @@ Push：<执行 / 跳过（commit-only）>
 - 顶部仓库/commit/file 总数包含独立任务记录提交所在 Git root、该提交及其 exact files；任务记录文件使用相同的 8 文件展示阈值和展开规则。
 - 保留未提交的变更始终逐项标注 Git 状态；真正风险在独立“风险”区逐项展示。
 - 完成链证据始终显示当前状态，但不重复 Check-All 报告或 Spec review 正文；`未运行`、`已失效`、findings、blocked、部分验证或 `needs-review` 同时计入风险区。
-- 无活动任务或 `commit-only` 时省略进度动作。
+- 无活动 task、untracked 或 `commit-only` 时省略进度动作。
 - 不重复展示检查结果、规范复核、归档或其他阶段的详细信息。
 - 生成前无法确定的内容和增删行写“生成后计算”，不得填预测值。
 
 普通多仓只确认一次。计划已展示生成命令和预计 exact files 时，命令成功且没有出现预计列表外的新 dirty path 就沿用原确认；内容、hash 或统计变化不重问。其它计划边界变化仍按 Step 4 重新规划。
 
-auto-loop 内部 `commit-only` 仍生成同样的逐仓执行数据用于自检和结果记录，但不再次询问用户；它不得扩展调用方给定的 exact files/message。
+auto-loop 内部 `commit-only` 仍生成同样的逐仓执行数据用于自检和结果记录，但不再次询问用户；它只能在当前任务 artifacts、runner owned dirty 和 protected-retained 边界内形成 exact files/message。
 
 ## Step 4：精确提交与推送
 
-每个仓库按计划顺序执行。执行前重新检查 planned files、当前分支、upstream、冲突状态和 ahead commits；任一关键条件变化都停止当前执行并重新规划。仅 `retained` 内容变化时保留并在结果中更新说明。
+每个仓库按计划顺序执行。执行前重新检查 planned files、当前分支、HEAD、upstream、冲突状态、staged、全部 dirty paths 和 retained 摘要；任一关键条件变化都停止当前执行并重新规划。普通模式仅 `retained` 内容变化时可更新说明；auto-loop 内部模式的 retained 内容必须保持不变。
+
+计划包含本地生成命令时，前置仓成功后按计划执行命令，再复用本节现有预检。命令成功、后续仓全部 dirty paths 都在预计 exact files 内且 retained 摘要未漂移时直接继续；否则停止并重新生成计划。预计文件最终 clean 时不强行提交。
 
-计划包含本地生成命令时，前置仓成功后按计划执行命令，再复用本节现有预检。命令成功、后续仓全部 dirty paths 都在已确认的预计 exact files 内且没有其它计划边界变化时直接继续；否则停止并重新生成计划。预计文件最终 clean 时不强行提交。
+auto-loop retry/resume 时，读取调用方提供的已完成仓库提交，逐个验证 repository、commit object、message 和文件集合仍符合当前任务证据，并确认当前分支/HEAD 变化可由这些提交解释。验证通过的提交直接跳过；验证失败立即 blocked，不重复提交。确定性生成入口可以安全重跑，以当前 Git 状态重新规划后续步骤。
 
 普通精确提交：
 
@@ -223,9 +241,11 @@ git push origin <current-branch>
 
 多仓执行失败时停止后续未开始仓库，保留已经成功的提交/推送，不做回滚。
 
+auto-loop 内部链失败时向调用方返回全部已完成仓库提交和失败位置。只有确定性生成未收敛或仍可安全重新规划的本地预检使用 `commit-repairable`；计划外 dirty、retained 漂移、未知 staged、无法由当前计划或已记录提交解释的分支/HEAD 漂移、归属歧义和外部副作用风险必须立即 blocked。不得 reset、rebase、revert、amend 或撤销成功提交。
+
 ## Step 5：同步任务进度
 
-仅普通模式且存在活动任务时执行。全部业务仓库成功后写完整进度；已有仓库成功而后续仓库失败时写 partial 进度，明确 completed、失败位置、next 和 notes。尚未发生成功 Git 动作就失败时，不记录虚假的 completed steps；只有父仓仍可安全提交并推送时才允许记录 failure notes。
+仅普通模式且存在活动 task 时由本 skill 执行。untracked、用户 `commit-only` 与 auto-loop 内部 `commit-only` 都跳过本 Step；Auto-Loop runner 在 action record/next 后按自身契约写入本地 `task.json.progress`，不属于这里的任务进度提交或推送。全部业务仓库成功后写完整进度；已有仓库成功而后续仓库失败时写 partial 进度，明确 completed、失败位置、next 和 notes。尚未发生成功 Git 动作就失败时，不记录虚假的 completed steps；只有父仓仍可安全提交并推送时才允许记录 failure notes。
 
 新进度固定为：
 
@@ -268,6 +288,8 @@ git push origin <current-branch>
 
 ## Step 6：结果
 
+untracked 的全部已确认 Git 动作成功后，最后运行 `python3 ./.trellis/scripts/untracked_flow.py clear --reason completed --work-id <work-id>`。清理成功才报告完成链已结束；任一仓库、push 或清理失败都保留状态并报告恢复位置，禁止因部分成功伪造完成。用户 `commit-only` 的已确认动作全部成功时同样可以完成并清理。
+
 结果复用计划的视觉顺序，先给总览，再逐仓报告实际 commit/push，最后报告任务进度与保留 dirty：
 
 ```markdown
@@ -296,6 +318,8 @@ git push origin <current-branch>
 - [staged] <path>
 ```
 
+untracked 结果用“无任务状态”替代“任务进度”，展示 work id 与 `<已清理/保留待恢复>`；不生成或暗示 task progress commit。
+
 部分完成时必须明确列出已成功仓库、失败仓库/步骤、当前分支和下一恢复动作。业务结果与 progress sync 状态不得合并成一个模糊结论。
 
 ## 禁止事项

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

@@ -13,7 +13,7 @@ description: |
 
 # Trellis 路由器：implement / check 执行模式选择
 
-主 agent 进入 Phase 2.1 实现路由或 Phase 2.2 检查路由时调用本 skill。当前上下文或 session runtime state 内已有合法来源、target 匹配、且 task 等于当前任务路径的最近 route 决策时，后续实现、修复、重检默认复用该决策；没有合法决策时才进入本 skill 或同编号 fallback。提交前确实需要最终复查时，回到 Phase 2.2 并复用当前任务的合法 check route，除非用户明确要求重选。
+主 agent 进入 Phase 2.1 实现路由或 Phase 2.2 检查路由时调用本 skill。task 上下文继续使用 task-scoped session route decision；untracked 上下文只读取个人 `.trellis/.route-prefs.tmp`，不读取或写入 `route_decisions`。提交前确实需要最终复查时，回到 Phase 2.2 并按当前 subject 的同一规则解析 route。
 
 个人配置只写入 `.trellis/.route-prefs.tmp`。该文件匹配 `.trellis/.gitignore` 的 `*.tmp` 规则，属于开发者本地偏好，不纳入 git，也不影响其他开发者。auto-loop 可在 `.trellis/.runtime/auto-loop/<run-id>.json` 写入临时 route 授权；它不是个人偏好，优先级低于 `.route-prefs.tmp`，只用于减少 auto 模式下的交互打断。
 
@@ -23,9 +23,15 @@ description: |
 
 ## Step 0: 识别目标与用户意图
 
-个人 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 配置只决定“已获准执行后的模式”，不是开工授权。调用 helper 前，必须确认当前 workflow 已允许进入对应 target：task implement 需要任务已完成规划确认并处于 `in_progress`；untracked implement 需要 `untracked_flow.py status` 命中当前 session；check 需要 Phase 2.2 或 untracked `stage=check`。如果仍在 planning、等待用户确认，或用户表达“等一下 / 我再想想”，停止，不读取 runtime/prefs。
 
-合法 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、ordinary summary、SessionStart 摘要、replacement history、`codex-mode`、空 `.route-prefs.tmp`、旧单值偏好、历史用户裸数字，都不能单独作为有效 route 决策。
+先用 `task.py current --source` 与 `untracked_flow.py status` 确认 subject，二者只能命中一个：
+
+- task 命中：`scope=task`，继续使用本 skill 既有 runtime -> prefs -> auto-loop 顺序。
+- 无 task 且 untracked 命中：`scope=untracked`，只使用 pref-only CLI；不得伪造 task 路径或 task artifacts。
+- 二者都未命中：返回 workflow Request Triage，不展示执行 route。
+
+task 的合法 route 决策必须能追溯到 `trellis-route`、同编号 fallback 选项、有效 `.trellis/.route-prefs.tmp`，或 route helper 校验过的 auto-loop 临时授权，并且 `task` 字段等于当前任务路径。untracked 的合法 route 只来自本次紧邻选择或 `read-pref` 命中；不写 runtime，也不接受 auto-loop 授权。用户自然语言、摘要、SessionStart 提示、`codex-mode`、空偏好或历史裸数字都不能单独作为有效 route 决策。
 
 当前上下文内已有 target 匹配、task 等于当前任务路径、且来源合法的 route 决策时，后续实现、check 发现问题、用户指出刚检查过的实现有问题、修复后重检、提交前复查均默认复用最近 implement/check 路由；除非用户明确要求重选/临时改/清除默认，不再调用本 skill。当前上下文没有 route 决策但 runtime state 命中时，本 skill 恢复该决策并输出同样的结构化 `route_decision`。如果上下文里只有上一个任务的 `route_decision`，必须忽略并重新解析当前任务。
 
@@ -49,7 +55,7 @@ Codex inline mode 只表示主会话默认直接执行，不是 route 选项过
 
 ## Step 0.5: 解析已有 route state
 
-仅在没有覆盖意图、当前上下文没有 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 状态。
+task 仅在没有覆盖意图、当前上下文没有 target + 当前 task 匹配的合法 `route_decision` 时调用 `resolve`，解析顺序固定为 runtime -> prefs -> auto-loop。untracked 不调用 `resolve`，每次直接调用 `read-pref`；命中即可执行，miss 才进入 Step 2。
 
 调用随本 skill 分发的 helper；不要在对话中内嵌或改写 helper 逻辑：
 
@@ -59,6 +65,14 @@ 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>
 ```
 
+untracked 调用：
+
+```bash
+python3 .agents/skills/trellis-route/scripts/route_state.py read-pref --target <implement|check>
+# Claude 平台若只有 .claude skill 副本，则使用：
+python3 .claude/skills/trellis-route/scripts/route_state.py read-pref --target <implement|check>
+```
+
 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 文件。
@@ -137,7 +151,7 @@ fi
 
 ## Step 2.6: 写入 route state / 默认配置
 
-用户选择本次模式后，调用 helper 写入当前 session runtime。选项含“保存默认”或“更新默认”时，加 `--save-pref`，helper 会同时更新 `.trellis/.route-prefs.tmp` 并保留另一个 target 的偏好。
+task 用户选择本次模式后，调用 helper 写入当前 session runtime。选项含“保存默认”或“更新默认”时，加 `--save-pref`。untracked 的“仅本次”只用于当前调用，不写任何 runtime 或偏好；“保存默认/更新默认”只调用 `write-pref`。
 
 只影响本次：
 
@@ -155,6 +169,14 @@ python3 .agents/skills/trellis-route/scripts/route_state.py write --target <impl
 python3 .claude/skills/trellis-route/scripts/route_state.py write --target <implement|check> --mode <mode> --source <trellis-route|numbered-fallback> --save-pref
 ```
 
+untracked 保存 / 更新默认：
+
+```bash
+python3 .agents/skills/trellis-route/scripts/route_state.py write-pref --target <implement|check> --mode <mode>
+# Claude 平台若只有 .claude skill 副本，则使用：
+python3 .claude/skills/trellis-route/scripts/route_state.py write-pref --target <implement|check> --mode <mode>
+```
+
 清除默认：
 
 ```bash
@@ -177,13 +199,17 @@ helper 写入规则：保留另一个 target 的 runtime 决策和偏好；覆
 
 | 路由决定 | 主 agent 应执行 |
 |---------|----------------|
-| `inline implement` | `Skill({skill: "trellis-before-dev"})` 加载 spec → 读任务文档 → 主线程实施 → 跑必要验证 → 回到 Phase 2.1 completion contract 解析 Pre-Check，不得在局部验证后直接结束 |
-| `subagent implement` | `Agent({subagent_type: "trellis-implement"})`；若 `subagent_skip_compile=true`，dispatch prompt 附加“跳过 mvn install / npm run build / tsc 等耗时编译类检查（已由主 agent 验证或最终统一执行）”；主 agent 收到结果后回到 Phase 2.1 completion contract 解析 Pre-Check |
+| `inline implement` | `Skill({skill: "trellis-before-dev"})` 加载 spec；task 再读任务文档，untracked 读取 helper 状态与实际 scope → 主线程实施 → 跑必要验证 → 回到 Phase 2.1 completion contract |
+| `subagent implement` | `Agent({subagent_type: "trellis-implement"})`；task 使用 `Active task:`，untracked 使用下方自包含 `Untracked work:` 契约；主 agent 收到结果后回到 Phase 2.1 completion contract |
 | `inline check-all` | `Skill({skill: "trellis-check-all"})` |
 | `subagent check-all` | 优先使用明确 audit-only 的 `trellis-check-all` agent；不存在时使用平台通用 subagent，并用下方 dispatch 契约执行本地 `trellis-check-all`。subagent 只返回 `DOC-*` 文档漂移候选，不写文件；主会话负责允许的文档自修。禁止 fallback 到会直接修改工作区的 `trellis-check` agent；无兼容 subagent 时停止并请用户改选 inline |
 
 implement 路由只决定执行位置，不拥有实现后的停止策略。无论 inline 或 subagent，focused validation 完成后都必须返回 workflow Phase 2.1 的 completion contract；由该 owner 处理 auto-loop、用户显式继续/暂缓、已有 hold 和默认立即 Check-All 的优先级。
 
+### Untracked Subagent Dispatch 契约
+
+untracked 的 implement/check subagent prompt 第一行固定为 `Untracked work: <work-id>`，并包含事项摘要、stage、scope、baseline 仓库摘要、current fingerprint、已有验证证据、相关 spec 路径和本轮明确职责。不得写 `Active task:`，不得要求 `prd.md`、`implement.jsonl` 或 `check.jsonl`。agent 必须直接执行，不得递归 dispatch implement/check agent。
+
 ### Subagent Check-All Dispatch 契约
 
 使用专用或通用 subagent 时，dispatch prompt 第一行必须是当前任务路径，并包含以下完整边界：
@@ -219,8 +245,9 @@ route_decision:
   target: <implement | check>
   mode: <inline | subagent | check-all-inline | check-all-subagent>
   source: <trellis-route | route-prefs | auto-loop | numbered-fallback>
-  scope: task
-  task: <current task path>
+  scope: <task | untracked>
+  task: <current task path; task only>
+  work_id: <current untracked work id; untracked only>
 
 接下来主 agent 应当：
 - <路由表里对应的工具调用形式>

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

@@ -317,7 +317,20 @@ def _write_prefs(repo_root: Path, prefs: dict[str, str]) -> None:
         if value:
             lines.append(f"{target}={value}")
     path.parent.mkdir(parents=True, exist_ok=True)
-    path.write_text("\n".join(lines) + "\n", encoding="utf-8")
+    fd, temp_name = tempfile.mkstemp(prefix=f".{path.name}.", suffix=".tmp", dir=path.parent)
+    temp_path = Path(temp_name)
+    try:
+        with os.fdopen(fd, "w", encoding="utf-8") as handle:
+            handle.write("\n".join(lines) + "\n")
+            handle.flush()
+            os.fsync(handle.fileno())
+        os.replace(temp_path, path)
+    except Exception:
+        try:
+            temp_path.unlink()
+        except FileNotFoundError:
+            pass
+        raise
 
 
 def _normalized_decision(decision: Any, target: str, current_task: str) -> dict[str, Any] | None:
@@ -643,6 +656,74 @@ def write_route(args: argparse.Namespace) -> int:
     )
 
 
+def read_pref(args: argparse.Namespace) -> int:
+    """读取不依赖任务或 session 的个人 route 偏好。
+
+    Args:
+        args: 包含 target 和 verbose 的命令行参数。
+
+    Returns:
+        命令退出码。
+    """
+    repo_root = _repo_root()
+    if repo_root is None:
+        return _print({"status": "miss", "reason": "not-trellis-project"})
+    mode = _read_prefs(repo_root).get(args.target)
+    if mode not in PREF_MODES[args.target]:
+        return _output(
+            args,
+            {"status": "miss", "reason": "no-valid-pref", "target": args.target},
+            {"pref_path": _rel_path(repo_root, _pref_path(repo_root))},
+        )
+    return _output(
+        args,
+        {
+            "status": "hit",
+            "target": args.target,
+            "mode": mode,
+            "source": "route-prefs",
+        },
+        {"pref_path": _rel_path(repo_root, _pref_path(repo_root))},
+    )
+
+
+def write_pref(args: argparse.Namespace) -> int:
+    """写入不依赖任务或 session 的个人 route 偏好。
+
+    Args:
+        args: 包含 target、mode 和 verbose 的命令行参数。
+
+    Returns:
+        命令退出码。
+    """
+    mode = _normalize_mode(args.target, args.mode)
+    if mode not in PREF_MODES[args.target]:
+        return _print(
+            {
+                "status": "error",
+                "reason": "invalid-mode",
+                "target": args.target,
+                "mode": args.mode,
+            }
+        )
+    repo_root = _repo_root()
+    if repo_root is None:
+        return _print({"status": "skipped", "reason": "not-trellis-project"})
+    prefs = _read_prefs(repo_root)
+    prefs[args.target] = mode
+    _write_prefs(repo_root, prefs)
+    return _output(
+        args,
+        {
+            "status": "written",
+            "target": args.target,
+            "mode": mode,
+            "source": "route-prefs",
+        },
+        {"pref_path": _rel_path(repo_root, _pref_path(repo_root))},
+    )
+
+
 def clear_pref(args: argparse.Namespace) -> int:
     """清除当前 target 的个人默认 route 配置。"""
     repo_root = _repo_root()
@@ -688,6 +769,17 @@ def build_parser() -> argparse.ArgumentParser:
     write_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and session metadata")
     write_parser.set_defaults(func=write_route)
 
+    read_pref_parser = subparsers.add_parser("read-pref", help="read a personal route preference")
+    read_pref_parser.add_argument("--target", choices=sorted(PREF_MODES), required=True)
+    read_pref_parser.add_argument("--verbose", action="store_true", help="include preference path metadata")
+    read_pref_parser.set_defaults(func=read_pref)
+
+    write_pref_parser = subparsers.add_parser("write-pref", help="write a personal route preference")
+    write_pref_parser.add_argument("--target", choices=sorted(PREF_MODES), required=True)
+    write_pref_parser.add_argument("--mode", required=True)
+    write_pref_parser.add_argument("--verbose", action="store_true", help="include preference path metadata")
+    write_pref_parser.set_defaults(func=write_pref)
+
     clear_parser = subparsers.add_parser("clear-pref", help="clear a personal route preference")
     clear_parser.add_argument("--target", choices=sorted(PREF_MODES), required=True)
     clear_parser.add_argument("--verbose", action="store_true", help="include diagnostic paths and preference metadata")