universal-dev-standards 6.1.0 → 6.2.0

package/bundled/locales/zh-CN/CHANGELOG.md

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 6.1.0
-translation_version: 6.1.0
-last_synced: 2026-07-17
+source_version: 6.2.0
+translation_version: 6.2.0
+last_synced: 2026-07-31
 status: current
 ---
 
@@ -17,6 +17,48 @@ status: current
 
 ## [Unreleased]
 
+## [6.2.0] - 2026-07-31
+
+> **Reconciler 一直在删除不是它安装的东西，事后还回报成功。** `uds update --plan` 在某个采用 repo 提议移除 86 个文件，其中 72 个是 UDS 有发布、项目也正在用的技能、命令与选项文件。十二个缺陷，形状完全相同：一个格式完好、却永远对不上的名字——所以什么都不会报错，而计划看起来很权威。**如果你曾看着 `--plan` 的输出、纳闷它为什么要删掉你的东西——那不是你的问题。**
+
+### 新增
+
+- **`CLAUDE.md` / `AGENTS.md` 的标准索引改为陈述数量并指向 manifest**，不再逐条列出标准名称（XSPEC-358 R1）。原本的列举每个项目约占 2 KB 的常驻 context，且与 `.standards/manifest.json` 重复——后者才是权威来源且永远不会过期。区块会在下次 `uds update` 时自行重建，你不需要做任何事。**若你有工具在解析那份列举，请改读 `manifest.standards`。**
+
+### 修复
+
+- **Reconciler 不再删除你自己写的技能。** `isUDSManaged` 对技能目录下的每一个子目录都返回 true，于是任何不是当前 UDS 版本发布的东西都被提议移除。某个采用端的计划列出了十四个手写的 ops 技能要删。现在改由 UDS 自己的 `skills/` 树判定来源——这同时涵盖旧版 CLI 误复制进来的非技能同级目录（`_shared`、`agents`、`ai`、`tools`、`workflows`），所以它们仍可被清理——或由已记录的哈希判定。其余一律发警告而非移除。**刻意付出的代价**：四个 UDS 此后已下架的技能改为只警告不删除，因为磁盘上没有任何东西能把它们和你自己的作品区分开。
+- **`manifest.skills.names` 与 `commands.names` 不再被当成期望状态。** 两者都只有 `init` 会写，其他代码路径一律不写。某个 repo 的清单跨越 9 个 commit、5 次 UDS 升级一直冻结在 32 个技能，而发布集合已增长到 55——于是 40 个可用的技能被判为「no longer in desired state」。期望集合现在改为「运行中的 UDS 版本发布什么」，那本来就是 `uds update` 实际安装的东西。全部 18 个安装点也改为同步维护这两份清单。
+- **Gemini CLI 的命令不再被提议删除。** 扫描器写死剥除 `.md`，而 Gemini 的命令是 `.toml`，键值停在 `commit.toml`，永远对不上期望键 `commit`——30 个全被判为孤儿。扩展名现在由 agent 配置提供，与写出这些文件的安装器共用同一份。
+- **UDS 不再提议删除它自己的安装记录。** 命令安装器写出的 `.manifest.json` 被当成了散落的命令。
+- **已选取的选项不再被提议删除。** `calculateOptions` 把 `manifest.options` 的键当成标准 id 迭代，找不到叫 `workflow` 的标准就跳过——于是每个项目的期望选项集合都是空的。某个 repo 的计划提议删掉它自己 manifest 指名的全部七个选项。manifest 键到注册表类别的映射现在放在单一份表，安装器与计算器共用。
+- **语言包与其他 extensions 不再被提议删除。** `manifest.extensions` 在 reconciler 里根本没有分支，于是每个已安装的 extension——语言包、语言风格指南、框架模式——都落在期望状态之外，而 manifest 仍列着它、说它已安装。
+- **Reconcile 不再把所有技能重装成英文。** 技能安装路径漏掉了命令路径有传的 locale 参数，于是本地化技能被无声换成英文 canonical 版，而 `skills.locale` 全程仍记着原本的语言。
+- **成功的 reconcile 现在会记下它 reconcile 到哪个版本。** `upstream.version` 从不更新，于是 `uds check` 仍报告项目落后，任何读取该字段的落后监测也会一直标记它。
+- **重写过的集成区块不再把自己报告为「已修改」。** `migrate_block` 刷新了 `integrationBlockHashes`，却没刷新 `fileHashes`——而后者才是文件完整性比对的对象。
+- **Reconciler 与 `uds update` 现在生成相同的集成区块。** 两个独立的构建者早已漂移：reconciler 那份完全没有内容类别，于是 reconcile 一个项目会无声删掉它的提交信息段落；它也把输出语言一律默认为英文（无视 `options.output_language`），并以工具键查 `integrationConfigs`，而 manifest 是以文件名为键。
+- **索引区块的选项数量计算正确了。** 原本从 `manifest.standards` 数，而该字段记录选项的方式并不一致——某个 repo 明明装了七个选项，区块却写着「options 0」。
+- **`uds check` 不再对新的索引区块报告假的「未同步」。** 有两处检查仍以已废止的列举为契约、逐一 grep 标准名，于是升级后报告 `5/70` 与 `0/7`，并建议运行 `uds update`——而那会重新生成同一个区块。两处现在改为核对声明数量与 manifest 是否一致，这反而抓得到「数量过期」，那是名称 grep 永远抓不到的。
+- **`manifest.integrations` 两种形状都能正确读取。** 它被一条路径写成工具键、被另一条写成文件路径；实测 21 个 repo 中有 20 个存的是文件路径，而 reconciler 只懂工具键——于是它在这 20 个 repo 全都提议剥掉 `CLAUDE.md` / `AGENTS.md` 的 UDS 区块。
+- **`uds update --plan --integrations-only` 不再写文件。** `--integrations-only` 的分支排在 `--plan` 检查之前。
+- **`uds init` 不再把 husky 装进 UDS source repo**（从 repo root 运行测试套件时）。
+
+### 变更
+
+- **发布闸门重新开始测量。** `pre-release-check.sh` 直接调用 `tsx`，于是在 PATH 上没有 tsx 的 shell 中，三项检查会因为找不到可执行文件而报告「✗ Failed」——与真正查出问题无从分辨；现在它会先解析 `tsx`，找不到就直接中止。另外它的 dogfooding 闸门运行 `uds check` 时没带 `--force`，而 DEC-044 的自我采用守卫会在本 repo 内拒绝该命令——**这个闸门自 5.15.1 加入以来，每一次发布都是红的。**
+
+## [6.1.1] - 2026-07-18
+
+> **`uds check` 悄悄量错了东西。** 它的落后检查拿你的标准去比 CLI 自己 bundled 的副本、而非 npm——CLI 一旧就吐出倒退、无意义的消息，且结构上永远说不出「你的标准过期了」——还把那条消息埋在逐文件一行的「未变更」底下。
+
+### Fixed
+
+- **`uds check` 现在拿你安装的标准比对 npm 上的最新版，而非 CLI 自己 bundled 的副本**（XSPEC-342）。`displayAdoptionStatus` 原本拿 `manifest.upstream.version` 去比**运行这支 CLI 内置的**标准副本。CLI 一旧，那副本就比 npm 旧——于是检查打印出倒退的 `⚠ 有可用更新：6.1.0 → 5.12.1`（叫你「更新」到*更旧*的版本），且结构上永远无法报告你的标准落后。现在改问 npm 最新版；当你的标准落后时，消息改为 **「你安装的标准落后最新版」**，并给出完整两步修复——`npm update -g universal-dev-standards` **然后** `uds update`——因为只更新 CLI 不会动到你项目的 `.standards/`。`--offline` 静默跳过比对，不再退回误导的 bundled 检查。
+
+### Changed
+
+- **`uds check` 不再逐文件列出未变更的文件**（XSPEC-342）。它原本对每个跟踪文件打印一行 `✓ …（未变更）`——约占命令输出的 70%（实测 121 → 41 行）——淹没了真正该读的消息，也让输出大到被自动化调用端（pre-commit agent）截断。逐文件「未变更」打印已移除；计数仍保留在一行的完整性摘要，已修改／缺失／未哈希的文件仍逐一列出。
+
 ## [6.1.0] - 2026-07-17
 
 > **同一种形状的两个失败，一个在标准里、一个在 CLI 里**：一道检查跑了、返回了、报告成功，却什么都没测到。`verification-evidence` 补上了为它命名的那一层；`uds init` 则不再是它的一个实例。
@@ -36,7 +78,7 @@ status: current
 - **`verification-evidence` 1.1.0 → 1.2.0 —— 证据有效性**（XSPEC-340）。本标准原本把 `exit_code` 当成事实真相：`trust_rules` 写着"`exit_code ≠ 0` → 验证失败"、`physical_spec.checks` 问的是"`exit_code` 是否为 0（成功）？"、VE-002 只要非零就触发修复循环。**这三处现已全数加上限定条件**，因为一道验证命令可以跑完、可以返回，却什么意义都没有：
   - **新增 `evidence_validity` 层次与规则 VE-007 – VE-010**：只有在"成功时返回 0"的工具上，`exit_code = 0` 才代表成功（VE-007）；在证明查询工具确实执行过之前，"空／未找到／0"不等于不存在（VE-008）；存在性检查不得丢弃 stderr（VE-009）；pipeline 的退出码不属于其中任何单一阶段（VE-010）。
   - **新增 `non_evidence_claims`**："已完成"／"应该可以了"／"我改了代码"／"测试应该会通过"／"命令返回 0"。
-  - 有别于 `anti-hallucination`——后者的禁令全都是"不要断言你没查过的事"的变形。这里是相反的失败：**确实查了，而查询工具静默地没有运作**。`core/verification-evidence.md` 收录了十笔真实案例作为证据。
+  - 有别于 `anti-hallucination`——后者的禁令全都是"不要断言你没查过的事"的变形。这里是相反的失败：**确实查了，而查询工具静默地没有运作**。`core/verification-evidence.md` 收录了八笔真实案例作为证据。
 - **`verification-evidence` 的人类文档补上了 v1.1.0 的落差。** v1.1.0 的 `environment_layer` 工作（XSPEC-204）已落地于全部三份 `.ai.yaml`，却**一份 `.md` 都没有更新**（共四份）——人类文档自 2026-05-13 起就一直在错误地描述这个标准。`core/*.md` 现已载明 `environment_layer`、Environment Layers 章节，以及 VE-005 / VE-006。
 - **`verification-evidence` 新增三个先前只存在于 zh-TW 译文的章节**：非证据的声明（Non-Evidence Claims）、证据类型（Evidence Types）、相关标准（Related Standards）。译文比它的来源更完整；这些章节现已上溯至英文来源，并同时存在于两个语系。
 

package/bundled/locales/zh-CN/README.md

@@ -15,7 +15,7 @@ status: current
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 6.1.0 | **发布日期**: 2026-07-17 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.2.0 | **发布日期**: 2026-07-30 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
 语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 
@@ -88,49 +88,91 @@ npx universal-dev-standards init
 
 ## 🏗️ 系统架构
 
-UDS 采用 **双层执行模型 (Dual-Layer Execution Model)**，专为高速互动开发与深度技术合规而设计。
+UDS 的内容沿**两条彼此独立的轴**组织。两者回答的是不同问题，把它们混为一谈是误读本架构
+最常见的原因，因此分开陈述。
+
+### 轴一 — 深度：哪些内容必须常驻加载
+
+这条轴是一份**行为契约**：它告诉 AI 代理什么要一开始就读、什么留到被问时再读。
+影响 context 成本的是这条轴。
 
 ```mermaid
 graph TD
-    A[AI 助手 / 开发者] --> B{执行层}
-    B -- "日常任务" --> C["技能层 Skills (.ai.yaml)"]
-    B -- "深度审查" --> D["标准层 Standards (.md)"]
-    
-    C --> C1[Token 优化]
-    C --> C2[互动式引导]
-    
-    D --> D1[完整理论与定义]
-    D --> D2[工具自动化配置]
-    
-    C1 -. "回退机制" .-> D1
+    A[AI 助手 / 开发者] --> R["<b>Rules 规则</b><br/>core/*.md<br/><b>必读 Always Read</b>"]
+    R -- "需要说明或实例" --> G["<b>Guides 指南</b><br/>core/guides/*.md<br/>仅按需读取"]
+    R -- "需要完整方法论（TDD、BDD…）" --> M["<b>Methodologies 方法论</b><br/>methodologies/guides/*.md<br/>仅按需读取"]
 ```
 
-| 面向 | 技能层 Skills (执行层) | 核心标准 Standards (知识库) |
+| 层级 | 位置 | 内容 | AI 行为 |
+| :--- | :--- | :--- | :--- |
+| **Rules 规则** | `core/*.md` | 可执行规则、检查清单、阈值 | **必读 (Always Read)** |
+| **Guides 指南** | `core/guides/*.md` | 说明、教学、范例 | 仅按需读取 |
+| **Methodologies 方法论** | `methodologies/guides/*.md` | 完整方法论指南 | 仅按需读取 |
+
+### 轴二 — 格式：同一份标准的两种编码
+
+这条轴**不带任何深度含义**。同一份标准的 `.ai.yaml` 与 `.md` 是同一份材料的两种编码，
+依读者是谁而选用。
+
+| 面向 | `ai/standards/*.ai.yaml` | `core/*.md` |
 | :--- | :--- | :--- |
-| **格式** | YAML 优化 | 完整 Markdown |
-| **目标** | 高速互动与快速查询 | 深度理解与理论依据 |
-| **Token 使用** | 极小（AI 友好） | 详细（参考文献） |
+| **编码** | 结构化 YAML | 散文式 Markdown |
+| **适用于** | 机器确定性查询 | 人类阅读与审查 |
+| **相对体积** | 约为 Markdown 版的 69%——是**换一种格式，不是压缩层**<sup>†</sup> | 基准 |
+
+<sup>†</sup> 2026-07-23 实测，涵盖同时具备两种形式的 135 份标准：YAML 872,380 bytes，
+Markdown 1,271,471 bytes。重现指令见
+[Content Architecture §7](../../docs/reference/CONTENT-ARCHITECTURE.md#7-how-to-re-measure)。
+
+> 📐 深度契约的完整定义、它在各集成工具中的落实情况，以及契约与现况之间已量测到的落差，
+> 记于 **[docs/reference/CONTENT-ARCHITECTURE.md](../../docs/reference/CONTENT-ARCHITECTURE.md)**。
 
 ---
 
 ## 🤖 AI 工具支持
 
-| AI 工具 | 状态 | Skills | 斜线命令 | 配置文件 |
-| :--- | :--- | :---: | :---: | :--- |
-| **Claude Code** | ✅ 完整支持 | **55** | **51** | `CLAUDE.md` |
-| **OpenCode** | ✅ 完整支持 | **55** | **51** | `AGENTS.md` |
-| **Cursor** | ✅ 完整支持 | **核心** | **模拟支持** | `.cursorrules` |
-| **Roo Code** | ✅ 完整支持 | **核心** | **工作流** | `.roo/rules/` |
-| **Gemini CLI** | 🧪 预览版 | **18+** | **20+** | `GEMINI.md` |
-| **Cline** | 🔶 部分支持 | **核心** | **工作流** | `.clinerules` |
-| **Windsurf** | 🔶 部分支持 | **核心** | **规则书** | `.windsurfrules` |
-| **GitHub Copilot** | 🔶 部分支持 | **核心** | **提示词** | `.github/copilot-instructions.md` |
-| **OpenAI Codex** | 🔶 部分支持 | **核心** | — | `AGENTS.md` |
-| **Aider** | 🔶 部分支持 | — | — | `AGENTS.md` |
-| **Continue** | 🔶 部分支持 | — | — | `.continue/config.json` |
-| **Google Antigravity** | ⚠️ 最低限度 | — | — | `.antigravity/rules.md` |
-
-> **状态图例**：✅ 完整支持 | 🧪 预览版 | 🔶 部分支持 | ⚠️ 最低限度 | ⏳ 计划中
+UDS 提供 **11 个现行工具的集成，其中 1 个已通过行为验证。**
+
+这是刻意分开的两个数字。**状态**说的是**我们写的那份集成**有多完整；
+**验证**说的是**有没有人确认过该工具真的读得到、且行为确实照做**——
+靠实际跑探针并留下输出记录。在今天之前，第二个问题从来没有被问过，
+所以它的答案不能被假设。探针设计与验证排程（Antigravity → Codex → Claude Code → 其余）
+见 XSPEC-357。
+
+| AI 工具 | 状态 | 验证 | Skills | 斜线命令 | 配置文件 |
+| :--- | :--- | :---: | :---: | :---: | :--- |
+| **Claude Code** | ✅ 完整支持 | 🔬 —<sup>◆</sup> | **55** | **51** | `CLAUDE.md` |
+| **OpenCode** | ✅ 完整支持 | 🔬 — | **55** | **51** | `AGENTS.md` |
+| **Cursor** | ✅ 完整支持 | 🔬 — | **核心** | **模拟支持** | `.cursorrules` |
+| **Roo Code** | ✅ 完整支持 | 🔬 — | **核心** | **工作流** | `.roo/rules/` |
+| **Cline** | 🔶 部分支持 | 🔬 — | **核心** | **工作流** | `.clinerules` |
+| **Windsurf** | 🔶 部分支持 | 🔬 — | **核心** | **规则书** | `.windsurfrules` |
+| **GitHub Copilot** | 🔶 部分支持 | 🔬 — | **核心** | **提示词** | `.github/copilot-instructions.md` |
+| **OpenAI Codex** | 🔶 部分支持 | ✅ 2026-07-23 | **核心** | — | `AGENTS.md` |
+| **Aider** | 🔶 部分支持 | 🔬 — | — | — | `AGENTS.md` |
+| **Continue.dev** | 🔶 部分支持 | 🔬 — | — | — | `.continue/config.json` |
+| **Google Antigravity** | ⚠️ 最低限度 | 🔬 — | —<sup>‡</sup> | — | `.antigravity/rules.md` |
+| **Gemini CLI** | ⛔ 已停止服务<sup>†</sup> | — | — | — | `GEMINI.md`（已冻结） |
+
+> **状态图例**（我们写的集成有多完整）：
+> ✅ 完整支持 | 🔶 部分支持 | ⚠️ 最低限度 | ⏳ 计划中 | ⛔ 已停止服务
+>
+> **验证图例**（是否有探针实跑确认该工具行为确实照做）：
+> ✅ *日期* 已验证 | 🔬 — 尚未验证 | ⌛ 已过期 | ❌ 未通过
+
+<sup>◆</sup> Claude Code 是维护者每日实际使用的工具，这也是它的集成最完整的原因——
+但**每日使用不等于一次留下记录的验证**，且工具不能当自己的裁判。
+它跟其他工具一样排在队列里。
+
+<sup>†</sup> Google 已于 **2026-06-18** 终止 Gemini CLI（2026-05-19 I/O 宣布，30 天迁移窗），
+由 Antigravity CLI 接手。`integrations/gemini-cli/` 与 `.gemini/` 两棵树已**冻结**——
+保留供参考、排除于同步检查之外、不再维护。见 [`.gemini/DEPRECATED.md`](../../.gemini/DEPRECATED.md)。
+
+<sup>‡</sup> Antigravity 支持 skills，但正确的安装路径**尚未对实际的 Antigravity CLI 验证**。
+两个候选互相冲突：`~/.gemini/antigravity-cli/plugins/<name>/skills/`（官方 plugin 文档）
+与 `.agent/skills/`（UDS 自己 2026-02 的 spec，写于 Gemini CLI 时代）。
+因此在确认之前，`uds init` **不会**为此目标安装 skills——
+路径填错会是静默失败，比不安装更糟。
 
 ---
 

package/bundled/locales/zh-CN/SECURITY.md

@@ -13,7 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支持状态 |
 |------|--------|
-| 6.0.0 | ✅ 最新正式版 |
+| 6.2.0 | ✅ 最新正式版 |
 | < 6.0.0 | ❌ 已终止支持 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->
 

package/bundled/locales/zh-CN/core/behavior-snapshot.md

@@ -2,8 +2,8 @@
 source: ../../../core/behavior-snapshot.md
 source_version: 1.1.0
 translation_version: 1.1.0
-last_synced: 2026-06-28
-source_hash: 36a3683ae75b
+last_synced: 2026-07-09
+source_hash: bd53c2d8c8c0
 status: current
 ---
 

package/bundled/locales/zh-CN/core/data-migration-testing.md

@@ -2,8 +2,8 @@
 source: ../../../core/data-migration-testing.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-28
-source_hash: 990309b5e8b1
+last_synced: 2026-07-09
+source_hash: bda91214a3b7
 status: current
 ---
 

package/bundled/locales/zh-CN/docs/CHEATSHEET.md

@@ -1,6 +1,6 @@
 # UDS 速查表
 
-> Quick reference for all UDS features | Last updated: 2026-07-09
+> Quick reference for all UDS features | Last updated: 2026-07-22
 
 **Language**: [English](../../../docs/user/CHEATSHEET.md) | [繁體中文](../../zh-TW/docs/CHEATSHEET.md) | 简体中文
 
@@ -17,6 +17,7 @@
 | `uds update` | Update standards to latest version |
 | `uds skills` | List installed Claude Code skills |
 | `uds agent` | Manage UDS agents (list, install, info) |
+| `uds workflow` | Manage UDS workflows (list, install, info, execute, status) |
 | `uds ai-context` | Manage AI context configuration (init, validate, graph) |
 
 ## 💬 斜线命令
@@ -358,7 +359,7 @@
 | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
 | `fix-manifest-paths.ps1` | Fix Manifest Paths |
 | `fix-manifest-paths.sh` | Manifest Path Fixer |
-| `generate-docs.mjs` | Generate Docs |
+| `generate-docs.mjs` | Sync the "AI Tool Support" table's Skills/Slash Co |
 | `generate-locale-coverage.mjs` | Locale Coverage Generator |
 | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9 |
 | `install-hooks.mjs` | Install Hooks |
@@ -368,9 +369,8 @@
 | `pre-release-check.sh` | Pre-release Check Script |
 | `pre-release.ps1` | Pre-Release Preparation Script for Universal Devel |
 | `pre-release.sh` | Pre-Release Preparation Script |
-| `setup-hooks.sh` | setup-hooks.sh — Install git hooks for UDS repo |
 | `setup-husky.mjs` | Cross-platform Husky Setup Script |
-| `sync-manifest.mjs` | Sync Manifest |
+| `sync-manifest.mjs` | Extract top-level Commander command names register |
 
 ---
 

package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md

@@ -311,10 +311,16 @@ your-project/
 
 | 格式 | 文件类型 | Token 使用量 | 适用情境 |
 |------|----------|--------------|----------|
-| **Compact** (推荐) | `.ai.yaml` | ~80% 减少 | AI 助手使用、自动化 |
+| **Compact** (推荐) | `.ai.yaml` | 约小 31%<sup>†</sup> | AI 助手使用、自动化 |
 | **Detailed** | `.md` | 标准 | 人工阅读、团队培训 |
 | **Both** | 两种都有 | 较高 | 需要两种用途 |
 
+<sup>†</sup> 2026-07-23 实测，涵盖同时具备两种形式的 135 份标准：
+`.ai.yaml` 872,380 bytes，`.md` 1,271,471 bytes。重现指令见
+[Content Architecture §7](../../../docs/reference/CONTENT-ARCHITECTURE.md#7-how-to-re-measure)。
+此数字原本写「约减少 80%」，**没有任何量测支持**——
+选这个选项的理由应是「结构化、机器好解析」，不是「省很多 token」。
+
 ### 详细说明
 
 #### Compact (推荐)
@@ -332,9 +338,9 @@ rules:
 ```
 
 **特点**：
-- Token 效率高（约减少 80%）
-- 结构化 YAML 格式
+- 结构化 YAML 格式——解析结果确定
 - 适合 AI 解析
+- 体积约为 Markdown 版的 69%（约小 31%，实测；见上方注）
 
 #### Detailed
 

package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md

@@ -1,7 +1,7 @@
 # UDS 功能参考手册
 
 > Universal Development Standards - 完整功能文档
-> Auto-generated | Last updated: 2026-07-09
+> Auto-generated | Last updated: 2026-07-22
 
 **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
 
@@ -15,9 +15,9 @@
 4. [代理](#agents) (5)
 5. [工作流程](#workflows) (5)
 6. [核心规范](#core-standards) (149)
-7. [脚本](#scripts) (58)
+7. [脚本](#scripts) (57)
 
-**Total Features: 332**
+**Total Features: 331**
 
 ---
 
@@ -314,7 +314,7 @@
 | `changelog-standards` | 1.0.2 | This standard defines how to write and maintain a CHANGELOG.md file to communica |
 | `chaos-engineering-standards` | 1.0.0 |  |
 | `chaos-injection-tests` | - |  |
-| `checkin-standards` | 1.7.0 | This standard defines quality gates that MUST be passed before committing code t |
+| `checkin-standards` | 1.8.0 | This standard defines quality gates that MUST be passed before committing code t |
 | `circuit-breaker` | - |  |
 | `code-review-checklist` | 1.4.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
 | `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
@@ -349,7 +349,7 @@
 | `flaky-test-management` | - |  |
 | `flow-based-testing` | 1.3.1 | This document defines a systematic methodology for testing multi-step processes. |
 | `forward-derivation-standards` | 1.3.0 | This standard defines the principles and workflows for Forward Derivation—automa |
-| `frontend-design-standards` | 1.0.0 | This standard defines a machine-readable frontend design specification format (D |
+| `frontend-design-standards` | 1.1.0 | This standard defines a machine-readable frontend design specification format (D |
 | `full-coverage-testing` | - |  |
 | `git-workflow` | 1.4.0 | This standard defines Git branching strategies and workflows to ensure consisten |
 | `git-worktree` | 1.1.0 | Define a lifecycle for using Git worktrees to isolate development work, ensuring |
@@ -384,13 +384,13 @@
 | `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
 | `prompt-regression` | - |  |
 | `property-based-testing` | - |  |
-| `push-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-04-23 |  |
+| `push-standards` | 1.1.0 | **Status**: Active | **Updated**: 2026-07-09 |  |
 | `recovery-recipe-registry` | - |  |
 | `refactoring-standards` | 2.2.0 | This standard defines comprehensive guidelines for code refactoring, covering ev |
 | `release-quality-manifest` | - |  |
 | `release-readiness-gate` | 1.0.0 | This standard defines a **single, aggregated Release Readiness Gate** that unifi |
 | `replay-test` | - |  |
-| `requirement-engineering` | 1.0.0 |  |
+| `requirement-engineering` | 1.1.0 |  |
 | `resource-cost-boundary` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `retrospective-standards` | 1.0.0 | Retrospectives are structured team reflections that identify what worked well, w |
 | `retry-standards` | - |  |
@@ -429,7 +429,7 @@
 | `translation-lifecycle-standards` | 1.0.0 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
 | `user-journey-testing` | - |  |
 | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
-| `verification-evidence` | 1.0.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
+| `verification-evidence` | 1.2.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
 | `verification-oracle` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `versioning` | 1.5.0 | This standard defines how to version software releases using Semantic Versioning |
 | `virtual-organization-standards` | 1.0.0 | This standard treats the AI ecosystem as a "Virtual Organization." It defines ho |
@@ -487,7 +487,7 @@
 | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
 | `fix-manifest-paths.ps1` | Fix Manifest Paths |
 | `fix-manifest-paths.sh` | Manifest Path Fixer |
-| `generate-docs.mjs` | Generate Docs |
+| `generate-docs.mjs` | Sync the "AI Tool Support" table's Skills/Slash Commands numeric columns |
 | `generate-locale-coverage.mjs` | Locale Coverage Generator |
 | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
 | `install-hooks.mjs` | Install Hooks |
@@ -497,9 +497,8 @@
 | `pre-release-check.sh` | Pre-release Check Script |
 | `pre-release.ps1` | Pre-Release Preparation Script for Universal Development Standards |
 | `pre-release.sh` | Pre-Release Preparation Script |
-| `setup-hooks.sh` | setup-hooks.sh — Install git hooks for UDS repo |
 | `setup-husky.mjs` | Cross-platform Husky Setup Script |
-| `sync-manifest.mjs` | Sync Manifest |
+| `sync-manifest.mjs` | Extract top-level Commander command names registered directly on the |
 
 ---
 

package/bundled/locales/zh-CN/docs/USER-MANUAL.md

@@ -83,29 +83,39 @@ Universal Development Standards 是一套为 AI 时代设计的**语言无关、
 
 ## 架构
 
-UDS 采用**双层执行模型**：
+UDS 的内容沿**两条彼此独立的轴**组织。两者回答的是不同问题，把它们混为一谈是误读本架构最常见的原因。
+
+### 轴一 — 深度：哪些内容必须常驻加载
+
+这是一份行为契约，告诉 AI 代理什么要一开始就读、什么留到被问时再读。**影响 context 成本的是这条轴。**
 
 ```
        AI Agent / 开发者
               |
-        ┌─────┴─────┐
-        |           |
-   Skills Layer   Standards Layer
-   (.ai.yaml)       (.md)
-        |              |
-   省 Token         完整理论
-   交互式向导       工具配置
-   日常开发用       深度参考用
+              v
+      Rules  (core/*.md)                    <- 必读 ALWAYS READ
+      可执行规则、检查清单、阈值
+              |
+              +--- 需要说明？ -----------> Guides (core/guides/*.md)          按需读取
+              |
+              +--- 需要完整方法论？ -----> Methodologies                      按需读取
+                                           (methodologies/guides/*.md)
 ```
 
-| 方面 | Skills（执行层） | Standards（知识层） |
-|------|-----------------|-------------------|
-| 格式 | YAML 优化 | 完整 Markdown |
-| 用途 | 高速交互查询 | 深度理解与依据 |
-| Token 用量 | 最少（AI 友好） | 详尽（参考用） |
-| 使用时机 | 日常开发任务 | 学习概念、深度审查 |
+### 轴二 — 格式：同一份标准的两种编码
+
+这条轴**不带任何深度含义**。同一份标准的 `.ai.yaml` 与 `.md` 是同一份材料的两种编码，依读者是谁而选用。
+
+| 方面 | `ai/standards/*.ai.yaml` | `core/*.md` |
+|------|--------------------------|-------------|
+| 编码 | 结构化 YAML | 散文式 Markdown |
+| 适用于 | 机器确定性查询 | 人类阅读与审查 |
+| 相对体积 | 约为 Markdown 版的 69%——是**换一种格式，不是压缩层** | 基准 |
+
+实际使用中，AI 工具会自动加载 Rules 层。只有当你想了解某条规则的「为什么」时，才需要去读 Guides。
 
-实际使用中，AI 工具会自动加载 Skills 层。只有当你想了解某条规则的「为什么」时，才需要阅读 Standards 层。
+> 📐 深度契约的完整定义、它在各集成工具中的落实情况，以及契约与现况之间已量测到的落差，
+> 记于 [Content Architecture](../../../docs/reference/CONTENT-ARCHITECTURE.md)。
 
 ---
 
@@ -579,12 +589,21 @@ Refs: SPEC-001
 
 | AI 工具 | 状态 | Skills | Slash Commands | 配置文件 |
 |---------|------|--------|----------------|---------|
-| **Claude Code** | 完整支持 | 26 | 30 | `CLAUDE.md` |
-| **OpenCode** | 完整支持 | 26 | 30 | `AGENTS.md` |
-| **Gemini CLI** | Preview | 18+ | 20+ | `GEMINI.md` |
+| **Claude Code** | 完整支持 | 55 | 51 | `CLAUDE.md` |
+| **OpenCode** | 完整支持 | 55 | 51 | `AGENTS.md` |
 | **Cursor** | 完整支持 | Core | Simulated | `.cursorrules` |
-| **Cline / Roo Code** | 部分支持 | Core | Workflow | `.clinerules` |
-| **Windsurf** | 部分支持 | 有 | Rulebook | `.windsurfrules` |
+| **Roo Code** | 完整支持 | Core | Workflow | `.roo/rules/` |
+| **Cline** | 部分支持 | Core | Workflow | `.clinerules` |
+| **Windsurf** | 部分支持 | Core | Rulebook | `.windsurfrules` |
+| **Google Antigravity** | 最低限度 | 🔬 未验证 | — | `.antigravity/rules.md` |
+| **Gemini CLI** | ⛔ 已停止服务 | — | — | `GEMINI.md`（已冻结）|
+
+> Gemini CLI 已于 2026-06-18 由 Google 终止服务，由 Antigravity CLI 接手。
+>
+> **以上集成目前没有任何一个通过行为验证**——「状态」栏说的是**我们写的那份集成**有多完整，
+> 不是该工具是否曾被实测。完整清单、两套图例与验证排程见
+> [README](../../README.md#-ai-工具支持)；验证程序见
+> [Integration Verification](../../../docs/reference/INTEGRATION-VERIFICATION.md)。
 
 > **一套标准，多工具通用** — 换 AI 工具不需要重学标准。
 

package/bundled/locales/zh-CN/integrations/gemini-cli/README.md

@@ -8,6 +8,18 @@ status: current
 
 # Gemini CLI 集成
 
+> ## ⛔ 已停止服务 —— 本集成已冻结
+>
+> Google 已于 **2026-06-18** 终止 Gemini CLI（2026-05-19 I/O 宣布，30 天迁移窗），
+> 由 **Antigravity CLI** 接手。
+>
+> 本目录**仅保留供参考**：已排除于同步检查之外、`skills/` 变更时不会更新、请勿编辑。
+> repo 根目录的 `.gemini/` 树亦同——完整理由与「为何一个月无人察觉」记于
+> [`.gemini/DEPRECATED.md`](../../../../.gemini/DEPRECATED.md)。
+>
+> **要迁移？** 见[根 README](../../../../README.md#-ai-工具支持) 的 Antigravity 条目。
+> 注意 UDS 尚未验证 Antigravity 的 skill 安装路径，因此 `uds init` 不会为它安装 skills。
+
 本目录提供将通用文档规范与 [Gemini CLI](https://geminicli.com/) 集成的资源。
 
 ## 概述

package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: ac-coverage
 source: ../../../../skills/ac-coverage/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: f8358fa818e4
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-07-09
+source_hash: eac0755fd844
 scope: universal
 status: current
 description: "[UDS] 分析验收条件（AC）与测试之间的追踪关系并生成覆盖率报告"
@@ -16,6 +16,12 @@ argument-hint: "[规格文件路径]"
 
 > **语言**: [English](../../../../skills/ac-coverage/SKILL.md) | 简体中文
 
+**版本**: 1.1.0
+**最后更新**: 2026-06-19
+**适用范围**: Claude Code Skills
+
+> **核心标准**: 本技能实现[验收标准可追踪性标准](../../../../core/acceptance-criteria-traceability.md)。如需权威方法论，请参阅核心标准。
+
 分析验收条件（AC）与测试之间的追踪关系，并生成覆盖率报告。
 
 ## 与 `/coverage` 的区别
@@ -30,7 +36,7 @@ argument-hint: "[规格文件路径]"
 ## 工作流程
 
 1. **解析 SPEC** — 从规格文件中抽取 AC 定义（AC-1, AC-2, ...）
-2. **扫描测试** — 依标准链接约定搜索测试文件中的 `@AC` 与 `@SPEC` 标注
+2. **扫描测试** — 搜索测试文件中的**规范标注** `@SPEC-<id> @AC-<n>`（单一合并标签）
 3. **构建矩阵** — 将每个 AC 对应到其测试引用（文件、测试名称、行号）
 4. **分类状态** — 将每个 AC 标记为 ✅ 已覆盖、⚠️ 部分覆盖、或 ❌ 未覆盖
 5. **计算覆盖率** — 套用公式：`覆盖率 % = (已覆盖 + 部分覆盖 × 0.5) / 总数 × 100`

package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../../skills/adr-assistant/SKILL.md
 source_version: 1.0.0
-source_hash: 7d8bf5944cf4
+source_hash: 900a9a7b5b04
 translation_version: 1.0.0
-last_synced: 2026-06-01
+last_synced: 2026-07-09
 status: current
 description: |
   [UDS] 创建、管理和追踪架构决策记录（ADR）。

package/bundled/locales/zh-CN/skills/commands/brainstorm.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../../skills/commands/brainstorm.md
 source_version: 4.0.0
-source_hash: 3212203924de
+source_hash: b4d32a8b638e
 translation_version: 4.0.0
-last_synced: 2026-06-22
+last_synced: 2026-07-09
 ---
 
 ---

package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../../skills/commit-standards/SKILL.md
 source_version: 1.0.0
-source_hash: 8535f438ced8
+source_hash: bc13c6166e8d
 translation_version: 1.0.0
-last_synced: 2026-06-01
+last_synced: 2026-07-09
 status: current
 description: |
   [UDS] 根据 Conventional Commits 规范产生格式正确的 commit message。

package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../../skills/contract-test-assistant/SKILL.md
 source_version: 1.0.0
-source_hash: f67623eb913a
+source_hash: c8b082114d48
 translation_version: 1.0.0
-last_synced: 2026-06-01
+last_synced: 2026-07-09
 status: current
 description: |
   [UDS] 引导 API 和微服务的契约测试策略。

package/bundled/locales/zh-CN/skills/deploy-assistant/SKILL.md

@@ -3,8 +3,8 @@ name: deploy
 source: ../../../../skills/deploy-assistant/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: ff56e7be5b67
+last_synced: 2026-07-09
+source_hash: fc0996a2853c
 status: current
 scope: universal
 description: |

package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md

@@ -3,8 +3,8 @@ name: methodology
 source: ../../../../skills/dev-methodology/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: d654ee51f713
+last_synced: 2026-07-09
+source_hash: e7e6aae82545
 status: current
 scope: partial
 description: |

package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md

@@ -2,8 +2,8 @@
 source: ../../../../skills/dev-workflow-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: 5bf83f0db544
+last_synced: 2026-07-09
+source_hash: bb3068d840d8
 status: current
 description: |
   将软件开发阶段对应到 UDS 命令与技能。

package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md

@@ -3,8 +3,8 @@ name: journey-test-assistant
 source: ../../../../skills/journey-test-assistant/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: 439f49327b75
+last_synced: 2026-07-09
+source_hash: 9230eb251afd
 status: current
 scope: partial
 description: |