universal-dev-standards 5.15.1 → 5.16.0

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/commands/brainstorm.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-19
+source_version: 3.0.0
+source_hash: 3212203924de
+translation_version: 3.0.0
+last_synced: 2026-06-01
 ---
 
 ---
 name: brainstorm
-description: "[UDS] Structured AI-assisted brainstorming before spec creation"
+description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 argument-hint: "[problem or feature idea | 問題或功能構想]"
 ---
 
@@ -15,9 +16,7 @@ argument-hint: "[problem or feature idea | 問題或功能構想]"
 
 > **Language**: [English](../../../../skills/commands/brainstorm.md) | 繁體中文
 
-在撰寫規格前進行結構化發想。透過引導式腦力激盪，將模糊構想轉化為可執行的功能提案。
-
----
+在撰寫規格前進行結構化發想。透過 persona 集成式腦力激盪，將模糊構想轉化為可執行的功能提案。
 
 ## 用法
 
@@ -28,33 +27,37 @@ argument-hint: "[problem or feature idea | 問題或功能構想]"
 ## 工作流程
 
 ```
-FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
-定義問題     發散思考       收斂評估       輸出提案
+PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► CONVERGE ─────────► OUTPUT
+  防錨定        定義問題    persona 集成+透鏡     多評審面板+硬角色反駁   輸出提案
 ```
 
-| 階段 | 目標 | 關鍵技法 |
-|------|------|----------|
-| **FRAME** | 清楚定義問題 | 5 Whys, HMW, Stakeholder Map |
-| **DIVERGE** | 產生大量想法 | HMW, SCAMPER, Six Thinking Hats |
-| **CONVERGE** | 評估與排序 | Evaluation Matrix, Dot Voting |
-| **OUTPUT** | 可執行的報告 | Brainstorm Report template |
+| 階段 | 目標 | 關鍵技法（v3） |
+|------|------|---------------|
+| **PRE-FLIGHT** | 防止 AI 錨定 | 使用者先寫 3 個想法；無類比種子 |
+| **FRAME** | 清楚定義問題 | 5 Whys、HMW、Stakeholder Map |
+| **DIVERGE** | 逼出視角多樣性 | persona 集成 + 多樣性透鏡 |
+| **CONVERGE** | 降偏誤選擇 | 多評審面板 + Devil's Advocate／Steelman |
+| **OUTPUT** | 可執行的報告 | Brainstorm Report 範本 |
 
 ## 技法
 
 | 技法 | 適用場景 |
 |------|----------|
-| **5 Whys** | 找到根本原因 |
-| **HMW** | 將問題重構為機會 |
-| **SCAMPER** | 改善現有功能 |
-| **Six Thinking Hats** | 多角度分析 |
-| **Dot Voting** | 快速排序 |
+| **Persona ensemble** | 強制視角多樣性（v3 核心） |
+| **Diversity lenses** | 突破顯而易見區（analogical / reversal / morphological） |
+| **Multi-critic panel** | 降偏誤評分（v3 核心） |
+| **Devil's Advocate + Steelman** | 硬角色反駁 |
+| **5 Whys / HMW / SCAMPER / Six Hats** | 經典框定與發散 |
 
 ## 範例
 
 ```bash
-/brainstorm                           # 啟動互動式會話
-/brainstorm "user retention"          # 針對特定主題腦力激盪
-/brainstorm --technique scamper       # 使用特定技法
+/brainstorm                                          # 啟動互動式工作階段
+/brainstorm "user retention"                         # 針對特定主題腦力激盪
+/brainstorm --enhanced "user retention"              # 平行 persona 集成（若宿主支援）
+/brainstorm --personas "designer,economist,skeptic"  # 自訂 persona
+/brainstorm --lens analogical "onboarding"           # 強制類比透鏡
+/brainstorm --quick "reduce checkout friction"       # 快速 3 想法模式
 ```
 
 ## 輸出格式
@@ -66,9 +69,10 @@ FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
 [Refined problem from FRAME phase]
 
 ## Top 3 Recommendations
-1. **[Idea]** — Score: X.X — [Why recommended]
-2. **[Idea]** — Score: X.X — [Why recommended]
-3. **[Idea]** — Score: X.X — [Why recommended]
+1. **[Idea]** — Agg. X.X ✓ Passed rebuttal — Persona: [..] — [Why recommended]
+
+## Diversity Note
+[How many distinct personas/lenses the surviving ideas span]
 
 ## Next Steps
 - [ ] Proceed to `/requirement` with top idea
@@ -84,8 +88,69 @@ FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
 3. `/sdd` - 建立規格文件
 4. `/derive-all` 或 `/tdd` - 以測試保護進行實作
 
+## AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/brainstorm` | 啟動 PRE-FLIGHT，請使用者先寫 問題＋3 想法＋反向排除 |
+| `/brainstorm "topic"` | 以指定主題啟動 PRE-FLIGHT，再進入 FRAME |
+| `/brainstorm --personas "a,b,c"` | 以自訂 persona 組進入 DIVERGE |
+| `/brainstorm --lens <name>` | 以指定多樣性透鏡為主進入 DIVERGE |
+| `/brainstorm --enhanced` | 若宿主支援子代理則平行跑 persona／評審，否則靜默退回 baseline |
+
+### 互動腳本
+
+#### PRE-FLIGHT Phase
+1. 請使用者先寫 問題（一句）＋3 個初始想法＋最不想要的解法類型
+2. 拒絕「像 X 但給 Y」種子，改寫為底層問題
+
+🛑 **STOP**: 收到三項輸入前不生成任何想法（`--skip-preflight` 例外，顯示錨定警告）
+
+#### FRAME Phase
+1. 釐清問題陳述（5 Whys 找根因）
+2. 重構為 HMW 問題；識別利害關係人
+
+🛑 **STOP**: 問題定義後等待使用者確認
+
+#### DIVERGE Phase
+1. 逐一以預設 persona（領域專家／懷疑者／跨域類比者／成本約束者／使用者代言）思維鏈生成想法
+2. **分支隔離**：生成各 persona 時不互相預覽，全部產完才一起呈現
+3. 至少套用一個多樣性透鏡（類比／假設反轉／形態矩陣）
+4. 以多樣性（覆蓋的 persona／透鏡數）而非數量為繼續門檻
+
+#### CONVERGE Phase
+1. 以 3 個獨立評審（工程可行性／使用者影響／策略一致）各自評分後聚合
+2. 對前 3 名跑硬角色 Devil's Advocate（論證會失敗）+ Steelman；使用者以 (a)修改／(b)反駁／(c)移除 回應
+3. 排序並標記通過反駁的想法
+
+🛑 **STOP**: 展示 Brainstorm Report 後等待使用者決定下一步
+
+### 停止點
+
+| 停止點 | 等待內容 |
+|--------|---------|
+| PRE-FLIGHT 提交前 | 收到使用者三項輸入 |
+| 問題定義後 | 確認問題正確 |
+| 反駁輪每個反對理由 | 使用者 (a)／(b)／(c) 回應 |
+| 報告展示後 | 決定進入 `/requirement` 或 `/sdd` |
+
+### 錯誤處理
+
+| 錯誤情況 | AI 動作 |
+|---------|---------|
+| 主題太廣泛 | 引導縮小範圍 |
+| 使用「像 X 但給 Y」種子 | 改寫為底層問題再繼續（反種子 guardrail） |
+| 指定的 persona／透鏡不存在 | 列出可用選項供選擇 |
+| `--enhanced` 但宿主不支援子代理 | 靜默退回 baseline，照常進行 |
+| 前 3 名全來自同一 persona／透鏡 | 標示並在輸出前再跑一個透鏡 |
+
 ## 參考
 
 * [Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md)
+* [Brainstorm Assistant Guide](../brainstorm-assistant/guide.md)
 * [Requirement Assistant](../requirement-assistant/SKILL.md)
 * [Spec-Driven Development](../spec-driven-dev/SKILL.md)

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

@@ -2,8 +2,9 @@
 name: commit-standards
 source: ../../../../skills/commit-standards/SKILL.md
 source_version: 1.0.0
+source_hash: 8535f438ced8
 translation_version: 1.0.0
-last_synced: 2026-02-10
+last_synced: 2026-06-01
 status: current
 description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 commit message"
 ---
@@ -16,31 +17,34 @@ description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 comm
 
 ## 工作流程
 
+0. **偵測語言** - 讀取 `.standards/manifest.json` → 檢查 `options.output_language`。若找不到，預設為 `english`。
 1. **檢查狀態** - 執行 `git status` 和 `git diff --staged` 了解變更內容
 2. **分析變更** - 判斷類型（feat、fix、refactor 等）和範圍
-3. **產生訊息** - 根據以下格式建立 commit message
+3. **產生訊息** - 依偵測到的語言，按以下對應格式建立 commit message（見下方）
 4. **確認並提交** - 在執行 `git commit` 前詢問使用者確認
 
 ### 訊息格式
 
 ```
 <type>(<scope>): <subject>
+
 <body>
+
 <footer>
 ```
 
 ## 提交類型
 
-| 類型 | 使用時機 | When to Use |
-|------|---------|-------------|
-| `feat` | 新功能 | New feature |
-| `fix` | 修復錯誤 | Bug fix |
-| `refactor` | 重構（無功能變更） | Code refactoring |
-| `docs` | 文件更新 | Documentation |
-| `style` | 格式調整（無邏輯變更） | Formatting |
-| `test` | 測試相關 | Tests |
-| `perf` | 效能優化 | Performance |
-| `chore` | 維護任務 | Maintenance |
+| 類型 | 使用時機 |
+|------|---------|
+| `feat` | 新功能 |
+| `fix` | 修復錯誤 |
+| `refactor` | 重構（無功能變更） |
+| `docs` | 文件更新 |
+| `style` | 格式調整（無邏輯變更） |
+| `test` | 測試相關 |
+| `perf` | 效能優化 |
+| `chore` | 維護任務 |
 
 ## 規則
 
@@ -48,6 +52,60 @@ description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 comm
 - **Body**：說明**為什麼**進行變更，而非僅描述變更了什麼
 - **Footer**：使用 `BREAKING CHANGE:` 標記破壞性變更，使用 `Fixes #123` 關聯 issue
 
+## 雙語格式
+
+當 `output_language` 為 `bilingual` 時，你必須使用以下格式：
+
+```
+<type>(<scope>): <English subject>. <中文主旨>.
+
+<English body — explain what and why in English>
+
+<中文本文 — 用中文說明做了什麼及為什麼>
+
+<footer>
+```
+
+### 必須遵守的規則
+
+1. 英文本文在前，中文本文在後
+2. 英文本文與中文本文之間以空白行分隔
+3. 嚴禁在同一段落內混用語言
+4. 嚴禁省略中文本文——兩種語言皆為必填
+5. Footer（BREAKING CHANGE、Fixes #、Co-authored-by）置於兩段本文之後的最末端
+
+### 雙語範例
+
+```
+feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援.
+
+Implement Google OAuth2 authentication flow for user login.
+
+- Add Google OAuth2 SDK integration
+- Create callback endpoint for OAuth flow
+- Store refresh tokens securely
+
+實作 Google OAuth2 認證流程供使用者登入。
+
+- 整合 Google OAuth2 SDK
+- 建立 OAuth 流程回呼端點
+- 安全儲存更新權杖
+
+Closes #123
+```
+
+## 繁體中文格式
+
+當 `output_language` 為 `traditional-chinese` 時，使用中文類型與本文：
+
+```
+功能(認證): 新增 OAuth2 Google 登入支援
+
+實作 Google OAuth2 認證流程供使用者登入。
+
+關閉 #123
+```
+
 ## 使用方式
 
 - `/commit` - 自動分析 staged 的變更並建議 commit message
@@ -58,11 +116,15 @@ description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 comm
 `/commit` 完成後，AI 助手應建議：
 
 > **提交完成。建議下一步：**
-> - 執行 `git push` 推送到遠端
-> - 準備發布時 → 執行 `/changelog` + `/release`
-> - 發現重複模式或規範摩擦 → 執行 `/audit --report` 回報
+> - 執行 `git push` 推送到遠端 ⭐ **推薦** — 推送到遠端
+> - 準備發布時 → 執行 `/changelog` + `/release` — 準備發布時執行
+> - 發現重複模式或規範摩擦 → 執行 `/audit --report` 回報 — 偵測到模式或摩擦時回報意見
 
 ## 參考
 
 - 詳細指南：[guide.md](./guide.md)
 - 核心規範：[commit-message-guide.md](../../../../core/commit-message-guide.md)
+
+## AI 代理行為
+
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/commit`](../commands/commit.md#ai-agent-behavior--ai-代理行為)

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

@@ -2,8 +2,9 @@
 name: contract-test-assistant
 source: ../../../../skills/contract-test-assistant/SKILL.md
 source_version: 1.0.0
+source_hash: f67623eb913a
 translation_version: 1.0.0
-last_synced: 2026-03-26
+last_synced: 2026-06-01
 status: current
 description: "[UDS] 引導 API 和微服務的合約測試策略"
 ---
@@ -14,6 +15,42 @@ description: "[UDS] 引導 API 和微服務的合約測試策略"
 
 引導 API 和微服務的合約測試策略選擇、設定和驗證。
 
+## 什麼是合約測試？
+
+合約測試透過測試消費者和提供者之間的協議（合約）來驗證服務間的通訊正確性，不需要所有服務同時運行。
+
+## 策略選擇
+
+| 策略 | 適用場景 | 工具 |
+|------|---------|------|
+| **消費者驅動（Consumer-Driven）** | 內部微服務，團隊同時擁有兩端 | Pact |
+| **提供者驅動（Provider-Driven）** | 公開 API，OpenAPI 優先設計 | OpenAPI + Prism |
+| **雙向（Bi-Directional）** | 混合所有權，漸進採用 | Pact + OpenAPI |
+
+## 工作流程
+
+```
+ASSESS ──► CHOOSE ──► DEFINE ──► IMPLEMENT ──► VERIFY
+  評估架構    選擇策略    定義合約     實作測試      驗證合約
+```
+
+### 1. ASSESS — 評估架構
+- 有多少服務互相通訊？
+- 誰擁有消費者端、誰擁有提供者端？
+
+### 2. CHOOSE — 選擇策略
+- 消費者驅動（Pact）vs 提供者驅動（OpenAPI）
+
+### 3. DEFINE — 定義合約
+- 撰寫消費者期望或 OpenAPI 規格
+
+### 4. IMPLEMENT — 實作測試
+- 消費者測試產生合約
+- 提供者測試驗證合約
+
+### 5. VERIFY — 執行驗證
+- CI 管線在每個 PR 上驗證合約
+
 ## 指令
 
 | 指令 | 說明 |
@@ -23,31 +60,53 @@ description: "[UDS] 引導 API 和微服務的合約測試策略"
 | `/contract-test provider` | 引導提供者測試設定 |
 | `/contract-test verify` | 檢查合約覆蓋率 |
 
-## 參考
+## 合約覆蓋率報告
+
+```markdown
+## 合約覆蓋率報告
+
+| 消費者 | 提供者 | 端點 | 狀態 |
+|--------|--------|------|------|
+| web-app | user-api | GET /users/:id | ✅ 已驗證 |
+| web-app | user-api | POST /users | ✅ 已驗證 |
+| mobile-app | auth-api | POST /login | ⚠️ 僅消費者端 |
+| admin-ui | report-api | GET /reports | ❌ 無合約 |
 
-- 詳細指南：[contract-testing.md](../../../../options/testing/contract-testing.md)
-- 技能指南：[guide.md](./guide.md)
+**覆蓋率**：50%（2/4 個端點兩端皆驗證）
+```
 
+## 與其他技能的整合
 
-## Next Steps Guidance | 下一步引導
+| 技能 | 整合方式 |
+|------|---------|
+| `/api-design` | 設計時定義 API 合約 |
+| `/ci-cd` | 管線中加入合約驗證 |
+| `/testing` | 合約測試作為測試策略一部分 |
+| `/migrate` | API 遷移時捕獲 legacy response fixture，驗證新實作保持結構性等價 |
 
-After `/contract-test` completes:
+### 遷移合約測試（替換實作時）
+
+當 API endpoint 從一個技術棧遷至另一個（PHP → .NET、Express → Spring 等），對 **legacy 參考 fixture** 的 contract test 可捕捉「缺漏欄位」「rename」「層級漂移」等新 DTO 單元測試無法覆蓋的缺陷。詳見 [migration-assistant § API Migration Contract Tests](../migration-assistant/SKILL.md#api-migration-contract-tests--api-遷移合約測試) 取得 fixture 捕獲協議與稽核檢查清單。
+
+## 下一步引導
+
+`/contract-test` 完成後：
 
 > **合約測試引導完成。建議下一步：**
 > - 執行 `/ci-cd` 將合約驗證加入 CI 管線
 > - 執行 `/api-design` 完善 API 設計
 > - 執行 `/testing` 整合到整體測試策略
 
-## Reference | 參考
+## 參考
 
-- Detailed guide: [contract-testing.md](../../options/testing/contract-testing.md)
-- Related: [api-design-assistant](../api-design-assistant/SKILL.md)
+- 詳細指南：[contract-testing.md](../../options/testing/contract-testing.md)
+- 相關：[api-design-assistant](../api-design-assistant/SKILL.md)
 
-## AI Agent Behavior | AI 代理行為
+## AI 代理行為
 
-When `/contract-test` is invoked:
-1. **Assess** — Ask about architecture (monolith, microservices, number of APIs)
-2. **Recommend** — Suggest strategy based on architecture
-3. **Guide** — Walk through setup for chosen strategy
-4. **Generate** — Create example contract test files
-5. **Verify** — If `verify` subcommand, scan for contracts and report coverage
+當 `/contract-test` 被呼叫時：
+1. **評估（Assess）** — 詢問架構（單體、微服務、API 數量）
+2. **推薦（Recommend）** — 依架構建議策略
+3. **引導（Guide）** — 逐步引導所選策略的設定
+4. **產生（Generate）** — 建立範例合約測試檔案
+5. **驗證（Verify）** — 若為 `verify` 子指令，掃描合約並回報覆蓋率

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

@@ -0,0 +1,255 @@
+---
+source: ../../../../skills/dev-methodology/guide.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-06-02
+source_hash: a17742b81576
+status: current
+scope: partial
+description: |
+  管理並引導開發者完成當前的開發方法論（methodology）工作流程。
+  使用時機：需要 TDD、BDD、SDD、ATDD 或自訂方法論工作流程時。
+  關鍵字：methodology、workflow、TDD、BDD、SDD、ATDD、phase、checkpoint、開發流程。
+---
+
+> [!WARNING]
+> **Experimental Feature / 實驗性功能**
+>
+> This feature is under active development and may change significantly in v4.0.
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+
+# Methodology System Skill
+
+> **語言**：[English](../../../../skills/dev-methodology/guide.md) | 繁體中文
+
+**版本**：2.0.0
+**最後更新**：2026-01-25
+
+---
+
+## 概觀
+
+Methodology System 為採用 Universal Development Standards 的專案提供一套統一的開發方法論管理框架。
+
+### 兩套獨立系統
+
+```
+┌────────────────────────────────────────────────────────────────────────────┐
+│                  Two Independent Methodology Systems                         │
+├────────────────────────────────────────────────────────────────────────────┤
+│                                                                            │
+│  System A: SDD (AI-Era Methodology)                                        │
+│  ─────────────────────────────────────                                     │
+│  /sdd → Review → /derive-all → Implementation → Verification               │
+│  Best for: New projects, AI-assisted development, greenfield features     │
+│                                                                            │
+│  System B: Double-Loop TDD (Traditional)                                   │
+│  ─────────────────────────────────────                                     │
+│  /bdd (Outer Loop) → /tdd (Inner Loop) → Demo                              │
+│  Best for: Legacy systems, manual development, established codebases      │
+│                                                                            │
+│  Optional Input: ATDD Workshop                                             │
+│  ─────────────────────────────────────                                     │
+│  Stakeholder collaboration that feeds into EITHER system                   │
+│                                                                            │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 支援的方法論
+
+**System A：SDD（Spec-Driven Development）**
+- Discuss → Proposal → Review → Forward Derivation → Implementation → Verification → Archive
+- 以規格（spec）作為權威來源的 AI 原生工作流程
+
+**System B：Double-Loop TDD**
+- **BDD**（外迴圈 Outer Loop）- Discovery → Formulation → Automation
+- **TDD**（內迴圈 Inner Loop）- Red → Green → Refactor
+
+**選用輸入**
+- **ATDD** - Acceptance Test-Driven Development 工作坊（可饋入任一系統）
+
+**Custom** - 使用者自訂的方法論
+
+---
+
+## 功能
+
+### 1. 階段感知引導（Phase-Aware Guidance）
+
+AI 會自動追蹤當前階段，並提供符合情境的引導：
+
+```
+┌─────────────────────────────────────────────┐
+│ 📋 Current Methodology: TDD                  │
+│ 📍 Current Phase: 🔴 RED (1-5 min)           │
+│                                             │
+│ Checklist:                                  │
+│   ✅ Test describes behavior                │
+│   ✅ Test name is clear                     │
+│   ⬜ Test follows AAA pattern               │
+│   ⬜ Test fails when run                    │
+│                                             │
+│ Next: Write the test following AAA pattern  │
+└─────────────────────────────────────────────┘
+```
+
+### 2. 檢查點提醒（Checkpoint Reminders）
+
+依據方法論觸發條件自動提醒：
+
+- **Phase Transition（階段轉換）**：階段完成時建議提交（commit）
+- **Accumulation Warning（累積警告）**：變更超過門檻時提出警告
+- **Skip Warning（略過警告）**：連續略過 check-in 後提出警示
+
+### 3. 方法論切換（Methodology Switching）
+
+隨著專案需求變化，在不同方法論之間切換：
+
+```
+/methodology switch bdd
+```
+
+### 4. 自訂方法論支援（Custom Methodology Support）
+
+在 `.standards/methodologies/` 中定義團隊專屬的工作流程：
+
+```yaml
+id: my-team-workflow
+name: My Team Workflow
+phases:
+  - id: plan
+    name: Planning
+    checklist:
+      - id: requirements-clear
+        text: Requirements understood
+        required: true
+```
+
+---
+
+## 指令
+
+| 指令 | 說明 |
+|---------|-------------|
+| `/methodology` | 顯示當前方法論狀態 |
+| `/methodology switch <id>` | 切換至不同的方法論 |
+| `/methodology phase [phase]` | 顯示或變更當前階段 |
+| `/methodology checklist` | 顯示當前階段的檢查清單 |
+| `/methodology skip` | 略過當前階段（附帶警告） |
+| `/methodology list` | 列出可用的方法論 |
+| `/methodology create` | 建立自訂方法論 |
+
+---
+
+## 設定
+
+方法論設定儲存於 `.standards/manifest.json`：
+
+```json
+{
+  "methodology": {
+    "active": "tdd",
+    "available": ["tdd", "bdd", "sdd", "atdd"],
+    "config": {
+      "tdd": {
+        "checkpointsEnabled": true,
+        "reminderIntensity": "suggest",
+        "skipLimit": 3
+      }
+    }
+  }
+}
+```
+
+### 設定選項
+
+| 選項 | 值 | 說明 |
+|--------|--------|-------------|
+| `active` | methodology id | 當前啟用的方法論 |
+| `checkpointsEnabled` | `true`/`false` | 啟用檢查點提醒 |
+| `reminderIntensity` | `suggest`/`warning`/`strict` | 強制執行檢查點的強度 |
+| `skipLimit` | 數字 | 提出警告前可連續略過的次數 |
+
+---
+
+## AI 行為
+
+### 偵測（Detection）
+
+1. 檢查 `.standards/manifest.json` 中的 `methodology.active`
+2. 從以下位置載入方法論定義：
+   - 內建：`methodologies/{id}.methodology.yaml`
+   - 自訂：`.standards/methodologies/{id}.methodology.yaml`
+
+### 階段追蹤（Phase Tracking）
+
+- 依據觸發條件追蹤當前階段
+- 在符合退出條件時更新階段
+- 提供階段專屬的引導與檢查清單
+
+### 情境關鍵字（Context Keywords）
+
+當偵測到下列關鍵字時，AI 會自動啟用對應的方法論情境：
+
+| 系統 | 方法論 | 關鍵字 |
+|--------|-------------|----------|
+| A: SDD | SDD | specification, spec first, proposal, derive tests, forward derivation |
+| B: Double-Loop | BDD（外迴圈） | given when then, gherkin, cucumber, scenario, discovery |
+| B: Double-Loop | TDD（內迴圈） | test first, red green refactor, failing test |
+| Input | ATDD | acceptance test, user story, product owner, workshop |
+
+---
+
+## 與其他標準的整合
+
+### Check-in Standards
+
+當某階段完成時，方法論系統會與 `checkin-standards.md` 整合：
+
+```
+Phase GREEN completed.
+
+Changes:
+- Files: 3
+- Lines: +45 / -2
+
+Suggested commit:
+  test(auth): add login validation test
+  feat(auth): implement login validation
+
+[1] Commit now  [2] Continue working  [3] View changes
+```
+
+### Code Review
+
+依據當前啟用的方法論，會加入額外的審查檢查項目：
+
+- **TDD**：測試遵循命名慣例、每個測試只驗證單一行為
+- **BDD**：宣告式風格、可重用的步驟
+- **SDD**：變更符合規格、無範疇蔓延（scope creep）
+- **ATDD**：所有驗收條件都有對應測試
+
+---
+
+## 相關技能
+
+- [TDD Assistant](../tdd-assistant/SKILL.md) - 詳細的 TDD 引導
+- [Spec-Driven Dev](../spec-driven-dev/SKILL.md) - SDD 工作流程
+- [Code Review Assistant](../code-review-assistant/SKILL.md) - 審查整合
+
+---
+
+## 檔案
+
+- [integrated-flow.md](./integrated-flow.md) - 兩套系統的完整工作流程指南
+- [runtime.md](./runtime.md) - AI 行為與執行期（runtime）指南
+- [create-methodology.md](./create-methodology.md) - 自訂方法論建立精靈
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更內容 |
+|---------|------|---------|
+| 2.0.0 | 2026-01-25 | 重構為兩套獨立系統的架構 |
+| 1.0.0 | 2026-01-12 | 初版方法論系統 |