universal-dev-standards 5.4.0 → 5.6.0

package/bundled/locales/zh-TW/skills/methodology-system/SKILL.md

@@ -1,86 +0,0 @@
----
-name: methodology-system
-source: ../../../../skills/methodology-system/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-10
-status: current
-description: "[UDS] 管理當前專案的開發方法論，支援 SDD 和雙迴圈 TDD 兩個獨立系統"
----
-
-# 方法論系統
-
-> **語言**: [English](../../../../skills/methodology-system/SKILL.md) | 繁體中文
-
-> [!WARNING]
-> **實驗性功能**
->
-> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
-
-管理當前專案的開發方法論，支援兩個獨立系統。
-
-**兩個獨立系統：**
-- **系統 A：SDD** - 規格驅動開發（AI 時代、規格優先）
-- **系統 B：雙迴圈 TDD** - BDD（外部迴圈）+ TDD（內部迴圈）（傳統）
-
-**可選輸入：** ATDD - 驗收測試驅動開發（可作為任一系統的輸入）
-
-## 動作
-
-| 動作 | 說明 |
-|------|------|
-| *(無)* / `status` | 顯示當前階段和檢查清單 |
-| `switch <id>` | 切換到不同方法論 |
-| `phase [name]` | 顯示或變更當前階段 |
-| `checklist` | 顯示當前階段檢查清單 |
-| `skip` | 跳過當前階段（會有警告） |
-| `list` | 列出可用方法論 |
-| `create` | 建立自訂方法論 |
-
-## 可用方法論
-
-| 系統 | ID | 工作流程 |
-|------|-----|---------|
-| A：SDD | `sdd` | /sdd -> 審查 -> /derive-all -> 實作 |
-| B：BDD | `bdd` | 探索 -> 制定 -> 自動化 |
-| B：TDD | `tdd` | 紅 -> 綠 -> 重構 |
-| 輸入 | `atdd` | 工作坊 -> 範例 -> 測試 |
-
-## 使用範例
-
-```
-/methodology                    # 顯示當前狀態
-/methodology switch sdd         # 切換到規格驅動開發
-/methodology phase green        # 移至 GREEN 階段（TDD）
-/methodology checklist          # 顯示當前階段檢查清單
-/methodology list               # 列出所有可用方法論
-/methodology skip               # 跳過當前階段（會有警告）
-/methodology create             # 啟動自訂方法論精靈
-```
-
-## 配置
-
-方法論設定儲存在 `.standards/manifest.json`：
-
-```json
-{
-  "methodology": {
-    "active": "sdd",
-    "available": ["tdd", "bdd", "sdd", "atdd"]
-  }
-}
-```
-
-## 下一步引導
-
-`/methodology` 完成後，AI 助手應根據選擇的方法論建議：
-
-> **方法論已設定。建議下一步：**
-> - SDD 方法論 → 執行 `/sdd` 建立規格
-> - BDD 方法論 → 執行 `/bdd` 開始場景探索
-> - TDD 方法論 → 執行 `/tdd` 開始紅綠重構
-> - ATDD 方法論 → 執行 `/atdd` 定義驗收條件
-
-## 參考
-
-- 詳細指南：[guide.md](./guide.md)

package/bundled/locales/zh-TW/skills/methodology-system/create-methodology.md

@@ -1,350 +0,0 @@
----
-source: ../../../../skills/methodology-system/create-methodology.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-12
-status: experimental
----
-
-# 建立自訂方法論指南
-
-> **Language**: [English](../../../../skills/methodology-system/create-methodology.md) | 繁體中文
-
-> [!WARNING]
-> **實驗性功能 / Experimental Feature**
->
-> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
-> This feature is under active development and may change significantly in v4.0.
-
-**版本**: 1.0.0
-**最後更新**: 2026-01-12
-
----
-
-## 概述
-
-本指南幫助您為團隊或專案建立自訂開發方法論。自訂方法論儲存在 `.standards/methodologies/` 目錄中，並遵循與內建方法論相同的 YAML 結構。
-
----
-
-## 互動式建立精靈
-
-使用 `/methodology create` 啟動互動式精靈：
-
-### 步驟 1：基本資訊
-
-```
-╔════════════════════════════════════════════════╗
-║         建立自訂方法論                          ║
-╠════════════════════════════════════════════════╣
-║                                                ║
-║  您的方法論名稱是什麼？                         ║
-║  > 我的團隊工作流                               ║
-║                                                ║
-║  簡短描述：                                     ║
-║  > 我們團隊的迭代開發流程，包含規劃和審查階段   ║
-║                                                ║
-║  ID（自動產生）: my-team-workflow               ║
-║                                                ║
-╚════════════════════════════════════════════════╝
-```
-
-### 步驟 2：定義階段
-
-```
-╔════════════════════════════════════════════════╗
-║         定義階段 (1/?)                          ║
-╠════════════════════════════════════════════════╣
-║                                                ║
-║  階段 1：                                       ║
-║  ─────────────────────────────────────         ║
-║  名稱：規劃                                     ║
-║  描述：規劃實作方法                             ║
-║  預估時間：15-30 分鐘                           ║
-║  表情符號：📋                                   ║
-║                                                ║
-║  檢查清單項目（每行一項）：                     ║
-║  在必填項目前加上 *                             ║
-║  ─────────────────────────────────────         ║
-║  * 需求已理解                                   ║
-║  * 設計方法已審查                               ║
-║  相依性已識別                                   ║
-║                                                ║
-║  什麼觸發離開此階段？                           ║
-║  > 用戶確認規劃完成                             ║
-║                                                ║
-║  離開後的下一個階段？                           ║
-║  > 實作                                         ║
-║                                                ║
-║  [新增另一個階段] [階段定義完成]                ║
-║                                                ║
-╚════════════════════════════════════════════════╝
-```
-
-### 步驟 3：配置檢查點
-
-```
-╔════════════════════════════════════════════════╗
-║         配置檢查點                              ║
-╠════════════════════════════════════════════════╣
-║                                                ║
-║  選擇檢查點提醒：                               ║
-║  ─────────────────────────────────────         ║
-║  [x] 在階段轉換時提醒                           ║
-║  [x] 跳過 3 次簽入後警告                        ║
-║  [ ] 變更超過 200 行後提醒                      ║
-║  [ ] 30 分鐘沒有提交後提醒                      ║
-║                                                ║
-║  提醒強度：                                     ║
-║  ( ) 建議 - 溫和提醒                            ║
-║  (•) 警告 - 更明顯                              ║
-║  ( ) 嚴格 - 阻止直到處理                        ║
-║                                                ║
-╚════════════════════════════════════════════════╝
-```
-
-### 步驟 4：審查並儲存
-
-```
-╔════════════════════════════════════════════════╗
-║         審查方法論                              ║
-╠════════════════════════════════════════════════╣
-║                                                ║
-║  名稱：我的團隊工作流                           ║
-║  ID：my-team-workflow                           ║
-║                                                ║
-║  階段：                                         ║
-║  ─────────────────────────────────────         ║
-║  1. 📋 規劃                                     ║
-║     └─ 檢查清單：3 項（2 項必填）               ║
-║  2. 💻 實作                                     ║
-║     └─ 檢查清單：4 項（3 項必填）               ║
-║  3. 👀 審查                                     ║
-║     └─ 檢查清單：3 項（2 項必填）               ║
-║                                                ║
-║  檢查點：2 個啟用                               ║
-║  強度：警告                                     ║
-║                                                ║
-║  [儲存] [編輯] [取消]                           ║
-║                                                ║
-╚════════════════════════════════════════════════╝
-
-方法論已建立！
-
-儲存到：.standards/methodologies/my-team-workflow.methodology.yaml
-
-啟用：/methodology switch my-team-workflow
-```
-
----
-
-## 手動建立
-
-您也可以手動建立方法論檔案：
-
-### 1. 建立目錄
-
-```bash
-mkdir -p .standards/methodologies
-```
-
-### 2. 建立 YAML 檔案
-
-建立 `.standards/methodologies/my-workflow.methodology.yaml`：
-
-```yaml
-$schema: "https://raw.githubusercontent.com/anthropics/universal-dev-standards/main/methodologies/methodology-schema.json"
-id: my-workflow
-name: My Custom Workflow
-nameZh: 我的自訂工作流
-version: 1.0.0
-description: A custom development workflow for our team
-
-phases:
-  - id: plan
-    name: Planning
-    nameZh: 規劃
-    description: Plan the implementation approach
-    duration: "15-30 minutes"
-    emoji: "📋"
-    checklist:
-      - id: requirements-clear
-        text: Requirements are clearly understood
-        textZh: 需求已清楚理解
-        required: true
-    triggers:
-      exit:
-        - condition: user_confirms_plan_complete
-          nextPhase: implement
-```
-
-### 3. 啟用方法論
-
-```bash
-/methodology switch my-workflow
-```
-
----
-
-## Schema 參考
-
-### 必填欄位
-
-| 欄位 | 類型 | 說明 |
-|------|------|------|
-| `id` | string | 唯一識別碼（小寫、連字號） |
-| `name` | string | 顯示名稱 |
-| `version` | string | 語意化版本 |
-| `phases` | array | 至少一個階段 |
-
-### 階段欄位
-
-| 欄位 | 類型 | 必填 | 說明 |
-|------|------|------|------|
-| `id` | string | 是 | 階段識別碼 |
-| `name` | string | 是 | 顯示名稱 |
-| `description` | string | 是 | 此階段的說明 |
-| `checklist` | array | 否 | 驗證項目 |
-| `triggers` | object | 否 | 進入/離開條件 |
-| `guidance` | object | 否 | AI 提示 |
-| `duration` | string | 否 | 預估時間 |
-| `emoji` | string | 否 | 視覺指示器 |
-
----
-
-## 最佳實踐
-
-### 1. 保持階段專注
-
-每個階段應有明確、單一的目的。如果一個階段有超過 5-6 個檢查項目，考慮拆分。
-
-### 2. 使用有意義的 ID
-
-```yaml
-# 好的
-id: code-review
-id: integration-test
-
-# 避免
-id: phase1
-id: step-a
-```
-
-### 3. 使檢查清單可操作
-
-```yaml
-# 好的
-text: 測試涵蓋邊界情況
-text: 錯誤處理已實作
-
-# 避免
-text: 程式碼很好
-text: 一切正常
-```
-
-### 4. 提供有幫助的引導
-
-在階段引導中包含實用提示：
-
-```yaml
-guidance:
-  prompt: |
-    ## 審查階段
-
-    重點領域：
-    - 安全漏洞
-    - 效能影響
-    - API 契約變更
-
-    {{ checklist | format_checklist }}
-```
-
-### 5. 考慮本地化
-
-始終為雙語團隊提供 `nameZh`、`textZh`、`promptZh`。
-
----
-
-## 範例
-
-### 熱修復工作流
-
-```yaml
-id: hotfix
-name: Hotfix Workflow
-nameZh: 熱修復工作流
-phases:
-  - id: reproduce
-    name: Reproduce Issue
-    nameZh: 重現問題
-    checklist:
-      - id: issue-reproduced
-        text: Issue reproduced locally
-        textZh: 問題已在本地重現
-        required: true
-  - id: fix
-    name: Apply Fix
-    nameZh: 應用修復
-    checklist:
-      - id: minimal-fix
-        text: Fix is minimal and targeted
-        textZh: 修復是最小且針對性的
-        required: true
-  - id: verify
-    name: Verify Fix
-    nameZh: 驗證修復
-    checklist:
-      - id: issue-resolved
-        text: Original issue is resolved
-        textZh: 原始問題已解決
-        required: true
-```
-
-### 功能旗標工作流
-
-```yaml
-id: feature-flag
-name: Feature Flag Development
-nameZh: 功能旗標開發
-phases:
-  - id: design-flag
-    name: Design Flag
-    nameZh: 設計旗標
-    checklist:
-      - id: flag-named
-        text: Flag has descriptive name
-        textZh: 旗標有描述性名稱
-        required: true
-  - id: implement-behind-flag
-    name: Implement Behind Flag
-    nameZh: 在旗標後實作
-    checklist:
-      - id: default-off
-        text: Flag defaults to off
-        textZh: 旗標預設為關閉
-        required: true
-  - id: gradual-rollout
-    name: Gradual Rollout
-    nameZh: 漸進式推出
-    checklist:
-      - id: metrics-monitored
-        text: Metrics being monitored
-        textZh: 正在監控指標
-        required: true
-  - id: cleanup
-    name: Cleanup
-    nameZh: 清理
-    checklist:
-      - id: flag-removed
-        text: Flag code removed after full rollout
-        textZh: 完全推出後移除旗標程式碼
-        required: true
-```
-
----
-
-## 版本歷史
-
-| 版本 | 日期 | 變更 |
-|------|------|------|
-| 1.0.0 | 2026-01-12 | 初始建立指南 |

package/bundled/locales/zh-TW/skills/methodology-system/guide.md

@@ -1,131 +0,0 @@
----
-source: ../../../../skills/methodology-system/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-12
-status: experimental
----
-
-# 方法論系統 Skill
-
-> **Language**: [English](../../../../skills/methodology-system/SKILL.md) | 繁體中文
-
-> [!WARNING]
-> **實驗性功能 / Experimental Feature**
->
-> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
-> This feature is under active development and may change significantly in v4.0.
-
-**版本**: 1.0.0
-**最後更新**: 2026-01-12
-
----
-
-## 概述
-
-方法論系統讓採用此規範的專案能夠選擇、配置並遵循特定的開發方法論。內建支援 TDD、BDD、SDD 和 ATDD，並可建立自訂方法論。
-
----
-
-## 功能
-
-### 核心功能
-
-1. **方法論選擇** - 從內建方法論中選擇或建立自訂方法論
-2. **階段追蹤** - 追蹤當前開發階段，提供階段特定的引導
-3. **檢查點系統** - 在關鍵時刻自動提醒和驗證
-4. **檢查清單** - 每個階段都有必須完成的檢查項目
-5. **AI 引導** - 根據當前階段提供上下文感知的 AI 引導
-
-### 內建方法論
-
-| 方法論 | 說明 | 階段 |
-|--------|------|------|
-| **TDD** | 測試驅動開發 | 紅燈 → 綠燈 → 重構 |
-| **BDD** | 行為驅動開發 | 探索 → 制定 → 自動化 → 活文件 |
-| **SDD** | 規格驅動開發 | 討論 → 提案 → 審查 → 實作 → 驗證 → 歸檔 |
-| **ATDD** | 驗收測試驅動開發 | 工作坊 → 提煉 → 開發 → 展示 |
-
----
-
-## 命令
-
-| 命令 | 說明 |
-|------|------|
-| `/methodology` | 顯示當前方法論狀態 |
-| `/methodology status` | 顯示當前階段和檢查清單 |
-| `/methodology switch <id>` | 切換到不同方法論 |
-| `/methodology phase [name]` | 顯示或變更當前階段 |
-| `/methodology checklist` | 顯示當前階段檢查清單 |
-| `/methodology skip` | 跳過當前階段（會有警告） |
-| `/methodology list` | 列出可用方法論 |
-| `/methodology create` | 建立自訂方法論 |
-
----
-
-## 配置
-
-在 `.standards/manifest.json` 中配置方法論：
-
-```json
-{
-  "methodology": {
-    "active": "tdd",
-    "available": ["tdd", "bdd", "sdd", "atdd"],
-    "config": {
-      "checkpointsEnabled": true,
-      "reminderIntensity": "suggest",
-      "skipLimit": 3
-    }
-  }
-}
-```
-
-### 配置選項
-
-| 選項 | 類型 | 預設值 | 說明 |
-|------|------|--------|------|
-| `active` | string | null | 當前啟用的方法論 ID |
-| `available` | string[] | all | 可用的方法論清單 |
-| `checkpointsEnabled` | boolean | true | 是否啟用檢查點提醒 |
-| `reminderIntensity` | string | "suggest" | 提醒強度：suggest、warn、block |
-| `skipLimit` | number | 3 | 連續跳過幾次後顯示警告 |
-
----
-
-## AI 行為
-
-當方法論啟用時，AI 會：
-
-1. **顯示階段指示器** - 使用表情符號標示當前階段（如 🔴 RED）
-2. **提供階段引導** - 根據當前階段建議適當的行動
-3. **追蹤檢查清單** - 自動追蹤和更新檢查項目狀態
-4. **顯示檢查點** - 在階段轉換或大量變更時提醒用戶
-5. **建議提交** - 根據變更累積量建議適當的提交時機
-
----
-
-## 自訂方法論
-
-可以建立自訂方法論來符合團隊需求：
-
-1. 使用 `/methodology create` 啟動互動式建立精靈
-2. 或手動在 `.standards/methodologies/` 建立 YAML 檔案
-
-詳見 [建立自訂方法論](create-methodology.md)。
-
----
-
-## 相關文件
-
-- [命令文檔](../commands/methodology.md) - `/methodology` 命令詳細文檔
-- [執行時引導](runtime.md) - AI 行為規格
-- [建立自訂方法論](create-methodology.md) - 建立指南
-
----
-
-## 版本歷史
-
-| 版本 | 日期 | 變更 |
-|------|------|------|
-| 1.0.0 | 2026-01-12 | 初始方法論系統 |