flower-trellis 0.6.0-beta.8 → 0.6.0-beta.9

package/README.md

@@ -53,13 +53,13 @@ flower-trellis init -u <your-name> -y
 flower-trellis update
 
 # 真正关闭整个项目中全部平台的 Trellis 集成
-flower-trellis trellis disable --target .
+flower-trellis disable --target .
 
 # 查看项目级开关和入口漂移状态
-flower-trellis trellis status --target .
+flower-trellis status --target .
 
 # 恢复 Trellis，并规范化到当前 Flower/Trellis 版本
-flower-trellis trellis enable --target .
+flower-trellis enable --target .
 
 # 临时保留最近 5 份升级备份；传 0 可关闭本次自动清理
 flower-trellis update --backup-retention 5
@@ -119,27 +119,27 @@ flower-trellis -v
 
 ## 项目级关闭与恢复
 
-`flower-trellis trellis disable` 是整个项目的真正关闭，不是只跳过一次 Hook。它会在一次事务中移除全部已配置平台可发现的 Trellis Skills、Agents、Commands、Workflows、Hooks、Extensions、平台配置入口，以及 `AGENTS.md` 中的 Trellis 管理块。开关始终作用于整个项目，不提供平台级参数，也不会留下不同平台一开一关的混合状态。
+`flower-trellis disable` 是整个项目的真正关闭，不是只跳过一次 Hook。它会在一次事务中移除全部已配置平台可发现的 Trellis Skills、Agents、Commands、Workflows、Hooks、Extensions、平台配置入口，以及 `AGENTS.md` 中的 Trellis 管理块。开关始终作用于整个项目，不提供平台级参数，也不会留下不同平台一开一关的混合状态。
 
 关闭不会删除 `.trellis/tasks/`、`.trellis/spec/`、`.trellis/workspace/`、当前任务或 `.flower/plugins.json` / `plugin-lock.json` / `state.json`。恢复材料保存在 gitignored 的 `.flower/trellis-control.json` 和 `.flower/trellis-detached/`；它们记录原始字节、文件 mode、所有权和关闭前后摘要。当前会话已经加载的上下文无法被命令撤回，因此 disable 或 enable 完成后都需要重启 AI 会话。
 
 ```bash
 # 只读预演，显示将 detach 的全部入口
-flower-trellis trellis disable --dry-run --json --target .
+flower-trellis disable --dry-run --json --target .
 
 # 真正关闭；修改过的独占受管文件默认会在写盘前阻断
-flower-trellis trellis disable --target .
+flower-trellis disable --target .
 
 # 查看 enabled / disabled / drifted / repair-required / not-initialized
-flower-trellis trellis status --json --target .
+flower-trellis status --json --target .
 
 # 精确恢复关闭前现场，再运行当前版本的 update 和 Plugin replay
-flower-trellis trellis enable --target .
+flower-trellis enable --target .
 ```
 
 共享 JSON 与 `AGENTS.md` 采用结构化恢复，关闭期间新增的无关用户配置会保留。无法安全拆分的修改默认冲突并保持零写入；`--force` 只处理恢复证据完整时的独占文件冲突、共享 JSON 恢复冲突或 drifted 重收敛，用户现场会先保存到 detached 恢复证据中。`repair-required` 表示控制状态或恢复材料已经不可信，disable/enable 即使带 `--force` 也会拒绝覆盖，必须先依据诊断修复证据。
 
-项目处于 disabled 时，`flower-trellis update`、`self-update` 的项目更新链，以及 `plugin add/update/remove/replay` 会临时恢复必要入口，完成写操作后再次 detach，并校验最终仍为 disabled；外部 Plugin 内容不会被当作 Trellis 入口删除。直接运行上游 `trellis update` 不经过这一控制面，可能重新生成入口，此时 `flower-trellis trellis status` 会报告 `drifted`。`disable` 也不等同于 `uninstall`：历史数据和恢复能力会继续保留。
+项目处于 disabled 时，`flower-trellis update`、`self-update` 的项目更新链，以及 `plugin add/update/remove/replay` 会临时恢复必要入口，完成写操作后再次 detach，并校验最终仍为 disabled；外部 Plugin 内容不会被当作 Trellis 入口删除。直接运行上游 `trellis update` 不经过这一控制面，可能重新生成入口，此时 `flower-trellis status` 会报告 `drifted`。`disable` 也不等同于 `uninstall`：历史数据和恢复能力会继续保留。
 
 ## Flower Plugin
 

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

@@ -14,7 +14,7 @@ description: "启动、恢复和推进 Trellis 自动任务循环。用于用户
 - 新 run 先 prepare 全部显式任务，Open Questions 全部收敛后才进入 running。running 中不再询问 route、planning 或普通 Check-All 停止边界。
 - 每个 action 完成后，必须用同名 `record --action ...` 精确回写并立即 `next`。不得根据聊天摘要手改 runtime 或跳步。
 - `record` 返回 `status=retryable` 时保留的是同一个 outstanding Check action：不得运行 `next`，必须先按返回指令消解漂移并重录。
-- 本地提交是自动终点。不得 push、merge、release、deploy、finish-work 或 archive；queue item 完成后 Trellis task 仍保持 `in_progress`。
+- 本地提交是自动终点。不得 push、merge、release、deploy、finish-work 或 archive；runner 在 item 本地提交成功后把该任务写入本地完成态（`status=completed` + `completedAt`），归档仍需用户显式执行。
 - 任务顺序只决定稳定调度顺序，不隐含依赖。依赖必须通过 `--depends-on dependent=dependency` 明确传入或由 planning artifacts 明确声明。
 - 任务级失败只阻塞自身及显式依赖项；独立任务继续。fix/recheck、planning repair 与安全的 commit-only repair 各最多 3 轮，队列结束后不自动执行第二遍恢复扫描。
 - schema 1 runtime 继续按 runner 返回的旧 action 恢复，包括 outstanding `confirm_brief`；不要把旧 run 改写成 schema 2。
@@ -144,7 +144,7 @@ Check-All 自动修复当前任务 `implement.md` 或 `brief.md` 时，每个实
 
 `commit-repairable` 只用于继续执行仍然安全的本地确定性链。外部副作用风险或任何 Git 安全边界问题必须用 `blocked` 或非 repairable `failed` 立即结束当前项。部分成功提交跨 retry/resume 保留，不回滚、不 amend、不重复创建。
 
-`decisions.jsonl` 属于当前任务文件，发生决策时应进入该任务最终精确提交。任务 `task.json.status` 不因 queue item completed 而改写。
+`decisions.jsonl` 属于当前任务文件，发生决策时应进入该任务最终精确提交。runner 在 item 本地提交成功后把 `task.json.status` 写为 `completed` 并补 `completedAt`；只允许 `in_progress -> completed` 这一个跃迁，既有 `completedAt` 保持不变。这是本地完成态，不代表已归档。
 
 ## Resume, Retry, Stop
 
@@ -163,6 +163,16 @@ python3 ./.trellis/scripts/auto_loop.py stop --reason "<原因>"
 
 默认使用紧凑输出；只有诊断 manifest、dirty、漂移、依赖链或决策详情时加 `--verbose`。`retryable` 不是终态，由 agent 在同一 outstanding Check action 内立即自纠；`completed_with_blocked` 才是本次 run 的可审计终态，后续恢复由用户显式调用 `retry-blocked`。
 
+## Run 收尾交接
+
+队列到达终态后必须向用户报告归档待办，不得只说 run 已完成。待办从终态 `next`、`record` 或 `status` 的 `summary.pending_archive` 读取：
+
+- `tasks_awaiting_archive`：已写入本地完成态、等待用户显式归档的队列任务，逐项列出。
+- `parent_tasks_outside_queue`：队列任务声明的父任务中未纳入本次队列的部分。父任务只负责范围、依赖顺序和集成复核，不进入实现流水线，但必须排在全部子任务归档之后单独 finish-work。
+- run 结束后 pointer 已清除，`status` 走最近 run 列表；`pending_archive` 在该列表里同样可读。
+
+run 期间新建的后补子任务不在冻结队列内，runner 不追踪；发现时按普通任务单独推进，不得手改 runtime 塞进当前 run。归档动作本身始终由用户发起。
+
 ## 禁止事项
 
 - 不手写 `.trellis/.runtime/auto-loop/*.json`，不提交 runtime 或 `.route-prefs.tmp`。
@@ -170,4 +180,5 @@ python3 ./.trellis/scripts/auto_loop.py stop --reason "<原因>"
 - 不用 `start --force` 代替 `retry-blocked`。
 - `record` 返回 `retryable` 后不得调用 `next` 或重新发起 action。
 - 不把 queue item completed 解释为任务已归档。
+- 不只报告 run 已完成而省略 `pending_archive` 待办，也不代用户执行 finish-work 或 archive。
 - 不在无人值守执行中替用户回答 Open Questions。

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

@@ -10,39 +10,41 @@
 
 ### `CHK-*` 主路径问题
 
-每个独立根因使用固定字段：
-
-| 字段 | 规则 |
-| --- | --- |
-| ID | 首次记录时依次分配 `CHK-001`、`CHK-002`；当前修复/重检循环中不重新编号 |
-| 严重度 | `P0` 数据破坏/安全事故/无法安全继续；`P1` 功能错误/需求违背/发布阻塞；`P2` 测试/规范/维护性/非阻塞风险 |
-| 标题 | 描述根因，不用症状堆叠 |
-| 来源 | prd/design/implement/spec/assumption/verification |
-| 证据 | `file:line`、实际契约或命令结果 |
-| 影响 | 用户、数据或工程影响 |
-| 建议 | 推荐修复方式，不在检查阶段执行 |
-| 位置 | 同一根因的全部受影响位置 |
-| 验证 | 修复后的命令或手动验证步骤 |
+每个独立根因使用固定字段。`ID`、`严重度`、`来源`、`处置`、`标题` 内联在条目的四级标题行，其余字段以加粗标签的列表项逐行展开：
 
-### `FBK-*` 兜底问题
+| 字段 | 呈现 | 规则 |
+| --- | --- | --- |
+| ID | 标题行 | 首次记录时依次分配 `CHK-001`、`CHK-002`；当前修复/重检循环中不重新编号 |
+| 严重度 | 标题行 | `P0` 数据破坏/安全事故/无法安全继续；`P1` 功能错误/需求违背/发布阻塞；`P2` 测试/规范/维护性/非阻塞风险 |
+| 来源 | 标题行 | prd/design/implement/spec/assumption/verification |
+| 处置 | 标题行 | 仅 `已接受风险` 时在标题行末尾追加 `` `[已接受风险]` `` 标签；待处理是默认状态，不加标签也不占行 |
+| 标题 | 标题行 | 描述根因，不用症状堆叠 |
+| 证据 | 加粗字段 | 同一根因的全部受影响 `file:line`，以及实际契约或命令结果；受影响位置与问题证明合并在本字段，不再单列「位置」 |
+| 影响 | 加粗字段 | 用户、数据或工程影响 |
+| 建议 | 加粗字段 | 推荐修复方式，不在检查阶段执行 |
+| 验证 | 加粗字段 | 修复后的命令或手动验证步骤 |
 
-每个满足严格准入条件的独立兜底根因使用固定字段：
+### `FBK-*` 兜底问题
 
-| 字段 | 规则 |
-| --- | --- |
-| ID | 首次记录时依次分配 `FBK-001`、`FBK-002`；当前修复/重检循环中不重新编号 |
-| 严重度 | 与 `CHK-*` 使用同一 P0/P1/P2 影响尺度 |
-| 标题 | 描述具体保护路径根因，不写泛化“增强健壮性” |
-| 来源 | prd/design/implement/spec/assumption/verification |
-| 证据 | 保护缺失、错误或可绕过的 `file:line`、实际契约或命令结果 |
-| 兜底场景 | 可达的异常、失败、越权、数据损害或诊断盲区场景 |
-| 影响 | 当前缺口的用户、数据、安全或工程影响 |
-| 保护收益 | 修复后恢复或新增的明确保护结果 |
-| 建议 | 推荐修复方式，不在检查阶段执行 |
-| 位置 | 同一根因的全部受影响位置 |
-| 验证 | 修复后的测试、故障注入、命令或手动验证步骤 |
+每个满足严格准入条件的独立兜底根因使用固定字段。`ID`、`严重度`、`来源`、`处置`、`标题` 内联在条目的四级标题行，其余字段以加粗标签的列表项逐行展开：
 
-`CHK-*` 与 `FBK-*` 分开编号。同一根因的多个位置合并到一个问题；报告按严重度排序，但不得因此重排已经分配的 ID。新根因使用对应通道的下一个 ID。每个问题还必须标记 `未处置` 或 `已接受风险`；处置状态不改变 ID、通道和严重度。
+| 字段 | 呈现 | 规则 |
+| --- | --- | --- |
+| ID | 标题行 | 首次记录时依次分配 `FBK-001`、`FBK-002`；当前修复/重检循环中不重新编号 |
+| 严重度 | 标题行 | 与 `CHK-*` 使用同一 P0/P1/P2 影响尺度 |
+| 来源 | 标题行 | prd/design/implement/spec/assumption/verification |
+| 处置 | 标题行 | 仅 `已接受风险` 时在标题行末尾追加 `` `[已接受风险]` `` 标签；待处理是默认状态，不加标签也不占行 |
+| 标题 | 标题行 | 描述具体保护路径根因，不写泛化“增强健壮性” |
+| 证据 | 加粗字段 | 保护缺失、错误或可绕过的全部受影响 `file:line`，以及实际契约或命令结果；同时承载 `references/fallback-findings.md` 准入 1「具体位置」与准入 3「问题证据」，不再单列「位置」 |
+| 兜底场景 | 加粗字段 | 可达的异常、失败、越权、数据损害或诊断盲区场景；承载准入 2「可达场景」 |
+| 影响 | 加粗字段 | 当前缺口的用户、数据、安全或工程影响 |
+| 保护收益 | 加粗字段 | 修复后恢复或新增的明确保护结果；承载准入 4「保护收益」，不得省略或并入建议 |
+| 建议 | 加粗字段 | 推荐修复方式，不在检查阶段执行 |
+| 验证 | 加粗字段 | 修复后的测试、故障注入、命令或手动验证步骤；承载准入 5「验证方式」 |
+
+`FBK-*` 字段与 `references/fallback-findings.md` 的严格准入五项一一对应。合并「位置」到「证据」只改变呈现方式，不放宽任何准入门槛；任一准入项缺失时仍不得生成 `FBK-*`。
+
+`CHK-*` 与 `FBK-*` 分开编号。同一根因的多个位置合并到一个问题；报告按严重度排序，但不得因此重排已经分配的 ID。新根因使用对应通道的下一个 ID。每个问题的处置状态默认为待处理且不加标签，只有 `已接受风险` 才在条目标题行末尾追加 `` `[已接受风险]` `` 标签。`仅保留报告` 不改变处置状态，相关问题仍不加标签。处置状态不改变 ID、通道和严重度。
 
 ## 风险接受
 
@@ -50,8 +52,8 @@
 
 1. 只有用户可以接受风险；主会话、subagent 和 validated auto-loop 都不得代替用户推断或授权。
 2. 接受必须唯一对应当前报告的问题 ID。用户可以写 `接受风险 CHK-001,FBK-002 并继续`；当前报告只有一个候选时，“这个问题”“不管这个”等明确指代可以解析为该 ID。P0 必须逐项写出精确 ID，不接受 `接受全部剩余风险`。
-3. 接受只绑定当前问题证据与实际 diff。受影响代码、契约、验证结果、问题内容或严重度变化后，原接受立即失效，问题恢复为 `未处置`。
-4. 已接受问题继续完整展示证据、影响、建议和验证，并标记 `处置：已接受风险`；不得删除、改列 `DOC-*` 或伪报已修复。
+3. 接受只绑定当前问题证据与实际 diff。受影响代码、契约、验证结果、问题内容或严重度变化后，原接受立即失效，问题恢复为待处理并移除标题行末尾的 `` `[已接受风险]` `` 标签。
+4. 已接受问题继续完整展示证据、影响、建议和验证，标题行末尾追加 `` `[已接受风险]` `` 标签；不得删除条目、改列 `DOC-*` 或伪报已修复。
 5. `strict pass` 只用于剩余 `CHK-*` / `FBK-*` 均为 0。所有剩余问题均已被有效接受，且无 blocked、无部分验证、无未接受的实质剩余风险时，结论为 `通过·已接受风险`。
 6. blocked、部分验证和无法唯一对应到当前问题 ID 的实质剩余风险不是 `CHK-*` / `FBK-*` 处置状态，不能借风险接受绕过。
 7. `仅保留报告` 表示停止处置并等待，不等于接受风险；只有带明确接受语义的用户回复才改变问题处置状态。
@@ -67,10 +69,10 @@ interactive 模式完成所有可继续检查和允许的 `DOC-*` 自动修复
 
 [<通过/通过·已接受风险/未通过/阻塞>] <N> 个维度 · CHK <N>（接受 <N>）· FBK <N>（接受 <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> · <原因摘要>
-结论：<一句话结论>
+- **工作**：<任务名称 | Untracked work: work-id | 无活动工作>
+- **范围**：<文件数与层级摘要；包含自动修复产生的文档 diff>
+- **画像**：requested=<auto/light/full> · effective=<light/full> · confidence=<high/fallback-full/escalated> · <原因摘要>
+- **结论**：<一句话结论>
 
 ### 维度结果
 
@@ -88,27 +90,34 @@ interactive 模式完成所有可继续检查和允许的 `DOC-*` 自动修复
 
 ### 主路径问题
 
-- [ ] `CHK-001` `[P1]` <标题>
-  - 处置：<未处置/已接受风险>
-  - 来源：<来源>
-  - 证据：<file:line / 契约 / 命令结果>
-  - 影响：<影响>
-  - 建议：<修复建议>
-  - 位置：<全部受影响位置>
-  - 验证：<验证命令或步骤>
+#### `CHK-001` `P1` `<来源>` <标题>
+
+- **证据**
+  - `<file:line>` — <契约、实际值或命令结果>
+  - `<file:line>` — <契约、实际值或命令结果>
+- **影响**：<影响>
+- **建议**：<修复建议>
+- **验证**：<验证命令或步骤>
+
+#### `CHK-002` `P2` `<来源>` <标题> `[已接受风险]`
+
+- **证据**
+  - `<file:line>` — <契约、实际值或命令结果>
+- **影响**：<影响>
+- **建议**：<修复建议>
+- **验证**：<验证命令或步骤>
 
 ### 兜底问题
 
-- [ ] `FBK-001` `[P1]` <标题>
-  - 处置：<未处置/已接受风险>
-  - 来源：<来源>
-  - 证据：<file:line / 契约 / 命令结果>
-  - 兜底场景：<可达异常或失败场景>
-  - 影响：<影响>
-  - 保护收益：<修复后的明确保护结果>
-  - 建议：<修复建议>
-  - 位置：<全部受影响位置>
-  - 验证：<验证命令或步骤>
+#### `FBK-001` `P1` `<来源>` <标题>
+
+- **证据**
+  - `<file:line>` — <保护缺失、错误或可绕过的证明>
+- **兜底场景**：<可达异常或失败场景>
+- **影响**：<影响>
+- **保护收益**：<修复后的明确保护结果>
+- **建议**：<修复建议>
+- **验证**：<验证命令或步骤>
 
 ### 未覆盖与风险
 
@@ -116,8 +125,8 @@ interactive 模式完成所有可继续检查和允许的 `DOC-*` 自动修复
 
 ### 修复批次
 
-批次 1：<CHK/FBK 问题 ID> · <修复目标>
-修复后：定向验证 -> Check-All 重检
+- **批次 1**：<CHK/FBK 问题 ID> · <修复目标>
+- **修复后**：定向验证 -> Check-All 重检
 
 操作：`修复全部`、`修复 CHK-001,FBK-002`、`接受风险 CHK-001,FBK-002 并继续`、`仅保留报告`
 
@@ -128,6 +137,11 @@ interactive 模式完成所有可继续检查和允许的 `DOC-*` 自动修复
 
 展示规则：
 
+- 报告头部的“工作/范围/画像/结论”与“修复批次”内的行必须使用 `- ` 列表项。这些行在 Markdown 段落内会被折叠成一段，不得改回裸段落行，也不得依赖行尾空格实现换行。
+- 每个问题必须由一个四级标题承载，固定顺序为 `` #### `<ID>` `<严重度>` `<来源>` <标题> ``。仅 `已接受风险` 的问题在标题末尾追加 `` `[已接受风险]` ``；待处理不加标签。`来源` 与 `处置` 都不再单独占行。
+- 不得改用 `- [ ]` / `- [x]` 列表项承载问题条目。终端渲染器会把松散列表压平，相邻条目会糊成一段无法分辨；只有标题这类块级元素才能稳定产生视觉分隔。修复状态由“修复结果”表格表达，不靠 checkbox。
+- 条目内部的字段一律写成 `- **<字段>**：<值>` 加粗标签列表项。字段值折行后回到左边界，加粗标签是唯一能定位字段起点的锚，裸标签会淹没在正文里。
+- 每个问题的受影响位置合并进 `证据`，不再单列「位置」行。`证据` 写成不带值的 `- **证据**` 后接子项列表，一个受影响 `file:line` 一条子项，不得用 `；` 把多个位置堆进一行，也不得只写概括性描述。
 - 没有 `DOC-*` 自动修复时省略“自动修复”区。
 - 没有 `CHK-*` 时省略“主路径问题”区；没有 `FBK-*` 时省略“兜底问题”区。
 - 存在未处置 `CHK-*` 或 `FBK-*` 时展示“修复批次”，并只在报告末尾提供一次处置选择，不再逐项提问。

package/enhancements/0.6/.agents/skills/trellis-create-command/SKILL.md

@@ -221,24 +221,29 @@ cp -r <target>/.agents/skills/trellis-<X> <skill-garden>/.trellis/0.6/.agents/sk
 ```markdown
 ✓ 已创建 trellis 入口：<name>
 
-形态：<command | skill>
-范围：<本项目 | 本项目 + skill-garden 0.6>
-
-副本：
-  • <target>/.claude/<path>
-  • <target>/.agents/skills/trellis-<X>/SKILL.md
-  <• <skill-garden>/.trellis/0.6/ 同步位置 × 2（仅 skill 形态）>
-
-触发方式：
-  • 自然语：<触发词例子>
-  • 显式：<`/trellis:<X>` 或 `/trellis-<X>`>
-
-下一步建议：
-  • 在当前对话试一次触发，观察 Claude 是否正确路由
-  • 触发失败时调整 description（精准化 when/exclusion）
-  • 内容有遗漏时补充 Step 或 checklist
+- **形态**：<command | skill>
+- **范围**：<本项目 | 本项目 + skill-garden 0.6>
+
+### 副本
+
+- `<target>/.claude/<path>`
+- `<target>/.agents/skills/trellis-<X>/SKILL.md`
+- `<skill-garden>/.trellis/0.6/` 同步位置 × 2（仅 skill 形态时显示）
+
+### 触发方式
+
+- **自然语**：<触发词例子>
+- **显式**：<`/trellis:<X>` 或 `/trellis-<X>`>
+
+### 下一步建议
+
+- 在当前对话试一次触发，观察 Claude 是否正确路由
+- 触发失败时调整 description（精准化 when/exclusion）
+- 内容有遗漏时补充 Step 或 checklist
 ```
 
+字段行与分组条目必须使用 Markdown 列表项。`•` 是普通字符，Markdown 不识别，缩进两格也不构成代码块，整块会折叠成一段；不得用 `•` 或裸段落行代替列表。
+
 ---
 
 ## 命名约定

package/enhancements/0.6/.agents/skills/trellis-diff-brief/SKILL.md

@@ -58,8 +58,8 @@ description: "按需读取当前 Trellis 任务与实际 git diff，生成对话
 - <不属于本轮任务或无法判断的 dirty 文件；如无则写“无”>
 
 ### 验证状态
-- 已看到：<从对话、任务文档或命令输出能确认的验证>
-- 未确认：<没有证据的检查，不要假装已跑>
+- **已看到**：<从对话、任务文档或命令输出能确认的验证>
+- **未确认**：<没有证据的检查，不要假装已跑>
 
 ### 注意点
 - <风险、需要人工重点看的点；如无则写“无明显风险”>

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

@@ -13,7 +13,7 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
 - 普通多仓计划可以包含本地确定性生成命令；生成后没有新增计划外文件时沿用同一次确认。
 - 普通模式把当前任务产物与更新后的 `task.json` 纳入同一次确认下的独立任务记录提交。
 - 用户明确要求“只提交不推送”时使用 `commit-only`。
-- auto-loop 可调用内部 `commit-only`，复用本 skill 的仓库发现、动态多仓计划、确定性本地生成、精确提交和失败保留能力；不再次确认、不 push，也不执行 Step 5 的任务进度写入、进度 commit 或 progress push。Auto-Loop runner 仍按自己的状态契约写入本地 `task.json.progress`。
+- auto-loop 可调用内部 `commit-only`，复用本 skill 的仓库发现、动态多仓计划、确定性本地生成、精确提交和失败保留能力；不再次确认、不 push，也不执行 Step 5 的任务进度写入、进度 commit 或 progress push。Auto-Loop runner 仍按自己的状态契约写入本地 `task.json.progress` 与本地完成态（`status=completed` + `completedAt`）。
 - 不发起、终止或解决分支合并；只允许普通模式完成已经开始、冲突已清零且索引完全可归属的 merge commit。
 - 不处理上线核对、任务归档、会话日志或自动任务队列状态。
 - 不使用 `git add .`、`git add -A`，不要求工作区整体干净，也不提交计划外文件。
@@ -25,7 +25,7 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
 | --- | --- | --- | --- |
 | 普通 | 展示最小计划并确认一次 | exact commit；已有 merge 就绪时完成双父提交；然后 push | 有活动任务时立即同步 |
 | 用户 `commit-only` | 展示最小计划并确认一次 | exact local commit | 跳过 |
-| auto-loop 内部 `commit-only` | 复用 auto-loop 预授权 | exact local commit chain | 由 Auto-Loop runner 写本地 progress；本 skill 跳过 Step 5 |
+| auto-loop 内部 `commit-only` | 复用 auto-loop 预授权 | exact local commit chain | 由 Auto-Loop runner 写本地 progress 与本地完成态；本 skill 跳过 Step 5 |
 
 内部 `commit-only` 不接受超出当前任务证据、runner owned dirty 和 protected-retained 边界的文件，不执行远端推送或其他附加动作。安全条件不满足时返回失败，由调用方决定后续状态。
 
@@ -132,25 +132,25 @@ auto-loop 内部 `commit-only` 也允许 retained dirty 存在，但每个生成
 ## 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]
+
+- **工作**：<任务名 | `Untracked work: <work-id>` | 无活动任务>
+- **顺序**：<repo-a> [-> `<local generation command>`] -> <repo-b> [-> task progress]
 
 ### 完成链证据
-- Check-All：<通过 / 通过（已接受风险：CHK-001,FBK-002） / 未运行 / 已失效 / 存在未处置 findings / blocked / 部分验证>
-- Update-Spec：<no-op / written / needs-review / 未运行 / 已失效>
+- **Check-All**：<通过 / 通过（已接受风险：CHK-001,FBK-002） / 未运行 / 已失效 / 存在未处置 findings / blocked / 部分验证>
+- **Update-Spec**：<no-op / written / needs-review / 未运行 / 已失效>
 
 ### 1. <repository-name>
 
-`<commit message>`
-分支：`<branch>` -> `<upstream>`
-变更：<N> 个文件 · `+<adds> -<deletes>`
-[已有 merge 时：父提交：`<pre-merge-head>` + `<merge-head>`]
+- **Message**：`<commit message>`
+- **分支**：`<branch>` -> `<upstream>`
+- **变更**：<N> 个文件 · `+<adds> -<deletes>`
+- **父提交**：`<pre-merge-head>` + `<merge-head>`（仅已有 merge 时显示）
+- **Push**：<执行 / 跳过（commit-only）>
 
 计划提交：
 - <exact files 或分组摘要>
 
-Push：<执行 / 跳过（commit-only）>
-
 [生成（多仓需要时显示）：前置仓成功后，在 `<working-directory>` 运行 `<exact local command>`；预计只影响 <后续仓 exact files 或分组摘要>]
 
 ### 保留未提交的变更（dirty，仅数量大于 0 时显示）
@@ -161,17 +161,21 @@ Push：<执行 / 跳过（commit-only）>
 ### 风险（仅数量大于 0 时显示）
 - <Check-All / Update-Spec 风险，或 unknown ahead / branch-upstream / attribution risk>
 
-[任务记录（仅普通模式且存在活动任务时显示）：`chore(task): update <task-name> progress` · <N> 个文件]
-[仓库：<repository-name> · 分支：`<branch>` -> `<upstream>`]
-[计划提交：<当前任务 exact files 或分组摘要>]
-任务进度：completed=<...> | partial=<...> | next=<...>
-执行：<commit -> push -> progress commit -> progress push>
+### 任务记录（仅普通模式且存在活动任务时显示）
+
+- **Message**：`chore(task): update <task-name> progress` · <N> 个文件
+- **仓库**：<repository-name> · 分支：`<branch>` -> `<upstream>`
+- **计划提交**：<当前任务 exact files 或分组摘要>
+- **进度**：completed=<...> | partial=<...> | next=<...>
+- **执行**：<commit -> push -> progress commit -> progress push>
 
 确认执行请回复 `确认`。可调整：`只提交`、`修改 message`、`展开文件`。
 ```
 
 展示规则：
 
+- 计划与结果模板中的字段行必须使用 `- **字段**：值` 列表项。这些行在 Markdown 段落内会被折叠成一段，不得改回裸段落行，也不得依赖行尾空格换行。
+- 「任务记录」是与各仓库区平级的独立 `###` 小节，仅普通模式且存在活动任务时整节展示；不再用方括号条件行代替小节标题。
 - 单仓 `planned` 不超过 8 个文件时完整列出。
 - 超过 8 个时按目录归组，最多 12 行；用户要求展开时展示同一 exact set。
 - 顶部仓库/commit/file 总数包含独立任务记录提交所在 Git root、该提交及其 exact files；任务记录文件使用相同的 8 文件展示阈值和展开规则。
@@ -276,7 +280,7 @@ python3 ./.trellis/scripts/task_progress.py write \
   --json
 ```
 
-部分成功时调用同一 helper，并写入精确恢复位置。用户 `commit-only`、auto-loop 内部 `commit-only` 和尚未发生任何成功业务 Git 动作的失败都不得请求 complete。helper 写入失败时任务保持原状态，不得继续任务进度提交或报告完成。
+部分成功时调用同一 helper，并写入精确恢复位置。用户 `commit-only`、auto-loop 内部 `commit-only` 和尚未发生任何成功业务 Git 动作的失败都不得由本 skill 请求 complete；auto-loop 的本地完成态由 Auto-Loop runner 自己写入，不经过本步骤。helper 写入失败时任务保持原状态，不得继续任务进度提交或报告完成。
 
 然后只提交并推送首次确认的当前任务 exact files；该集合包含 helper 更新后的 `task.json`，以及首次计划时已存在且可归属的当前任务 dirty/untracked 产物：
 
@@ -313,18 +317,17 @@ untracked 的全部已确认 Git 动作成功后，最后运行 `python3 ./.trel
 
 ### 1. <repository-name>
 
-`<short-hash> <actual commit message>`
-分支：`<branch>` -> `<upstream>`
-状态：<✓ 已推送 / · 仅本地提交 / ❌ 失败>
-
-[生成：`<exact local command>` · <✓ 已完成 / ❌ 失败 / · 未执行>]
+- **Commit**：`<short-hash> <actual commit message>`
+- **分支**：`<branch>` -> `<upstream>`
+- **状态**：<✓ 已推送 / · 仅本地提交 / ❌ 失败>
+- **生成**：`<exact local command>` · <✓ 已完成 / ❌ 失败 / · 未执行>（仅多仓需要时显示）
 
 ### 任务进度
 
-状态：<✓ 已同步并进入 completed · `<progress-hash>` / ✓ partial 已同步且保持 in_progress / · 已跳过 / ❌ 同步失败，不得报告完成>
-记录：<N> 个当前任务文件
-进度：completed=<...> | partial=<...> | next=<...>
-[失败时追加：原因和恢复动作]
+- **状态**：<✓ 已同步并进入 completed · `<progress-hash>` / ✓ partial 已同步且保持 in_progress / · 已跳过 / ❌ 同步失败，不得报告完成>
+- **记录**：<N> 个当前任务文件
+- **进度**：completed=<...> | partial=<...> | next=<...>
+- **失败原因**：<原因和恢复动作>（仅失败时显示）
 
 ### 保留未提交的变更（dirty，仅存在时显示）
 - [untracked] <path>

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

@@ -237,14 +237,13 @@ Active task: <task path from task.py current>
 
 ### 输出模板
 
-```markdown
-路由决定：<inline/subagent> <implement | check-all>
-[来自个人 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`。]
-[仅当本消息刚展示 route 选项并等待用户回答时：用户下一条紧邻裸数字回复才可按本 target 解释；摘要、历史消息或旧 target 的裸数字无效。]
+````markdown
+- **路由决定**：<inline/subagent> <implement | check-all>
+- **来源**：<个人 route 配置 `.trellis/.route-prefs.tmp` (<key>=<value>) | auto-loop 临时授权 `.trellis/.runtime/auto-loop/<run-id>.json` | session runtime state `.trellis/.runtime/sessions/<context-key>.json` 的 `route_decisions`>
+- **已写入**：`.trellis/.runtime/sessions/<context-key>.json` 的 `route_decisions`
+- **裸数字有效性**：用户下一条紧邻裸数字回复才可按本 target 解释；摘要、历史消息或旧 target 的裸数字无效
 
+```yaml
 route_decision:
   target: <implement | check>
   mode: <inline | subagent | check-all-inline | check-all-subagent>
@@ -252,6 +251,7 @@ route_decision:
   scope: <task | untracked>
   task: <current task path; task only>
   work_id: <current untracked work id; untracked only>
+```
 
 接下来主 agent 应当：
 - <路由表里对应的工具调用形式>
@@ -259,9 +259,11 @@ route_decision:
 
 不要：
 - <要避免的工具调用>
-```
+````
+
+字段行必须使用 `- **字段**：值` 列表项；裸段落行会在渲染时折叠成一段，不得改回。`route_decision` 必须放在 ```yaml 代码块内，靠代码块保留缩进结构，不得裸写。
 
-中括号内行为条件性出现：仅命中个人配置时显示配置行；仅命中 runtime state 时显示“来自”行；写入 runtime state 成功时显示“已写入”行；仅展示选项并等待用户时显示裸数字有效性提醒；仅 implement subagent + skip_compile=true 时附加“跳过编译”段。`route_decision` 必须保留在回复中，并至少保留 target/mode/source/scope/task；需要 path/decided_at 等诊断字段时重新调用 helper 并加 `--verbose`。compact summary 若只有自然语言描述，后续 agent 仍应优先读取 runtime state，而不是把 summary 当证据。
+条件字段按命中情况出现：`来源` 只在命中个人配置、auto-loop 临时授权或 session runtime state 时显示，三者互斥取实际命中项；`已写入` 只在写入 runtime state 成功时显示；`裸数字有效性` 只在本消息刚展示 route 选项并等待用户回答时显示；“跳过编译”段只在 implement subagent + skip_compile=true 时附加。`route_decision` 必须保留在回复中，并至少保留 target/mode/source/scope/task；需要 path/decided_at 等诊断字段时重新调用 helper 并加 `--verbose`。compact summary 若只有自然语言描述，后续 agent 仍应优先读取 runtime state，而不是把 summary 当证据。
 
 ---
 

package/enhancements/0.6/.agents/skills/trellis-run-full-chain/SKILL.md

@@ -149,18 +149,18 @@ Playbook 内容范围（**跨任务可复用的环境常量**，不含具体场
 
 ```markdown
 #### Sx: <场景名>
-- Path: <UI/API/DB/跨层>
-- Pre: <基线>（从 DB 查到的 Before）
-- Act:
+- **Path**: <UI/API/DB/跨层>
+- **Pre**: <基线>（从 DB 查到的 Before）
+- **Act**:
   - UI: 浏览器驱动动作（snapshot → click/type → wait）
   - API: curl 带 header 调接口
   - DB: 用 DB 客户端预改数据（仅当场景要求，如临时改状态模拟某前置条件）
-- Expect:
+- **Expect**:
   - UI: 截图 / 文本快照 / Toast 观测
   - API: 返回体 code/msg 匹配
   - DB: 字段变化 + 审计/日志条目新增
-- Result: ✅ / ❌ + 差异说明
-- Restore: <必要的 UPDATE 恢复现场>
+- **Result**: ✅ / ❌ + 差异说明
+- **Restore**: <必要的 UPDATE 恢复现场>
 ```
 
 **UI 细节**：
@@ -271,18 +271,18 @@ Playbook 内容范围（**跨任务可复用的环境常量**，不含具体场
 | S3 | 跨层 | ... | ❌：<差异说明> |
 
 ### 覆盖统计
-- 通过：X / 总 N
-- 失败：Y（需修复）
-- 跳过：Z（未具备前置条件）
+- **通过**：X / 总 N
+- **失败**：Y（需修复）
+- **跳过**：Z（未具备前置条件）
 
 ### 数据影响
-- 已恢复：<N 条 / 涉及表>
-- 未恢复 / 不可逆：<如果有>
-- 需用户善后：<如果有>
+- **已恢复**：<N 条 / 涉及表>
+- **未恢复 / 不可逆**：<如果有>
+- **需用户善后**：<如果有>
 
 ### Playbook 同步
-- 写入条目：<M 条 / 文件路径>（或"N 条新发现未沉淀（用户跳过）"，或"无变化"）
-- 未解决冲突：<如果有，注明待用户裁决的项>
+- **写入条目**：<M 条 / 文件路径>（或"N 条新发现未沉淀（用户跳过）"，或"无变化"）
+- **未解决冲突**：<如果有，注明待用户裁决的项>
 
 ### 建议下一步
 - <根据失败/跳过场景的具体建议>

package/enhancements/0.6/.agents/skills/trellis-task-brief/SKILL.md

@@ -109,19 +109,17 @@ Phase 1.4 review 前：
 已按你对当前 Brief 的明确预授权完成复核；范围未扩大、无未解决问题，继续启动任务。
 ```
 
-任务已经是 `in_progress` 时，如果 brief 存在，进入 implement route 前重述：
+任务已经是 `in_progress` 时，如果 brief 存在，进入 implement route 前复用同样的完整展示：
 
 ```markdown
-当前任务 brief：<目标一句话>
-范围/决定/上下文/约束：<不失真的压缩要点>
-风险/延后：<存在时展示；没有则省略>
-验收：<不失真的压缩要点>
-完整摘要：<task>/brief.md
+当前任务 brief：<task>/brief.md
+
+<brief.md 正文>
 
 下一步：进入 `trellis-route(implement)`。
 ```
 
-压缩重述不能丢掉会影响实现判断的范围、关键决定、约束、风险和验收条件。
+三个展示场景都完整展示 `brief.md` 正文，不压缩、不摘录、不改写字段结构。压缩重述会丢掉 Non-Goals、关键决定或验收条件中影响实现判断的内容，因此不再使用。
 
 ## 不要做
 

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

@@ -121,10 +121,10 @@ description: "把架构、流程、业务逻辑、状态流转和旧 UML / 活
 - PNG：`doc/visualize/<slug>.png`（如已生成）
 
 ### 图模型
-- 输出语言：<中文 / English / 用户指定语言；技术 token 保留原文>
-- 主体：<角色 / 系统 / 组件>
-- 关系：<调用 / 流转 / 判定 / 异常>
-- 边界：<系统边界 / 阶段 / 权限>
+- **输出语言**：<中文 / English / 用户指定语言；技术 token 保留原文>
+- **主体**：<角色 / 系统 / 组件>
+- **关系**：<调用 / 流转 / 判定 / 异常>
+- **边界**：<系统边界 / 阶段 / 权限>
 
 ### 关键说明
 - <关键节点或路径>