universal-dev-standards 5.0.0-rc.8 → 5.0.0

package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../integrations/openspec/AGENTS.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-13
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-03-23
 status: current
 ---
 
@@ -100,11 +100,25 @@ openspec list                  # 列出活躍變更
 openspec list --specs          # 列出規格
 openspec show [item]           # 顯示變更或規格
 openspec validate [item]       # 驗證變更或規格
-openspec archive <change-id> [--yes|-y]   # 部署後封存（添加 --yes 用於非互動執行）
+openspec archive <change-id> [--yes|-y]   # 部署後封存
+
+# 瀏覽與狀態
+openspec view                  # 互動式儀表板
+openspec status                # 顯示產物完成進度
+openspec instructions          # 取得建立產物的增強指引
+openspec templates             # 顯示已解析的範本路徑
+
+# Schema 管理
+openspec schemas               # 列出可用的工作流程 schema
+openspec schema init           # 初始化新 schema
+openspec schema fork           # 分叉現有 schema
+openspec schema validate       # 驗證 schema
+openspec schema which          # 顯示使用中的 schema
 
 # 專案管理
 openspec init [path]           # 初始化 OpenSpec
 openspec update [path]         # 更新指令檔案
+openspec config                # 管理設定
 
 # 互動模式
 openspec show                  # 提示選擇
@@ -113,6 +127,10 @@ openspec validate              # 批量驗證模式
 # 除錯
 openspec show [change] --json --deltas-only
 openspec validate [change] --strict
+
+# 工具
+openspec completion            # Shell 整合支援
+openspec feedback              # 透過 GitHub 提交回饋
 ```
 
 ### 指令標誌
@@ -123,6 +141,13 @@ openspec validate [change] --strict
 - `--no-interactive` - 停用提示
 - `--skip-specs` - 封存時不更新規格
 - `--yes`/`-y` - 跳過確認提示（非互動封存）
+- `--no-validate` - 封存時不執行驗證
+- `--sort` - 列表輸出排序
+- `--profile` - 指定初始化設定檔
+- `--requirements` / `--no-scenarios` / `-r` - 過濾 show 輸出
+- `--all` / `--changes` / `--specs` - 過濾驗證範圍
+- `--concurrency` - 平行驗證並發數
+- `--schema` - 指定 status/instructions/templates 的 schema
 
 ## 目錄結構
 

package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md

@@ -1,47 +1,75 @@
 ---
 source: ../../../../integrations/spec-kit/AGENTS.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-13
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-03-23
 status: current
 ---
 
 # Spec Kit 指令
 
-使用 Spec Kit 進行規格驅動開發的 AI 編碼助手指令。
+> **語言**: [English](../../../../integrations/spec-kit/AGENTS.md) | 繁體中文
+
+**版本**: 1.1.0
+**最後更新**: 2026-03-23
+
+為使用 Spec Kit 進行規格驅動開發的 AI 程式助手提供指引。
 
 ## 使用方式
 
-將此檔案複製到您的專案，或包含在 AI 助手的系統指令中。
+將此檔案複製到您的專案中，或納入您的 AI 助手系統指令。
 
 ---
 
 ## 使用 Spec Kit 進行規格驅動開發
 
-當此專案啟用 Spec Kit 時，您必須遵循**規格驅動開發（SDD）**方法論。
+當 Spec Kit 在此專案中啟用時，您必須遵循**規格驅動開發 (SDD)** 方法論。
 
-### 核心原則：規格優先，程式碼其次
+### 核心原則：先規格，後程式碼
 
-**規則**：沒有對應的已核准規格，不得進行任何功能性程式碼變更。
+**規則**：在沒有對應已核准規格的情況下，不得進行任何功能性程式碼變更。
 
-**例外情況**：
-- 緊急修復（立即恢復服務，事後記錄）
-- 瑣碎變更（錯字、註解、格式）
+**例外**：
+- 緊急修復（立即恢復服務，事後補文件）
+- 微小變更（錯字、註解、格式調整）
 
 ---
 
 ## Spec Kit 指令
 
-當 Spec Kit 可用時，優先使用這些指令：
+### CLI 指令
 
 | 指令 | 說明 |
 |------|------|
-| `/spec create <title>` | 建立新規格 |
-| `/spec list` | 列出所有活躍規格 |
-| `/spec show <id>` | 顯示規格詳情 |
-| `/spec approve <id>` | 標記規格為已核准 |
-| `/spec close <id>` | 關閉已完成規格 |
-| `/spec archive <id>` | 封存規格 |
+| `specify init <project-name>` | 初始化新的 SDD 專案 |
+| `specify check` | 驗證已安裝的工具（git、AI agents） |
+
+**Init 選項：**
+
+| 旗標 | 說明 |
+|------|------|
+| `--ai <agent>` | 選擇 AI 助手（claude、gemini、copilot、cursor-agent、windsurf 等） |
+| `--ai-skills` | 以 agent skills 而非斜線指令安裝 |
+| `--here` | 在目前目錄中初始化 |
+| `--force` | 合併時跳過確認 |
+| `--script ps` | PowerShell 腳本（Windows/跨平台） |
+| `--no-git` | 跳過 git 儲存庫初始化 |
+| `--debug` | 啟用詳細輸出 |
+| `--branch-numbering timestamp` | 使用時間戳記式分支命名 |
+
+### 斜線指令（工作流程）
+
+當 Spec Kit 可用時，使用以下斜線指令進行 SDD 工作流程：
+
+| 指令 | 階段 | 說明 |
+|------|------|------|
+| `/constitution` | 設定 | 建立專案治理原則 |
+| `/specify` | 提案 | 定義需求與使用者故事 |
+| `/clarify` | 討論 | 透過結構化問題解決規格歧義 |
+| `/plan` | 設計 | 建立技術實作計畫 |
+| `/tasks` | 規劃 | 產生可執行的任務分解 |
+| `/analyze` | 審查 | 檢查跨產物的一致性 |
+| `/implement` | 實作 | 執行任務以建構功能 |
 
 ### 指令優先順序
 
@@ -49,7 +77,7 @@ status: current
 
 **理由**：
 - **一致性**：確保規格結構遵循 schema
-- **可追溯性**：自動產生 ID 和連結
+- **可追溯性**：自動產生 ID 與建立連結
 - **驗證**：內建檢查防止無效狀態
 
 ---
@@ -57,118 +85,160 @@ status: current
 ## SDD 工作流程
 
 ```
-┌──────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
-│     討論     │───▶│     提案     │───▶│     審查     │───▶│     實作     │
-└──────────────┘    └──────────────┘    └──────────────┘    └──────────────┘
-                                                                   │
-                                                                   ▼
-                                        ┌──────────────┐    ┌──────────────┐
-                                        │     封存     │◀───│     驗證     │
-                                        └──────────────┘    └──────────────┘
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│ Constitution │───▶│   Specify    │───▶│   Clarify    │
+└──────────────┘    └──────────────┘    └──────────────┘
+                                               │
+                    ┌──────────────┐    ┌───────▼──────┐
+                    │  Implement   │◀───│  Plan/Tasks  │
+                    └──────────────┘    └──────────────┘
+                           │
+                    ┌──────▼───────┐
+                    │   Analyze    │
+                    └──────────────┘
 ```
 
 ### 工作流程階段
 
-| 階段 | 說明 | 操作 |
+| 階段 | 說明 | 指令 |
 |------|------|------|
-| **討論** | 釐清需求與探索方案 | 討論紀錄 |
-| **提案** | 定義變更內容和原因 | `/spec create` |
-| **審查** | 利害關係人核准 | `/spec approve` |
-| **實作** | 執行已核准規格 | 程式碼變更 |
-| **驗證** | 確認實作符合規格 | 測試 |
-| **封存** | 關閉並封存規格 | `/spec close` |
+| **Constitution** | 定義專案治理原則 | `/constitution` |
+| **Specify** | 定義需求與使用者故事 | `/specify` |
+| **Clarify** | 透過結構化問題解決歧義 | `/clarify` |
+| **Plan** | 建立技術實作計畫 | `/plan` |
+| **Tasks** | 產生可執行的任務分解 | `/tasks` |
+| **Implement** | 執行任務以建構功能 | `/implement` |
+| **Analyze** | 檢查跨產物的一致性 | `/analyze` |
 
 ---
 
-## 任何任務之前
+## 工作流程強制閘門
+
+**重要**：在執行任何工作流程階段之前，你**必須**檢查先決條件。
+
+### 階段閘門
+
+| 階段 | 先決條件 | 失敗時 |
+|------|----------|--------|
+| Specify | Constitution 已建立（首次時） | → 先執行 `/constitution` |
+| Plan | 需求已透過 `/specify` 定義 | → 先執行 `/specify` |
+| Implement | 計畫已核准、任務已產生 | → 先執行 `/plan` 再執行 `/tasks` |
+| Commit (feat/fix) | 檢查作用中的規格 | → 建議加上 `Refs: SPEC-XXX` |
+
+### 會話啟動協定
+在會話開始時，檢查是否有作用中的工作流程：尋找 `.specify/` 目錄或作用中的規格檔案。
+若發現作用中的工作流程 → 告知使用者並提供繼續的選項。
 
-**脈絡檢查清單**：
-- [ ] 檢查活躍規格：`/spec list`
-- [ ] 變更前審查相關規格
-- [ ] 確認無衝突規格
-- [ ] 非瑣碎變更需建立規格
+參考：`.standards/workflow-enforcement.ai.yaml`
+
+---
+
+## 執行任何任務之前
+
+**情境檢查清單**：
+- [ ] 檢查作用中的規格：尋找 `.specify/` 目錄
+- [ ] 在進行變更前審查相關規格
+- [ ] 確認沒有衝突的規格存在
+- [ ] 若變更非微小則建立規格
 
 **可跳過規格的情況**：
-- 錯誤修復（恢復預期行為）
+- Bug 修復（恢復預期行為）
 - 錯字、格式、註解
-- 依賴更新（非破壞性）
-- 配置變更
+- 相依性更新（非破壞性）
+- 設定檔變更
+
+---
+
+## 目錄結構
+
+```
+.specify/
+├── templates/                    # 核心 spec-kit 範本
+├── extensions/
+│   └── <ext-id>/templates/      # 擴充套件範本
+├── presets/
+│   └── <preset-id>/templates/   # 預設客製化
+└── templates/overrides/          # 專案本地覆寫（最高優先）
+```
 
 ---
 
 ## 規格文件範本
 
-手動建立規格時，使用此結構：
+手動建立規格時，請使用以下結構：
 
 ```markdown
 # [SPEC-ID] 功能標題
 
 ## 摘要
-簡述提議變更。
+簡要描述提議的變更。
 
 ## 動機
-為何需要此變更？解決什麼問題？
+為何需要此變更？它解決什麼問題？
 
 ## 詳細設計
-技術方案、受影響元件、資料流程。
+技術方案、受影響的元件、資料流。
 
 ## 驗收標準
 - [ ] 標準 1
 - [ ] 標準 2
 
-## 依賴項
-列出對其他規格或外部系統的依賴。
+## 相依性
+列出對其他規格或外部系統的相依性。
 
 ## 風險
-潛在風險和緩解策略。
+潛在風險與緩解策略。
 ```
 
 ---
 
-## 與通用文件規範的整合
+## 與 Universal Dev Standards 整合
 
-### Commit 訊息
+### 提交訊息
 
-在 commit 訊息中引用規格 ID：
+在提交訊息中引用規格 ID：
 
 ```
-feat(auth): 實作登入功能
+feat(auth): implement login feature
 
-實作 SPEC-001 登入功能，支援 OAuth2。
+Implements SPEC-001 login functionality with OAuth2 support.
 
 Refs: SPEC-001
 ```
 
 ### 程式碼審查
 
-審查者應確認：
-- [ ] 變更符合已核准規格
-- [ ] 無超出規格的範圍蔓延
+審查者應驗證：
+- [ ] 變更符合已核准的規格
+- [ ] 未超出規格範圍
 - [ ] 規格驗收標準已達成
 
 ---
 
 ## 最佳實踐
 
-### 應該做的
-- 保持規格聚焦且原子化（每個規格一項變更）
-- 包含清晰的驗收標準
+### 應做
+
+- 保持規格聚焦且原子化（每個規格一個變更）
+- 包含明確的驗收標準
 - 將規格連結到實作 PR
+- 使用 `/analyze` 驗證一致性
 - 完成後封存規格
 
-### 不應該做的
-- 規格核准前開始編碼
-- 實作期間修改範圍而不更新規格
-- 讓規格處於懸而未決狀態（始終關閉或封存）
-- 跳過驗證步驟
+### 不應做
+
+- 在規格核准前開始寫程式
+- 在實作期間修改範圍卻未更新規格
+- 讓規格處於未決狀態（應始終關閉或封存）
+- 在需求模糊時跳過 `/clarify` 步驟
 
 ---
 
 ## 相關標準
 
-- [規格驅動開發](../../core/spec-driven-development.md) - SDD 方法論
-- [Commit 訊息指南](../../core/commit-message-guide.md) - Commit 慣例
-- [程式碼簽入標準](../../core/checkin-standards.md) - 簽入要求
+- [規格驅動開發](../../../../core/spec-driven-development.md) - SDD 方法論
+- [提交訊息指南](../../../../core/commit-message-guide.md) - 提交慣例
+- [程式碼簽入標準](../../../../core/checkin-standards.md) - 簽入要求
 
 ---
 
@@ -176,10 +246,11 @@ Refs: SPEC-001
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 1.1.0 | 2026-03-23 | 更新以反映 Spec Kit v0.4.0 實際的 CLI 指令與斜線指令 |
 | 1.0.0 | 2025-12-30 | 初始 Spec Kit 整合 |
 
 ---
 
-## 授權
+## 授權條款
 
-本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
+本文件依 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。

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

@@ -0,0 +1,127 @@
+---
+source: ../../../../skills/ac-coverage-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-24
+status: current
+description: "[UDS] 分析 AC 與測試的追蹤關係及覆蓋率"
+---
+
+# AC 覆蓋率助手
+
+> **語言**: [English](../../../../skills/ac-coverage-assistant/SKILL.md) | 繁體中文
+
+分析驗收條件（AC）與測試之間的追蹤關係，並產生覆蓋率報告。
+
+## 與 `/coverage` 的區別
+
+| 面向 | `/coverage` | `/ac-coverage` |
+|------|-------------|----------------|
+| **範圍** | 程式碼層級（行/分支/函式） | 需求層級（AC 對測試） |
+| **輸入** | 原始碼 + 測試執行器 | SPEC 檔案 + 測試標註 |
+| **問題** | 「有多少程式碼被測試？」 | 「哪些 AC 有測試？」 |
+| **輸出** | 覆蓋率百分比 | 追蹤矩陣 + 缺口報告 |
+
+## 工作流程
+
+1. **解析 SPEC** — 從規格檔案中擷取 AC 定義（AC-1、AC-2、...）
+2. **掃描測試** — 使用標準連結慣例搜尋測試檔案中的 `@AC` 和 `@SPEC` 標註
+3. **建立矩陣** — 將每個 AC 對應到其測試參考（檔案、測試名稱、行號）
+4. **分類狀態** — 將每個 AC 標記為 ✅ 已覆蓋、⚠️ 部分覆蓋 或 ❌ 未覆蓋
+5. **計算覆蓋率** — 套用公式：`覆蓋率 % = (已覆蓋 + 部分 × 0.5) / 總計 × 100`
+6. **產生報告** — 輸出標準化 Markdown 報告
+
+## 標註慣例
+
+測試必須使用標準標註來參考其來源 AC：
+
+```typescript
+// TypeScript/JavaScript
+describe('AC-1: 使用有效憑證登入', () => {
+  // @AC AC-1
+  // @SPEC SPEC-001
+  it('成功登入後應重導至儀表板', () => { ... });
+});
+```
+
+```python
+# Python
+class TestAC1_UserLogin:
+    """AC-1: 使用有效憑證登入
+    @AC AC-1
+    @SPEC SPEC-001
+    """
+    def test_redirect_to_dashboard(self): ...
+```
+
+```gherkin
+# BDD Feature
+@SPEC-001 @AC-1
+Scenario: 使用有效憑證登入
+```
+
+## 覆蓋率門檻
+
+| 門檻 | 預設值 | 強制執行 |
+|------|--------|----------|
+| **提交時** | 80% | 功能分支合併必要條件 |
+| **發布時** | 100% | 正式發布必要條件 |
+| **警告** | 60% | 觸發覆蓋率警告 |
+
+門檻可透過 `--threshold` 參數或專案設定進行配置。
+
+## 報告格式
+
+產生的報告遵循 `core/acceptance-criteria-traceability.md` 中的標準格式：
+
+```markdown
+# AC 覆蓋率報告
+
+**規格**: SPEC-001 — 功能名稱
+**產生日期**: 2026-03-24
+**覆蓋率**: 75% (6/8 AC)
+
+## 摘要
+
+| 狀態 | 數量 | 百分比 |
+|------|------|--------|
+| ✅ 已覆蓋 | 5 | 62.5% |
+| ⚠️ 部分覆蓋 | 2 | 25.0% |
+| ❌ 未覆蓋 | 1 | 12.5% |
+
+## 追蹤矩陣
+
+| AC-ID | 描述 | 狀態 | 測試參考 |
+|-------|------|------|----------|
+| AC-1 | 使用有效憑證登入 | ✅ | auth.test.ts:15 |
+| AC-2 | 拒絕無效憑證 | ✅ | auth.test.ts:32 |
+| ...   | ...            | ... | ... |
+
+## 缺口
+
+- **AC-8**: 社群登入 — 受 OAuth 沙盒環境限制
+
+## 待辦事項
+
+1. [ ] AC-8: 建立 OAuth 沙盒環境（預計完成：待定）
+```
+
+## 使用方式
+
+- `/ac-coverage` - 分析當前專案的 AC 覆蓋率
+- `/ac-coverage path/to/SPEC.md` - 分析特定規格檔案的 AC 覆蓋率
+
+## 下一步引導
+
+`/ac-coverage` 完成後，AI 助手應建議：
+
+> **AC 覆蓋率分析完成。建議下一步：**
+> - 覆蓋率達標 → 執行 `/checkin` 通過品質關卡
+> - 有未覆蓋 AC → 執行 `/derive-tdd` 補齊測試
+> - 有部分覆蓋 AC → 檢查缺少的邊界情況
+
+## 參考
+
+- 核心規範：[acceptance-criteria-traceability.md](../../../../core/acceptance-criteria-traceability.md)
+- 相關：[test-coverage-assistant](../test-coverage-assistant/SKILL.md)（程式碼層級覆蓋率）
+- 相關：[checkin-assistant](../checkin-assistant/SKILL.md)（品質關卡）

package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md

@@ -5,10 +5,7 @@ translation_version: 1.0.0
 last_synced: 2026-02-05
 status: current
 scope: uds-specific
-description: |
-  設計 AI 友善架構，包含明確模式、分層文件和語義邊界。
-  使用時機：為 AI 協作規劃專案結構、優化程式碼庫以利 AI 分析、設定 AI 上下文。
-  關鍵字：architecture, AI-friendly, context, modules, documentation layers, .ai-context.yaml, 架構, AI 友善, 上下文.
+description: "[UDS] 設計 AI 友善架構，包含明確模式、分層文件和語義邊界"
 ---
 
 # AI 友善架構指南

package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md

@@ -5,10 +5,7 @@ translation_version: 1.0.0
 last_synced: 2026-02-05
 status: current
 scope: partial
-description: |
-  建立和維護 AI 指令檔案（CLAUDE.md、.cursorrules 等）並採用適當結構。
-  使用時機：建立 AI 指令檔案、區分通用與專案特定規則、配置 AI 工具。
-  關鍵字：CLAUDE.md, cursorrules, windsurfrules, clinerules, AI instructions, system prompt, 指令檔案, AI 設定.
+description: "[UDS] 建立和維護 AI 指令檔案（CLAUDE.md、.cursorrules 等）並採用適當結構"
 ---
 
 # AI 指令檔案標準指南

package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md

@@ -0,0 +1,97 @@
+---
+source: ../../../../skills/api-design-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-23
+status: current
+description: "[UDS] 引導 API 設計，遵循 REST、GraphQL 和 gRPC 最佳實踐"
+---
+
+# API 設計助手
+
+> **語言**: [English](../../../../skills/api-design-assistant/SKILL.md) | 繁體中文
+
+引導 API 設計，遵循 REST、GraphQL 和 gRPC 最佳實踐。
+
+## 快速參考 — REST 慣例
+
+### HTTP 方法
+
+| 方法 | 用途 | 冪等性 |
+|------|------|--------|
+| GET | 讀取資源 | 是 |
+| POST | 建立資源 | 否 |
+| PUT | 替換資源 | 是 |
+| PATCH | 部分更新 | 否 |
+| DELETE | 刪除資源 | 是 |
+
+### 狀態碼
+
+| 代碼 | 說明 |
+|------|------|
+| 200 | 成功 |
+| 201 | 已建立 |
+| 204 | 無內容（刪除成功） |
+| 400 | 請求格式錯誤 |
+| 401 | 未認證 |
+| 403 | 無權限 |
+| 404 | 資源不存在 |
+| 409 | 資源衝突 |
+| 422 | 驗證失敗 |
+| 429 | 請求過多（限流） |
+| 500 | 伺服器內部錯誤 |
+
+### URL 命名規則
+
+| 模式 | 範例 | 說明 |
+|------|------|------|
+| 集合 | `/users` | 資源集合 |
+| 單一資源 | `/users/{id}` | 單一資源 |
+| 子資源 | `/users/{id}/orders` | 子資源 |
+| 動作 | `/users/{id}/activate` | 動作（僅限 POST） |
+
+## 設計工作流程
+
+```
+DEFINE ──► DESIGN ──► VALIDATE ──► DOCUMENT
+```
+
+### 1. Define — 定義需求
+釐清使用者、使用情境、資料模型和非功能性需求。
+
+### 2. Design — 設計端點
+套用 RESTful 慣例、定義請求/回應 Schema、規劃版本策略。
+
+### 3. Validate — 驗證一致性
+檢查命名一致性、錯誤格式統一、分頁模式。
+
+### 4. Document — 產生文件
+產出 OpenAPI/Swagger 規格或 GraphQL Schema 文件。
+
+## 版本策略
+
+| 策略 | 範例 | 優點 |
+|------|------|------|
+| URL 路徑 | `/v1/users` | 簡單、明確 |
+| Header | `Accept: application/vnd.api+json;v=1` | URL 乾淨 |
+| Query | `/users?version=1` | 容易測試 |
+
+## 使用方式
+
+- `/api-design` - 互動式 API 設計引導
+- `/api-design /users` - 審查特定端點設計
+- `/api-design --graphql` - GraphQL Schema 設計引導
+
+## 下一步引導
+
+`/api-design` 完成後，AI 助手應建議：
+
+> **API 設計完成。建議下一步：**
+> - 執行 `/sdd` 建立正式規格文件
+> - 執行 `/testing` 規劃 API 測試策略
+> - 執行 `/docs` 產生 API 文件
+> - 審查安全性 → 執行 `/security`
+
+## 參考
+
+- 核心規範：[api-design-standards.md](../../../../core/api-design-standards.md)

package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md

@@ -4,10 +4,7 @@ source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-02-10
 status: current
-description: |
-  引導驗收測試驅動開發（ATDD）流程，用於定義和驗證使用者故事。
-  使用時機：定義驗收條件、使用者故事驗證、ATDD 流程。
-  關鍵字：atdd, acceptance, user story, INVEST, 驗收測試, 使用者故事, 驗收條件。
+description: "[UDS] 引導驗收測試驅動開發（ATDD）流程，用於定義和驗證使用者故事"
 ---
 
 # ATDD 助手

package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md

@@ -4,10 +4,7 @@ source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-03-04
 status: current
-description: |
-  UDS 健康檢查與回饋系統。診斷安裝完整性、偵測開發模式、識別摩擦點。
-  使用時機：檢查 UDS 安裝、回報問題、發現規範化機會。
-  關鍵字：audit, health, pattern, friction, feedback, 審計, 健康, 模式, 摩擦, 回饋。
+description: "[UDS] UDS 健康檢查與回饋系統，診斷安裝完整性與偵測開發模式"
 ---
 
 # 審計助手

package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md

@@ -4,10 +4,7 @@ source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-02-10
 status: current
-description: |
-  引導行為驅動開發（BDD）流程，使用 Given-When-Then 格式撰寫場景。
-  使用時機：定義行為場景、撰寫 Gherkin、三劍客會議、BDD 流程。
-  關鍵字：bdd, gherkin, given-when-then, scenario, feature, 行為驅動, 場景, 驗收。
+description: "[UDS] 引導行為驅動開發（BDD）流程，使用 Given-When-Then 格式撰寫場景"
 ---
 
 # BDD 助手