universal-dev-standards 6.1.0 → 6.2.0

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

@@ -15,7 +15,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/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-TW/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-TW/core/audit-trail.md

@@ -2,8 +2,8 @@
 source: ../../../core/audit-trail.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-17
-source_hash: 7543ded62881
+last_synced: 2026-07-16
+source_hash: cd5490e92df9
 status: current
 ---
 

package/bundled/locales/zh-TW/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-16
+source_hash: bd53c2d8c8c0
 status: current
 ---
 

package/bundled/locales/zh-TW/core/browser-compatibility-standards.md

@@ -1,20 +1,21 @@
 ---
 source: ../../../core/browser-compatibility-standards.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: b806494266e8
-status: stale
+source_version: 1.0.2
+translation_version: 1.0.2
+last_synced: 2026-07-16
+source_hash: d4a9c4e89256
+status: current
 ---
 
 # 瀏覽器相容性標準
 
 > **語言**：[English](../../../core/browser-compatibility-standards.md) | 繁體中文
 
-**版本**：1.0.0
-**最後更新**：2026-05-05
+**版本**：1.0.2
+**最後更新**：2026-06-18
 **適用範圍**：前端專案（網頁應用程式、漸進式網頁應用程式 PWA、Web Components）
 **範疇**：universal
+**Owning Spec**：XSPEC-293（與 XSPEC-209 路由覆蓋率為正交關係）
 **業界標準**：Browserslist、W3C WebDriver、WebDriver BiDi
 **參考資料**：[caniuse.com](https://caniuse.com/)、[Playwright 瀏覽器支援矩陣](https://playwright.dev/docs/browsers)
 
@@ -36,6 +37,14 @@ status: stale
 | **Tier-2**（部分支援） | 盡力支援；主要流程必須可運作 | ≥ 95% 通過 —— 低於則 WARN，< 90% 則 FAIL |
 | **Tier-3**（盡力而為） | 非正式支援；缺陷會記錄但不阻擋發布 | 僅作為建議參考 |
 
+> **Tier-2「≥95%」／「<90%」門檻 — 依據與可調整性**：這些是 UDS 預設值，可依專案調整。
+> Tier-2 定義為「盡力支援，主要流程必須可運作」，因此閘門容許少量非關鍵失敗的尾端：
+> `≥95%` = 健康（低於此值則 WARN，以提示分流處理）；`<90%` = 實質回歸（FAIL）。
+> 可依你目標市場的瀏覽器覆蓋率調整這些值 —— 例如依 Browserslist 市佔設定
+> （`> 0.5%` 等）推導 Tier-2 瀏覽器清單與通過門檻。**例外**：當失敗的 Tier-2
+> 案例皆為非關鍵流程（以 Tier-3 風格記錄為缺陷）時，發布負責人可在附上記錄
+> 理由的前提下覆寫 WARN/FAIL 判定。
+
 ---
 
 ## 預設瀏覽器矩陣
@@ -218,6 +227,8 @@ last 2 ChromeAndroid versions
 
 | 版本 | 日期 | 變更內容 |
 |---------|------|---------|
+| 1.0.2 | 2026-06-18 | 新增：Tier-2 95%/90% 門檻的依據、可調整性與例外說明（XSPEC-292 T8 / XSPEC-293 AC-293-2） |
+| 1.0.1 | 2026-06-18 | 新增：Owning Spec 指標 → XSPEC-293（XSPEC-291 §11） |
 | 1.0.0 | 2026-05-05 | 首次發布：Tier-1/2/3 矩陣、Playwright 設定、雲端測試、發布閘門條件 |
 
 ---

package/bundled/locales/zh-TW/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-CN/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-TW/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-TW/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-CN/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-TW/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-TW/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/skills/commands/journey-test.md

@@ -36,10 +36,84 @@ It is backed by the `journey-test-assistant` skill
 - `/journey-test` plans a **connected, cross-feature journey** (a sequence of
   steps with ordering and dependencies) and then generates the skeletons.
 
-## Implementation Note for AI
+## AI Agent Behavior | AI 代理行為
 
-When the user invokes `/journey-test`:
-1. Read `skills/journey-test-assistant/SKILL.md` for the full workflow,
-   TESTPLAN format (T-NNN), personas, environment, and archetype rules.
-2. Follow that skill's workflow to produce the TESTPLAN and E2E skeletons.
-3. Respect the skill's `allowed-tools` and stop points.
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/journey-test` | 檢查 `test-plans/` 是否已有 TESTPLAN：有 → 詢問「更新既有」或「新建」；無 → 詢問專案描述後進入生成模式 |
+| `/journey-test <project description>` | 直接進入生成模式，以該描述執行 Phase 1 |
+| `/journey-test --analyze` | 進入分析模式，掃描旅程覆蓋缺口，不產生檔案 |
+| `/journey-test --archetype A1\|A2\|A3` | 進入 Archetype 模式，以指定原型為骨架生成；未帶專案描述時先詢問 |
+
+### Interaction Script | 互動腳本
+
+先讀取 `skills/journey-test-assistant/SKILL.md`，取得 TESTPLAN 格式（T-NNN）、
+Personas、Environment 與 archetype 規則，並遵守該 skill 的 `allowed-tools`。
+
+#### Phase 1: 定義 Persona
+
+1. 分析專案描述，識別所有使用者角色
+2. 定義每個角色的 Actor / Role / Key Permissions
+
+**Decision: 角色無法從描述判定**
+- IF 描述中找不到任何角色 → 詢問使用者列舉角色，不得自行臆造
+- IF 只識別出單一角色 → 明確告知並詢問是否確實為單角色系統
+
+🛑 **STOP**: 展示 Persona 清單後等待使用者確認
+
+#### Phase 2: 設計旅程地圖
+
+1. 列出主要業務目標
+2. 拆解為 T-NNN 步驟群組（T-000 環境重置為 optional）
+3. 宣告步驟間的依賴鏈
+
+🛑 **STOP**: 展示依賴圖後等待使用者確認順序
+
+#### Phase 3: 生成 TESTPLAN
+
+1. 依格式輸出 `test-plans/TESTPLAN-NNN.md`（含 Personas、步驟群組、執行順序依賴圖）
+
+**Decision: 檔案已存在**
+- IF `TESTPLAN-NNN.md` 已存在 → 詢問覆蓋或遞增編號，**不得逕行覆蓋**
+
+#### Phase 4: 生成 E2E 骨架
+
+1. 從 TESTPLAN 的 T-NNN 生成 `*.journey.spec.ts`（含 `describe.skipIf` 與共享 state）
+2. 骨架僅含 `[TODO]` 標記，不生成臆測的斷言
+
+🛑 **STOP**: 產物清單展示後等待使用者決定下一步
+
+#### 分析模式（`--analyze`）
+
+1. 讀取 `test-plans/TESTPLAN-NNN.md`（若存在）
+2. 掃描 `src/e2e/` 下所有 `*.journey.spec.ts` 與 `*.journey.e2e.test.ts`
+3. 比對 TESTPLAN 的 T-NNN 與測試中的 T-NNN 引用
+4. 輸出 Coverage gap 報告，列出缺乏自動化對應的 T-NNN
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| Persona 清單展示後 | 使用者確認角色定義正確 |
+| 依賴圖展示後 | 使用者確認步驟順序 |
+| TESTPLAN 檔案已存在時 | 使用者決定覆蓋或遞增編號 |
+| 產物清單展示後 | 使用者決定是否補實測試內容 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 未提供專案描述且無既有 TESTPLAN | 詢問專案描述，不得自行假設領域 |
+| 專案描述中無法識別任何角色 | 請使用者列舉角色，**不得臆造 persona** |
+| `--archetype` 值不在 A1/A2/A3 | 列出三個原型的適用場景供選擇 |
+| `--analyze` 但 `test-plans/` 不存在 | 告知無 TESTPLAN 可比對，建議先執行生成模式 |
+| `--analyze` 但找不到任何 journey 測試 | 回報覆蓋率為 0 並列出全部 T-NNN，不視為錯誤 |
+
+## References | 參考
+
+- [Journey Test Assistant Skill](../journey-test-assistant/SKILL.md)
+- Related: [/e2e](./e2e.md) (single-scenario E2E skeletons)