flower-trellis 0.6.7 → 0.6.8-beta.0

package/README.md

@@ -172,7 +172,7 @@ 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-dms-query` 与 `aliyun-sls-query`：前者通过阿里云 DMS 查询纳管数据库，并让写操作以数据变更工单进入审批流；后者提供零第三方依赖的阿里云 SLS 查询脚本与排障知识。两者都支持 Codex / Claude 项目，默认不安装，也不会复制用户私有 AK/SK 配置。
+可选通用技能包含 `aliyun-ops`，统一提供阿里云 DMS、SLS 与 MSE 查询和排障能力，DMS 写操作通过数据变更工单进入审批流。通用技能需手动选择启用，不会复制用户私有 AK/SK 配置。Codex 通用技能安装到 `.agents/skills`，Claude 安装到 `.claude/skills`；已有 `.codex` 或 `.agents` 时使用共享目标，已有 `.claude` 时使用 Claude 目标，三个目录都不存在时默认同时安装两份。空目录也可通过 Skill Garden 入口管理通用技能，无需初始化 Trellis。
 
 安装、更新和卸载都会先展示 dry-run、依赖、capability 和目标文件变化，确认后才写入项目。Plugin 作者使用的 `plugin init`、`plugin validate` 继续保留在高级命令中，不占用普通用户的管理器首页。
 
@@ -381,7 +381,9 @@ flower banner → 平台多选菜单 → Trellis 原生交互(模板 / monorepo
 
 - **通用技能**:`flower-trellis update` 会用新版快照覆盖仓库中已经启用的 common skill,
   未启用项不会自动安装;若某个已安装 common skill 已从新版快照移除,更新会精确删除其
-  `.codex/skills` / `.claude/skills` 或历史 `.agents/skills` 副本。
+  `.agents/skills` / `.claude/skills` 或历史 `.codex/skills` 副本。安装或更新对应技能时，
+  旧 `.codex/skills` 会迁移到 `.agents/skills`，兼容旧技能名称；新副本写入成功后才清理旧目录。
+  新旧同名技能仍按随包快照替换，不合并自定义内容；停用会清理该技能的新旧精确目录。
 
 ## 开发
 

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

@@ -85,15 +85,7 @@ untracked helper 只存游标：findings 或新编辑回 `implement`；通过且
 
 ### Step 4：统一报告与分流
 
-读取 `references/reporting-and-disposition.md`。报告先自然说明实际改动及行为影响，再展示：
-
-- `check_profile`；
-- 三个维度状态；
-- 自动修复的 `DOC-*` 内容；
-- 剩余 `CHK-*` 主路径问题与 `FBK-*` 兜底问题；
-- 每个剩余问题的未处置或已接受风险状态；
-- 已执行验证、未覆盖风险和 `[上线后验证]`；
-- 与当前结论匹配的唯一下一步。
+读取 `references/reporting-and-disposition.md`，按其完整模板与分流规则在对话中输出报告；默认不新建报告文件，落盘例外由该 reference 定义。
 
 ---
 

package/enhancements/0.6/.agents/skills/trellis-check-all/references/document-drift-auto-remediation.md

@@ -34,6 +34,8 @@
 - 不改操作步骤、责任边界、安全提示、协议字段或对外承诺，且可由重读或静态检查验证；
 - 用户没有明确要求本轮绝对只读。
 
+任务状态同步只更新已有文档中的过期事实；不得借 `task-status`、`check-record` 或 `mechanical-link` 新建检查报告并追加引用。报告落盘条件见 `references/reporting-and-disposition.md`。
+
 典型例子：
 
 - `brief.md` 漏掉 diff 已证明的实现范围，或 `implement.md` 状态机械过期；

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

@@ -56,7 +56,7 @@
 4. 已接受问题继续完整展示证据、影响、建议和验证，标题行末尾追加 `` `[已接受风险]` `` 标签；不得删除条目、改列 `DOC-*` 或伪报已修复。
 5. `strict pass` 只用于剩余 `CHK-*` / `FBK-*` 均为 0。所有剩余问题均已被有效接受，且无 blocked、无阻断型部分验证、无未接受的实质剩余风险时，结论为 `通过·已接受风险`。
 6. blocked、阻断型部分验证和无法唯一对应当前报告范围的实质剩余风险不是 `CHK-*` / `FBK-*` 处置状态，不能借风险接受绕过；`[上线后验证]` 不属于风险接受对象。
-7. `仅保留报告` 表示停止处置并等待，不等于接受风险；只有带明确接受语义的用户回复才改变问题处置状态。
+7. `仅保留报告` 表示停止处置并等待，不等于接受风险，也不授权写文件；只有带明确接受语义的用户回复才改变问题处置状态。
 
 ## 验证阶段
 
@@ -68,6 +68,10 @@
 
 ## 输出：统一检查报告
 
+报告默认在对话中完整展示，不得为了缩短回复、提供链接、留存结论或同步任务状态新建 `check-report.md` 等附件，也不得用附件链接代替应展示的内容。
+
+仅用户明确要求导出或已确认的交付约定要求文件时，由主会话保存，不得自行补写约定。Maven、auto-loop 沿用各自机器证据契约，不额外生成 Markdown。已有报告不自动删除或复制。
+
 interactive 完成检查与允许的 DOC 修复后，先自然说明实际改动、行为影响和结论，再展示证据与问题：
 
 - 依据当前审查范围的最终 diff 和已读实现，覆盖 staged、unstaged、未跟踪文件及必要的子仓；复用检查时收集的材料，不额外启动 Diff Brief 流程或重复扫描。
@@ -150,6 +154,7 @@ interactive 完成检查与允许的 DOC 修复后，先自然说明实际改动
 
 展示规则：
 
+- strict pass 且无剩余问题时可紧凑表述，保留模板顺序、画像、维度、实际验证、DOC（如有）、风险和下一步，省略空区块；不得缩减实际检查范围。有问题或已接受风险时完整展示问题字段与处置。
 - 报告头部“工作/范围/画像/结论”和“修复批次”必须使用 `- ` 列表项，不得改为裸行或依赖行尾空格。
 - 每个问题必须由一个四级标题承载，固定顺序为 `` #### `<ID>` `<严重度>` `<来源>` <标题> ``。仅 `已接受风险` 的问题在标题末尾追加 `` `[已接受风险]` ``；待处理不加标签。`来源` 与 `处置` 都不再单独占行。
 - 不得改用 `- [ ]` / `- [x]` 列表项承载问题条目。终端渲染器会把松散列表压平，相邻条目会糊成一段无法分辨；只有标题这类块级元素才能稳定产生视觉分隔。修复状态由“修复结果”表格表达，不靠 checkbox。
@@ -161,7 +166,6 @@ interactive 完成检查与允许的 DOC 修复后，先自然说明实际改动
 - 存在未处置 `CHK-*` 或 `FBK-*` 时展示“修复批次”，并只在报告末尾提供一次处置选择，不再逐项提问。
 - `修复全部` 始终覆盖全部 `CHK-*` 与 `FBK-*`；精确修复可以混合两类 ID。
 - 风险接受可混合两类 ID；“接受当前报告全部风险”覆盖全部剩余问题，包括 P0，无固定句式。全部有效接受后才形成“通过·已接受风险”。
-- `仅保留报告` 只表示停止处置，不改变未通过结论或剩余风险。
 - interactive 标准报告必须以“下一步”段结束；停止等待不等于省略引导。
 - 独立 `CHK-*` 或 `FBK-*` 不得因数量多而静默省略；先合并同根因重复项，再完整列出剩余项。
 - 报告不得包含 commit message、拟提交/暂存文件、commit-only 决策或提交确认。
@@ -205,7 +209,7 @@ interactive 完成检查与允许的 DOC 修复后，先自然说明实际改动
 <按下方 `Interactive Post-Check Stop Gate` 输出一个明确、可执行的主动作>
 ```
 
-检查通过后的动作由下方 `Interactive Post-Check Stop Gate` 判断：普通交互停止等待，符合 direct Git strict pass 或已接受风险通过条件时同轮进入 Phase 3.3 `trellis-update-spec`，再到 Phase 3.4 `trellis-push`。仍有未处置 `CHK-*` 或 `FBK-*` 时停留在处置/重检循环。
+重检后按下方 `Interactive Post-Check Stop Gate` 分流；仍有未处置 `CHK-*` 或 `FBK-*` 时停留在处置/重检循环。
 
 untracked helper 不存检查证据或风险接受。普通通过后保持 `stage=check`；direct Git 同轮继续或用户明确继续才 `advance --stage spec`。未处置 `CHK-*` / `FBK-*`、阻断型部分验证、阻塞或新编辑先 `advance --stage implement`；仅 `[上线后验证]` 不回退。
 
@@ -246,14 +250,6 @@ subagent 只返回结构化 `CHK-*`、`FBK-*`、`DOC-*` 候选、报告和 `chec
 
 停止边界只控制是否自动推进，不能让报告在没有下一步提示的情况下结束。
 
-允许 Check-All 标准报告输出的内容只有：
-
-- 各维度状态、问题数和问题清单；
-- `CHK-*` 主路径问题和 `FBK-*` 兜底问题的证据、影响与验证；
-- `DOC-*` 自动修复内容和验证；
-- 已执行验证及结果；
-- 未覆盖验证、`[上线后验证]` 和剩余风险；
-- 总体结论；
-- 与当前结论匹配的唯一主动作引导；有未处置 `CHK-*` 或 `FBK-*` 时是一次修复或风险接受选择，部分验证/阻塞时是补充决策或验证，通过时是 Phase 3.3 / Phase 3.4 指向。
+标准报告仅包含上方统一模板定义的检查内容和本 Gate 的唯一主动作。
 
 Check-All 不新增 direct Git 摘要或 Git 计划；这些仍由 Update-Spec 与 Push 所有。`[上线后验证]` 交给 Push 风险摘要和既有 `trellis-release` / `release.md`。

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

@@ -118,7 +118,9 @@ git log @{u}..HEAD --oneline 2>/dev/null || true
 
 命令必须是受版本控制的稳定入口，并且本地、确定性、可重复、无外部副作用。工作目录和预期影响路径必须可审计；只有名称相似、mtime、目录邻近或惯例不足以执行。禁止任意 shell 字符串、管道、重定向、命令替换、push、release、deploy、archive、凭证和生产数据操作；证据不足时失败关闭。
 
-`retained` 只是内部集合名。用户可见输出统一写“保留未提交的变更（dirty）”，并逐项标注 `[untracked]`、`[unstaged]`、`[staged]`。unknown ahead、branch/upstream 异常、归属不确定等真正需要处理的事项单独进入“风险”区；普通 retained dirty 不默认视为阻塞。
+`retained` 只是内部集合名。用户可见输出统一写“保留未提交的变更（dirty）”，按输出 reference 的阈值展示；内部始终保留 exact paths 和 Git 状态，分组摘要不得用于 pathspec 或替代校验。unknown ahead、branch/upstream 异常、归属不确定等真正需要处理的事项单独进入“风险”区；普通 retained dirty 不默认视为阻塞。
+
+普通模式和用户 `commit-only` 的计划与校验基线默认保存在当前执行上下文。仅跨进程校验或中断恢复确需落盘时，才在 Git 忽略的 runtime 目录保存一份必要的临时 JSON；已有可复用记录时不另建副本。不得仅为缩短对话、提供链接或展示完整清单生成 `retained.md` 等清单附件，也不把临时计划写入任务产物或提交范围。auto-loop 沿用 runner 的既有持久化契约，不增加额外清单。
 
 普通模式允许 `retained` 存在。执行前记录计划外 staged set，提交后确认这些 staged 文件仍保持原状。用户明确要求新增文件时，重新生成计划并确认，不能在执行中静默扩大范围。
 

package/enhancements/0.6/.agents/skills/trellis-push/references/output-templates.md

@@ -30,9 +30,8 @@
 [生成（多仓需要时显示）：前置仓成功后，在 `<working-directory>` 运行 `<exact local command>`；预计只影响 <后续仓 exact files 或分组摘要>]
 
 ### 保留未提交的变更（dirty，仅数量大于 0 时显示）
-- [untracked] <path>
-- [unstaged] <path>
-- [staged] <path>
+- <按共用规则逐项展示或按仓库、目录、Git 状态汇总数量>
+- [staged] <repository/path>（仅存在时逐项显示，兼有未暂存修改时同时标注 [unstaged]）
 
 ### 风险（仅数量大于 0 时显示）
 - <Check-All / Update-Spec 风险，或 unknown ahead / branch-upstream / attribution risk>
@@ -45,7 +44,7 @@
 - **进度**：completed=<...> | partial=<...> | next=<...>
 - **执行**：<business commit/push -> `task_progress.py write --complete` -> task-record commit -> task-record push>
 
-确认执行请回复 `确认`。可调整：`只提交`、`修改 message`、`展开文件`。
+确认执行请回复 `确认`。可调整：`只提交`、`修改 message`、`展开文件`、`展开保留变更`。
 ```
 
 ## 共用展示规则
@@ -55,7 +54,9 @@
 - 单仓 `planned` 不超过 8 个文件时完整列出。
 - 超过 8 个时按目录归组，最多 12 行；用户要求展开时展示同一 exact set。
 - 顶部仓库/commit/file 总数包含独立任务记录提交所在 Git root、该提交及其 exact files；任务记录文件使用相同的 8 文件展示阈值和展开规则。
-- 保留未提交的变更始终逐项标注 Git 状态；真正风险在独立“风险”区逐项展示。
+- 计划中的保留变更按仓库计数：不超过 8 项时逐项标注 `[untracked]`、`[unstaged]`、`[staged]`；超过 8 项时将非 staged 项按目录与 Git 状态汇总数量，每仓最多 12 行，必要时合并到上级目录。同一路径计数一次，兼有 staged/unstaged 时同时标注。
+- 计划外 staged 项始终逐项单列，不计入分组摘要；真正风险在独立“风险”区逐项展示，两者均不受行数限制。分组、展开均只改变展示，不改变 exact set 或确认范围。
+- 用户要求“展开保留变更”时在对话中列出同一 exact set 与 Git 状态，不生成清单附件；“展开文件”仍指 planned files。
 - 完成链证据始终显示当前状态，但不重复 Check-All 报告或 Spec review 正文；`未运行`、`已失效`、任一未处置 `CHK-*` / `FBK-*`、blocked、部分验证或 `needs-review` 同时计入风险区。已接受风险的问题也必须按 ID、严重度和影响进入风险区，但不得改标为阻断 finding。`[上线后验证]` 作为非阻断风险逐项保留动作、环境/责任边界和预期结果，不改变 Check-All 状态，并注明由既有 `trellis-release` / `release.md` 流程承接。
 - 无活动 task、untracked 或 `commit-only` 时省略进度动作。
 - 不重复展示检查结果、规范复核、归档或其他阶段的详细信息。
@@ -85,15 +86,13 @@
 - **失败原因**：<原因和恢复动作>（仅失败时显示）
 
 ### 保留未提交的变更（dirty，仅存在时显示）
-- [untracked] <path>
-- [unstaged] <path>
-- [staged] <path>
+- <按仓库报告保留数量与实际核对结论；异常或未核验项逐项说明>
 ```
 
 ## 结果补充规则
 
 - untracked 结果用“无任务状态”替代“任务进度”，展示 work id 与 `<已清理/保留待恢复>`；不生成或暗示 task progress commit。
 - 部分完成时必须明确列出已成功仓库、失败仓库/步骤、当前分支和下一恢复动作。业务结果与 progress sync 状态不得合并成一个模糊结论。
-- 普通成功结果必须确认本任务产生的当前任务目录变更 clean；其它 retained dirty 仍按原状态逐项展示。
+- 普通成功结果必须确认本任务产生的当前任务目录变更 clean。其它 retained dirty 已核对保持原状时，每仓只报告数量与结论，不重复清单；计划外 staged 项仍逐项确认保留状态。异常或未核验项列出路径、实际状态和处理情况，不得笼统声称全部保持原状；用户要求展开时沿用共用规则。
 - helper 成功但任务记录 commit 失败时，结果写“任务记录 commit 待恢复”，说明本地 `completed` 与 exact task dirty 已保留；任务记录 commit 成功但 push 失败时写“任务记录 push 待恢复”，说明 clean ahead commit 已保留。两种情况都不得暗示需要重复业务提交或 helper 写入。
 - validated auto-loop local completion 不渲染本模板，也不得被普通结果文案描述为任务记录 push 待恢复。

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

@@ -85,15 +85,7 @@ untracked helper 只存游标：findings 或新编辑回 `implement`；通过且
 
 ### Step 4：统一报告与分流
 
-读取 `references/reporting-and-disposition.md`。报告先自然说明实际改动及行为影响，再展示：
-
-- `check_profile`；
-- 三个维度状态；
-- 自动修复的 `DOC-*` 内容；
-- 剩余 `CHK-*` 主路径问题与 `FBK-*` 兜底问题；
-- 每个剩余问题的未处置或已接受风险状态；
-- 已执行验证、未覆盖风险和 `[上线后验证]`；
-- 与当前结论匹配的唯一下一步。
+读取 `references/reporting-and-disposition.md`，按其完整模板与分流规则在对话中输出报告；默认不新建报告文件，落盘例外由该 reference 定义。
 
 ---
 

package/enhancements/0.6/.claude/skills/trellis-check-all/references/document-drift-auto-remediation.md

@@ -34,6 +34,8 @@
 - 不改操作步骤、责任边界、安全提示、协议字段或对外承诺，且可由重读或静态检查验证；
 - 用户没有明确要求本轮绝对只读。
 
+任务状态同步只更新已有文档中的过期事实；不得借 `task-status`、`check-record` 或 `mechanical-link` 新建检查报告并追加引用。报告落盘条件见 `references/reporting-and-disposition.md`。
+
 典型例子：
 
 - `brief.md` 漏掉 diff 已证明的实现范围，或 `implement.md` 状态机械过期；

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

@@ -56,7 +56,7 @@
 4. 已接受问题继续完整展示证据、影响、建议和验证，标题行末尾追加 `` `[已接受风险]` `` 标签；不得删除条目、改列 `DOC-*` 或伪报已修复。
 5. `strict pass` 只用于剩余 `CHK-*` / `FBK-*` 均为 0。所有剩余问题均已被有效接受，且无 blocked、无阻断型部分验证、无未接受的实质剩余风险时，结论为 `通过·已接受风险`。
 6. blocked、阻断型部分验证和无法唯一对应当前报告范围的实质剩余风险不是 `CHK-*` / `FBK-*` 处置状态，不能借风险接受绕过；`[上线后验证]` 不属于风险接受对象。
-7. `仅保留报告` 表示停止处置并等待，不等于接受风险；只有带明确接受语义的用户回复才改变问题处置状态。
+7. `仅保留报告` 表示停止处置并等待，不等于接受风险，也不授权写文件；只有带明确接受语义的用户回复才改变问题处置状态。
 
 ## 验证阶段
 
@@ -68,6 +68,10 @@
 
 ## 输出：统一检查报告
 
+报告默认在对话中完整展示，不得为了缩短回复、提供链接、留存结论或同步任务状态新建 `check-report.md` 等附件，也不得用附件链接代替应展示的内容。
+
+仅用户明确要求导出或已确认的交付约定要求文件时，由主会话保存，不得自行补写约定。Maven、auto-loop 沿用各自机器证据契约，不额外生成 Markdown。已有报告不自动删除或复制。
+
 interactive 完成检查与允许的 DOC 修复后，先自然说明实际改动、行为影响和结论，再展示证据与问题：
 
 - 依据当前审查范围的最终 diff 和已读实现，覆盖 staged、unstaged、未跟踪文件及必要的子仓；复用检查时收集的材料，不额外启动 Diff Brief 流程或重复扫描。
@@ -150,6 +154,7 @@ interactive 完成检查与允许的 DOC 修复后，先自然说明实际改动
 
 展示规则：
 
+- strict pass 且无剩余问题时可紧凑表述，保留模板顺序、画像、维度、实际验证、DOC（如有）、风险和下一步，省略空区块；不得缩减实际检查范围。有问题或已接受风险时完整展示问题字段与处置。
 - 报告头部“工作/范围/画像/结论”和“修复批次”必须使用 `- ` 列表项，不得改为裸行或依赖行尾空格。
 - 每个问题必须由一个四级标题承载，固定顺序为 `` #### `<ID>` `<严重度>` `<来源>` <标题> ``。仅 `已接受风险` 的问题在标题末尾追加 `` `[已接受风险]` ``；待处理不加标签。`来源` 与 `处置` 都不再单独占行。
 - 不得改用 `- [ ]` / `- [x]` 列表项承载问题条目。终端渲染器会把松散列表压平，相邻条目会糊成一段无法分辨；只有标题这类块级元素才能稳定产生视觉分隔。修复状态由“修复结果”表格表达，不靠 checkbox。
@@ -161,7 +166,6 @@ interactive 完成检查与允许的 DOC 修复后，先自然说明实际改动
 - 存在未处置 `CHK-*` 或 `FBK-*` 时展示“修复批次”，并只在报告末尾提供一次处置选择，不再逐项提问。
 - `修复全部` 始终覆盖全部 `CHK-*` 与 `FBK-*`；精确修复可以混合两类 ID。
 - 风险接受可混合两类 ID；“接受当前报告全部风险”覆盖全部剩余问题，包括 P0，无固定句式。全部有效接受后才形成“通过·已接受风险”。
-- `仅保留报告` 只表示停止处置，不改变未通过结论或剩余风险。
 - interactive 标准报告必须以“下一步”段结束；停止等待不等于省略引导。
 - 独立 `CHK-*` 或 `FBK-*` 不得因数量多而静默省略；先合并同根因重复项，再完整列出剩余项。
 - 报告不得包含 commit message、拟提交/暂存文件、commit-only 决策或提交确认。
@@ -205,7 +209,7 @@ interactive 完成检查与允许的 DOC 修复后，先自然说明实际改动
 <按下方 `Interactive Post-Check Stop Gate` 输出一个明确、可执行的主动作>
 ```
 
-检查通过后的动作由下方 `Interactive Post-Check Stop Gate` 判断：普通交互停止等待，符合 direct Git strict pass 或已接受风险通过条件时同轮进入 Phase 3.3 `trellis-update-spec`，再到 Phase 3.4 `trellis-push`。仍有未处置 `CHK-*` 或 `FBK-*` 时停留在处置/重检循环。
+重检后按下方 `Interactive Post-Check Stop Gate` 分流；仍有未处置 `CHK-*` 或 `FBK-*` 时停留在处置/重检循环。
 
 untracked helper 不存检查证据或风险接受。普通通过后保持 `stage=check`；direct Git 同轮继续或用户明确继续才 `advance --stage spec`。未处置 `CHK-*` / `FBK-*`、阻断型部分验证、阻塞或新编辑先 `advance --stage implement`；仅 `[上线后验证]` 不回退。
 
@@ -246,14 +250,6 @@ subagent 只返回结构化 `CHK-*`、`FBK-*`、`DOC-*` 候选、报告和 `chec
 
 停止边界只控制是否自动推进，不能让报告在没有下一步提示的情况下结束。
 
-允许 Check-All 标准报告输出的内容只有：
-
-- 各维度状态、问题数和问题清单；
-- `CHK-*` 主路径问题和 `FBK-*` 兜底问题的证据、影响与验证；
-- `DOC-*` 自动修复内容和验证；
-- 已执行验证及结果；
-- 未覆盖验证、`[上线后验证]` 和剩余风险；
-- 总体结论；
-- 与当前结论匹配的唯一主动作引导；有未处置 `CHK-*` 或 `FBK-*` 时是一次修复或风险接受选择，部分验证/阻塞时是补充决策或验证，通过时是 Phase 3.3 / Phase 3.4 指向。
+标准报告仅包含上方统一模板定义的检查内容和本 Gate 的唯一主动作。
 
 Check-All 不新增 direct Git 摘要或 Git 计划；这些仍由 Update-Spec 与 Push 所有。`[上线后验证]` 交给 Push 风险摘要和既有 `trellis-release` / `release.md`。

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

@@ -118,7 +118,9 @@ git log @{u}..HEAD --oneline 2>/dev/null || true
 
 命令必须是受版本控制的稳定入口，并且本地、确定性、可重复、无外部副作用。工作目录和预期影响路径必须可审计；只有名称相似、mtime、目录邻近或惯例不足以执行。禁止任意 shell 字符串、管道、重定向、命令替换、push、release、deploy、archive、凭证和生产数据操作；证据不足时失败关闭。
 
-`retained` 只是内部集合名。用户可见输出统一写“保留未提交的变更（dirty）”，并逐项标注 `[untracked]`、`[unstaged]`、`[staged]`。unknown ahead、branch/upstream 异常、归属不确定等真正需要处理的事项单独进入“风险”区；普通 retained dirty 不默认视为阻塞。
+`retained` 只是内部集合名。用户可见输出统一写“保留未提交的变更（dirty）”，按输出 reference 的阈值展示；内部始终保留 exact paths 和 Git 状态，分组摘要不得用于 pathspec 或替代校验。unknown ahead、branch/upstream 异常、归属不确定等真正需要处理的事项单独进入“风险”区；普通 retained dirty 不默认视为阻塞。
+
+普通模式和用户 `commit-only` 的计划与校验基线默认保存在当前执行上下文。仅跨进程校验或中断恢复确需落盘时，才在 Git 忽略的 runtime 目录保存一份必要的临时 JSON；已有可复用记录时不另建副本。不得仅为缩短对话、提供链接或展示完整清单生成 `retained.md` 等清单附件，也不把临时计划写入任务产物或提交范围。auto-loop 沿用 runner 的既有持久化契约，不增加额外清单。
 
 普通模式允许 `retained` 存在。执行前记录计划外 staged set，提交后确认这些 staged 文件仍保持原状。用户明确要求新增文件时，重新生成计划并确认，不能在执行中静默扩大范围。
 

package/enhancements/0.6/.claude/skills/trellis-push/references/output-templates.md

@@ -30,9 +30,8 @@
 [生成（多仓需要时显示）：前置仓成功后，在 `<working-directory>` 运行 `<exact local command>`；预计只影响 <后续仓 exact files 或分组摘要>]
 
 ### 保留未提交的变更（dirty，仅数量大于 0 时显示）
-- [untracked] <path>
-- [unstaged] <path>
-- [staged] <path>
+- <按共用规则逐项展示或按仓库、目录、Git 状态汇总数量>
+- [staged] <repository/path>（仅存在时逐项显示，兼有未暂存修改时同时标注 [unstaged]）
 
 ### 风险（仅数量大于 0 时显示）
 - <Check-All / Update-Spec 风险，或 unknown ahead / branch-upstream / attribution risk>
@@ -45,7 +44,7 @@
 - **进度**：completed=<...> | partial=<...> | next=<...>
 - **执行**：<business commit/push -> `task_progress.py write --complete` -> task-record commit -> task-record push>
 
-确认执行请回复 `确认`。可调整：`只提交`、`修改 message`、`展开文件`。
+确认执行请回复 `确认`。可调整：`只提交`、`修改 message`、`展开文件`、`展开保留变更`。
 ```
 
 ## 共用展示规则
@@ -55,7 +54,9 @@
 - 单仓 `planned` 不超过 8 个文件时完整列出。
 - 超过 8 个时按目录归组，最多 12 行；用户要求展开时展示同一 exact set。
 - 顶部仓库/commit/file 总数包含独立任务记录提交所在 Git root、该提交及其 exact files；任务记录文件使用相同的 8 文件展示阈值和展开规则。
-- 保留未提交的变更始终逐项标注 Git 状态；真正风险在独立“风险”区逐项展示。
+- 计划中的保留变更按仓库计数：不超过 8 项时逐项标注 `[untracked]`、`[unstaged]`、`[staged]`；超过 8 项时将非 staged 项按目录与 Git 状态汇总数量，每仓最多 12 行，必要时合并到上级目录。同一路径计数一次，兼有 staged/unstaged 时同时标注。
+- 计划外 staged 项始终逐项单列，不计入分组摘要；真正风险在独立“风险”区逐项展示，两者均不受行数限制。分组、展开均只改变展示，不改变 exact set 或确认范围。
+- 用户要求“展开保留变更”时在对话中列出同一 exact set 与 Git 状态，不生成清单附件；“展开文件”仍指 planned files。
 - 完成链证据始终显示当前状态，但不重复 Check-All 报告或 Spec review 正文；`未运行`、`已失效`、任一未处置 `CHK-*` / `FBK-*`、blocked、部分验证或 `needs-review` 同时计入风险区。已接受风险的问题也必须按 ID、严重度和影响进入风险区，但不得改标为阻断 finding。`[上线后验证]` 作为非阻断风险逐项保留动作、环境/责任边界和预期结果，不改变 Check-All 状态，并注明由既有 `trellis-release` / `release.md` 流程承接。
 - 无活动 task、untracked 或 `commit-only` 时省略进度动作。
 - 不重复展示检查结果、规范复核、归档或其他阶段的详细信息。
@@ -85,15 +86,13 @@
 - **失败原因**：<原因和恢复动作>（仅失败时显示）
 
 ### 保留未提交的变更（dirty，仅存在时显示）
-- [untracked] <path>
-- [unstaged] <path>
-- [staged] <path>
+- <按仓库报告保留数量与实际核对结论；异常或未核验项逐项说明>
 ```
 
 ## 结果补充规则
 
 - untracked 结果用“无任务状态”替代“任务进度”，展示 work id 与 `<已清理/保留待恢复>`；不生成或暗示 task progress commit。
 - 部分完成时必须明确列出已成功仓库、失败仓库/步骤、当前分支和下一恢复动作。业务结果与 progress sync 状态不得合并成一个模糊结论。
-- 普通成功结果必须确认本任务产生的当前任务目录变更 clean；其它 retained dirty 仍按原状态逐项展示。
+- 普通成功结果必须确认本任务产生的当前任务目录变更 clean。其它 retained dirty 已核对保持原状时，每仓只报告数量与结论，不重复清单；计划外 staged 项仍逐项确认保留状态。异常或未核验项列出路径、实际状态和处理情况，不得笼统声称全部保持原状；用户要求展开时沿用共用规则。
 - helper 成功但任务记录 commit 失败时，结果写“任务记录 commit 待恢复”，说明本地 `completed` 与 exact task dirty 已保留；任务记录 commit 成功但 push 失败时写“任务记录 push 待恢复”，说明 clean ahead commit 已保留。两种情况都不得暗示需要重复业务提交或 helper 写入。
 - validated auto-loop local completion 不渲染本模板，也不得被普通结果文案描述为任务记录 push 待恢复。

package/enhancements/MANIFEST.json

@@ -1,7 +1,7 @@
 {
-  "syncedAt": "2026-09-07T07:30:55.059Z",
+  "syncedAt": "2026-09-10T07:55:11.069Z",
   "syncedFrom": "vendor/skill-garden",
-  "sourceCommit": "3e08ded44107ae8d3e1c04e5f1cdb3014655f038",
+  "sourceCommit": "09ae575735b67ba0c72e988154884c97600b2f9d",
   "common": {
     "codexSkills": [
       "aliyun-ops",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flower-trellis",
-  "version": "0.6.7",
+  "version": "0.6.8-beta.0",
   "description": "一键安装/升级 Trellis 并自动融合 skill-garden 强化包(默认 Claude + agents)",
   "type": "module",
   "bin": {
@@ -70,9 +70,9 @@
     "commit-and-tag-version": "^12.7.3"
   },
   "flowerReleaseNotes": {
-    "version": "0.6.7",
+    "version": "0.6.8-beta.0",
     "source": "CHANGELOG.md",
-    "body": "### ✨ 新功能 Features\n\n* **bootstrap:** 完善团队版本记录与 CLI 安装引导 ([e86217c](https://github.com/SilentFlower/flower-trellis/commit/e86217c5a121b35509ad972540c2c0adf3763b64))\n\n\n### 🐛 修复 Bug Fixes\n\n* **worktree:** 补齐 Flower 安装记录继承与版本诊断 ([17ad63e](https://github.com/SilentFlower/flower-trellis/commit/17ad63efd9f56ecf491c9402ef92469c70db3ea1))\n\n\n### ♻️ 重构 Refactor\n\n* **check-all:** 同步检查优化与回归验证 ([1409d42](https://github.com/SilentFlower/flower-trellis/commit/1409d421884cfe35a95342b6e68b3b7b80496e29))\n\n\n### 🧰 维护 Maintenance\n\n* **trellis:** 同步 Flower 0.6.6 工作流与 hooks ([11ae2b9](https://github.com/SilentFlower/flower-trellis/commit/11ae2b96b543da1a01e8a1871471d0752f1a04af))\n* **trellis:** 同步本地安装产物与 Flower 记录 ([5a78ca0](https://github.com/SilentFlower/flower-trellis/commit/5a78ca01434e26287caaed8b3e68321a1efd7cc7))",
+    "body": "### 🐛 修复 Bug Fixes\n\n* **check-all:** 同步报告落盘规则与规范 ([0477456](https://github.com/SilentFlower/flower-trellis/commit/04774560d8cde20b6bb6abe025bcaa0bf1bb5514))\n* **push:** 同步保留变更展示与落盘规则 ([9bcd747](https://github.com/SilentFlower/flower-trellis/commit/9bcd74761777f108be0a7286f0e253c06b0cb0ba))\n* **skills:** 迁移通用技能到共享 agents 目录 ([7ebdf05](https://github.com/SilentFlower/flower-trellis/commit/7ebdf0560ccc53ecd252f6e8b259d417d0a53d78))\n\n\n### 🧰 维护 Maintenance\n\n* **trellis:** 同步 Flower 0.6.7 与插件安装记录 ([690f1b4](https://github.com/SilentFlower/flower-trellis/commit/690f1b4e87d4bffdb02800e576acf882382de566))",
     "truncated": false
   },
   "optionalDependencies": {

package/src/lib/skill-catalog.js

@@ -11,22 +11,21 @@ import { ENHANCEMENTS_ROOT } from "./paths.js";
 const COMMON_SKILL_DIRS = [
   {
     source: ".common/.codex/skills",
-    target: ".codex/skills",
-    platformDir: ".codex",
-    fallback: false,
+    target: ".agents/skills",
+    platformDirs: [".codex", ".agents"],
   },
   {
     source: ".common/.claude/skills",
     target: ".claude/skills",
-    platformDir: ".claude",
-    fallback: true,
+    platformDirs: [".claude"],
   },
 ];
 
 const LEGACY_COMMON_SKILL_DIRS = [
   {
     source: ".common/.codex/skills",
-    target: ".agents/skills",
+    target: ".codex/skills",
+    canonicalTarget: ".agents/skills",
   },
 ];
 
@@ -192,10 +191,10 @@ function listCommonSnapshotNames() {
 /**
  * 汇总 common skill 的 canonical 与历史目标映射。
  *
- * 历史 `.agents/skills` 使用 Codex 快照原地刷新，避免升级时迁移到
- * `.codex/skills` 后产生双副本。
+ * 历史 `.codex/skills` 仍用于识别和卸载；安装与更新统一迁往
+ * `.agents/skills`，避免同一技能留下双副本。
  *
- * @returns {Array<{source:string,target:string}>} common skill 目标映射
+ * @returns {Array<{source:string,target:string,canonicalTarget?:string}>} common skill 目标映射
  */
 function allCommonSkillDirs() {
   return [...COMMON_SKILL_DIRS, ...LEGACY_COMMON_SKILL_DIRS];
@@ -296,23 +295,28 @@ function readCommonSkillMigrationState() {
  * 描述当前项目中已启用 common skill 的无写入同步输入。
  *
  * @param {string} target 目标项目根目录
- * @returns {{refreshes:Array<{source:string,target:string,name:string}>,removedTargets:string[]}} 快照来源与 tombstone 目标
+ * @returns {{refreshes:Array<{source:string,target:string,name:string}>,removedTargets:string[]}} 快照来源与迁移或 tombstone 删除目标
  */
 export function describeInstalledCommonSkillSync(target) {
   const refreshesByTarget = new Map();
   const currentNames = new Set(listCommonSnapshotNames());
   const migrationState = readCommonSkillMigrationState();
+  const removedTargets = new Set();
   for (const name of currentNames) {
     for (const dir of allCommonSkillDirs()) {
       const targetPath = `${dir.target}/${name}`;
       if (!fs.existsSync(path.join(target, ...targetPath.split("/")))) continue;
       const source = path.join(ENHANCEMENTS_ROOT, "common", dir.source, name);
-      if (!fs.existsSync(source)) continue;
-      refreshesByTarget.set(targetPath, { source, target: targetPath, name });
+      if (!fs.existsSync(path.join(source, "SKILL.md"))) continue;
+      // 显式迁移声明损坏时只原地刷新，不能绕过删除保护去迁移目录。
+      const newTarget = migrationState.valid
+        ? `${dir.canonicalTarget || dir.target}/${name}`
+        : targetPath;
+      refreshesByTarget.set(newTarget, { source, target: newTarget, name });
+      if (newTarget !== targetPath) removedTargets.add(targetPath);
     }
   }
   const migrationSources = new Set();
-  const removedTargets = new Set();
   for (const { from, to } of migrationState.migrations) {
     migrationSources.add(from);
     for (const dir of allCommonSkillDirs()) {
@@ -320,7 +324,7 @@ export function describeInstalledCommonSkillSync(target) {
       if (!fs.existsSync(path.join(target, ...oldTarget.split("/")))) continue;
       const source = path.join(ENHANCEMENTS_ROOT, "common", dir.source, to);
       if (!fs.existsSync(path.join(source, "SKILL.md"))) continue;
-      const newTarget = `${dir.target}/${to}`;
+      const newTarget = `${dir.canonicalTarget || dir.target}/${to}`;
       refreshesByTarget.set(newTarget, { source, target: newTarget, name: to });
       removedTargets.add(oldTarget);
     }
@@ -541,10 +545,10 @@ export function listSkillCatalog(target, variantOverride) {
  */
 function activeCommonTargets(target) {
   const active = COMMON_SKILL_DIRS.filter((dir) =>
-    fs.existsSync(path.join(target, ...dir.platformDir.split("/"))),
+    dir.platformDirs.some((platformDir) => fs.existsSync(path.join(target, platformDir))),
   );
   if (active.length > 0) return active;
-  return COMMON_SKILL_DIRS.filter((dir) => dir.fallback);
+  return COMMON_SKILL_DIRS;
 }
 
 /**
@@ -556,12 +560,14 @@ function activeCommonTargets(target) {
  */
 export function installCommonSkills(target, names) {
   const available = new Set(listCommonSnapshotNames());
-  const migrations = readCommonSkillMigrationState().migrations;
+  const { valid, migrations } = readCommonSkillMigrationState();
   const aliases = new Map(migrations.map(({ from, to }) => [from, to]));
   const installed = new Set();
   const processed = new Set();
   const paths = [];
   const skipped = [];
+  // 首个技能会创建平台目录；固定整批目标，避免后续技能因新目录而丢失默认平台。
+  const targets = activeCommonTargets(target);
 
   for (const requestedName of names) {
     const name = aliases.get(requestedName) || requestedName;
@@ -573,17 +579,21 @@ export function installCommonSkills(target, names) {
     processed.add(name);
 
     let installedOne = false;
-    for (const dir of activeCommonTargets(target)) {
+    for (const dir of targets) {
       const src = path.join(ENHANCEMENTS_ROOT, "common", dir.source, name);
-      if (!fs.existsSync(src)) continue;
+      if (!fs.existsSync(path.join(src, "SKILL.md"))) continue;
 
       const dst = path.join(target, ...dir.target.split("/"), name);
       ensureDir(path.dirname(dst));
       copyPath(src, dst);
-      for (const migration of migrations.filter(({ to }) => to === name)) {
-        const oldPath = path.join(target, ...dir.target.split("/"), migration.from);
-        if (fs.existsSync(path.join(dst, "SKILL.md")) && fs.existsSync(oldPath)) {
-          rmrf(oldPath);
+      if (valid && fs.existsSync(path.join(dst, "SKILL.md"))) {
+        const oldNames = [name, ...migrations.filter(({ to }) => to === name).map(({ from }) => from)];
+        for (const oldDir of allCommonSkillDirs()) {
+          if ((oldDir.canonicalTarget || oldDir.target) !== dir.target) continue;
+          for (const oldName of oldNames) {
+            const oldPath = path.join(target, ...oldDir.target.split("/"), oldName);
+            if (oldPath !== dst && fs.existsSync(oldPath)) rmrf(oldPath);
+          }
         }
       }
       installed.add(name);
@@ -600,8 +610,8 @@ export function installCommonSkills(target, names) {
 /**
  * 用当前随包快照同步目标仓库中已经启用的 common skill。
  *
- * 当前快照只覆盖已经存在的精确目标目录，因此不会安装用户未启用的新 skill；
- * tombstone 只删除固定 common 根目录中的历史名称，避免扫描或误删其它用户内容。
+ * 当前快照只刷新已启用技能，并将历史 Codex 目录迁往共享目标；
+ * 迁移和 tombstone 只删除固定 common 根中的精确目录，避免误删其它用户内容。
  *
  * @param {string} target 目标项目根目录
  * @returns {{refreshed:string[],removed:string[],refreshedPaths:string[],removedPaths:string[]}} 同步结果