universal-dev-standards 6.1.1 → 6.2.0

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)

package/bundled/skills/commands/skill-builder.md

@@ -33,10 +33,79 @@ It is backed by the `skill-builder` skill (`skills/skill-builder/SKILL.md`).
 | Complex | any of the above is exceeded | Create an XSPEC first (`/sdd`), then build |
 | Delta | modifying an existing Skill | Append `## MODIFIED` / `## ADDED`, bump version |
 
-## Implementation Note for AI
+## AI Agent Behavior | AI 代理行為
 
-When the user invokes `/skill-builder`:
-1. Read `skills/skill-builder/SKILL.md` for the full decision tree, placement
-   rules, workflow steps, and output checklist.
-2. Walk the user through path selection (Simple / Complex / Delta) and produce
-   the `SKILL.md` (plus `SKILL-CANDIDATES.md` update) per that skill.
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/skill-builder` | 讀取 `SKILL-CANDIDATES.md`：有已達 3 次的候選 → 列出供選擇；無 → 詢問重複流程的描述 |
+| `/skill-builder <process description>` | 以該描述進入 Step 1，直接開始擷取流程 |
+
+### Interaction Script | 互動腳本
+
+先讀取 `skills/skill-builder/SKILL.md`，取得完整決策樹、放置規則、工作流程與輸出檢查表。
+
+#### Step 1–2: 擷取流程並登記候選
+
+1. 擷取重複序列：步驟與順序、目前手動執行過幾次、觸及哪些工具或檔案
+2. 開啟專案的 `SKILL-CANDIDATES.md`（首次則從 `templates/SKILL-CANDIDATES.md` 複製）
+
+**Decision: 觸發次數**
+- IF 尚未登記 → 新增列，填入目前次數
+- IF 已登記 → 次數 +1
+- IF 次數 < 3 → **告知尚未達觸發門檻，登記後停止，不建立 SKILL.md**
+- IF 次數 ≥ 3 → 標記觸發 ✅，繼續 Step 3
+
+🛑 **STOP**: 次數未達 3 時停止於此，等待使用者明確要求才破例
+
+#### Step 3: 路徑選擇
+
+回答 4 個判斷問題，判定路徑：
+
+- IF ≤7 步、無分支、<3 個標準、無原始碼產出 → **Simple**（Step 4a）
+- IF 上述任一超出 → **Complex**（Step 4b）
+- IF 修改既有 Skill → **Delta**（Step 4c）
+
+🛑 **STOP**: 展示判定結果與理由後等待使用者確認路徑
+
+#### Step 4: 依路徑分流
+
+- **4a Simple** — 以 `templates/SKILL-BRIEF-TEMPLATE.md` 填寫 Brief：觸發情境、3–7 個核心步驟、2–3 條 AC、明確的 out of scope
+- **4b Complex** — 執行 `/sdd` 建立 XSPEC；**XSPEC 未 Approved 前不進入 Step 5**
+- **4c Delta** — 標定既有 SKILL.md 受影響章節，於檔末加 `## MODIFIED Requirements` 或 `## ADDED Requirements`
+
+#### Step 5–7: 產出與登記
+
+1. **放置決策**：步驟引用專案特有路徑（如 `TECH-RADAR.md`、`DEC-*.md`）→ `{project}/.claude/skills/`；步驟為通用 → UDS `skills/{name}/` **並建立 zh-TW locale**
+2. 由 Brief 或 XSPEC 生成 SKILL.md，核對 frontmatter：`name`、`scope`、`description`、`allowed-tools`
+3. 回填 `SKILL-CANDIDATES.md`：觸發 ✅、Skill 欄填入
+4. 依 skill 的 commit 格式提交
+
+🛑 **STOP**: commit 前展示輸出檢查表結果，等待使用者確認
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 觸發次數 < 3 | 使用者是否明確要求破例建立 |
+| 路徑判定後 | 使用者確認 Simple / Complex / Delta |
+| Complex 路徑 | XSPEC 經 `/sdd` 建立並 Approved |
+| commit 前 | 使用者確認輸出檢查表 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 未提供流程描述且無候選 | 詢問重複流程內容，**不得臆造流程** |
+| `SKILL-CANDIDATES.md` 不存在 | 從 `templates/SKILL-CANDIDATES.md` 複製後繼續 |
+| 觸發次數不足 3 次 | 登記候選後停止，說明門檻理由 |
+| 同名 Skill 已存在 | 改走 Delta 路徑，不覆蓋既有 SKILL.md |
+| 放置位置無法判定 | 列出「專案特有 vs 通用」判準請使用者裁定 |
+
+## References | 參考
+
+- [Skill Builder Skill](../skill-builder/SKILL.md)
+- Related: [/sdd](./sdd.md) (Complex path creates an XSPEC first)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "6.1.1",
+  "version": "6.2.0",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",
@@ -62,7 +62,7 @@
     "@inquirer/prompts": "^8.4.2",
     "chalk": "^5.3.0",
     "commander": "^15.0.0",
-    "js-yaml": "^4.1.0",
+    "js-yaml": "^5.2.1",
     "ora": "^9.4.0"
   },
   "devDependencies": {
@@ -70,7 +70,7 @@
     "@vitest/coverage-v8": "^4.1.5",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
-    "eslint": "10.6.0",
+    "eslint": "10.7.0",
     "glob": "^13.0.1",
     "globals": "17.7.0",
     "husky": "^9.1.7",