universal-dev-standards 5.14.0 → 5.16.0

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

@@ -0,0 +1,108 @@
+---
+name: methodology
+source: ../../../../skills/dev-methodology/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-05-28
+scope: partial
+description: |
+  [UDS] /methodology: 選擇並追蹤開發方法論（SDD/BDD/TDD）。
+  Use when: 選擇方法論、切換開發模式、查詢當前方法論狀態。
+  若要查詢各階段對應指令請用 /dev-workflow。
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[動作] [參數]"
+---
+
+# 方法論系統
+
+> **語言**: [English](../../../../skills/dev-methodology/SKILL.md) | 繁體中文
+
+> [!WARNING]
+> **實驗性功能**
+>
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+
+選擇並管理當前專案啟用的開發方法論。本技能專注於**選擇使用哪種方法論**（SDD、BDD、TDD），並追蹤所選方法論內的階段進度。
+
+> **相關**：如需查詢開發階段對應的 UDS 指令，請改用 `/dev-workflow`。
+
+### 何時使用 `/methodology` 與 `/dev-workflow`
+
+| 情境 | `/methodology` | `/dev-workflow` |
+|------|---------------|-----------------|
+| 在 SDD / BDD / TDD 之間選擇 | ✅ | ❌ |
+| 切換不同方法論 | ✅ | ❌ |
+| 追蹤目前階段進度 | ✅ | ❌ |
+| 找出某個任務該用的 UDS 指令 | ❌ | ✅ |
+| 取得新功能 / Bug 修復的逐步流程 | ❌ | ✅ |
+| 巡覽 8 個開發階段 | ❌ | ✅ |
+
+**兩個獨立系統：**
+- **System A：SDD** — 規格驅動開發（AI 時代，spec-first）
+- **System B：雙迴圈 TDD** — BDD（外圈）+ TDD（內圈）（傳統）
+
+**選用輸入：** ATDD — 驗收測試驅動開發（可餵入任一系統）
+
+## 動作
+
+| 動作 | 說明 |
+|------|------|
+| *(無)* / `status` | 顯示當前階段與檢查清單 |
+| `switch <id>` | 切換到不同方法論 |
+| `phase [name]` | 顯示或變更當前階段 |
+| `checklist` | 顯示當前階段檢查清單 |
+| `skip` | 跳過當前階段（會出現警告） |
+| `list` | 列出可用方法論 |
+| `create` | 建立自訂方法論 |
+
+## 可用方法論
+
+| 系統 | ID | 工作流程 | 說明 |
+|------|-----|----------|------|
+| A: SDD | `sdd` | /sdd → 審查 → /derive-all → 實作 | 規格優先 |
+| B: BDD | `bdd` | Discovery → Formulation → Automation | 外部迴圈 |
+| B: TDD | `tdd` | Red → Green → Refactor | 內部迴圈 |
+| 輸入 | `atdd` | Workshop → Examples → Tests | 驗收測試驅動 |
+
+## 使用範例
+
+```bash
+/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)
+
+## AI 代理行為
+
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/methodology`](../../../../skills/commands/methodology.md#ai-agent-behavior--ai-代理行為)

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 | 初版方法論系統 |

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

@@ -3,7 +3,8 @@ name: dev-workflow-guide
 source: ../../../../skills/dev-workflow-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-03-24
+last_synced: 2026-06-02
+source_hash: 5bf83f0db544
 status: current
 description: "[UDS] 將軟體開發階段對應到 UDS 指令與功能的指南"
 ---
@@ -19,27 +20,29 @@ description: "[UDS] 將軟體開發階段對應到 UDS 指令與功能的指南"
 ## 軟體開發階段總覽
 
 ```
-I. 規劃設計 ──► II. 測試驅動開發 ──► III. 程式碼開發 ──► IV. 品質保證
+I. Planning ──► II. Testing Design ──► III. Implementation ──► IV. Quality Gates
+   需求設計          測試驅動開發            程式碼開發              品質保證
 
-V. 版本提交 ──► VI. 文件與架構 ──► VII. 工具與標準 ──► VIII. 進階分析
+V. Release ──► VI. Documentation ──► VII. Standards ──► VIII. Advanced
+   版本提交         文件與架構              工具與標準           進階分析
 ```
 
 ### 快速對照表
 
-| 階段 | UDS 指令 | 用途 |
-|------|----------|------|
-| **I. 規劃與設計** | `/brainstorm` `/requirement` `/sdd` `/reverse` | 需求、規格、逆向工程 |
-| **II. 測試驅動開發** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` | 先寫測試再寫程式 |
-| **III. 實作** | `/refactor` `/reverse` | 撰寫與改善程式碼 |
-| **IV. 品質關卡** | `/checkin` `/review` | 提交前檢查與程式碼審查 |
-| **V. 發布與提交** | `/commit` `/changelog` `/release` | 版本、提交、發布 |
-| **VI. 文件** | `/docs` `/docgen` `/struct` | 文件與專案結構 |
-| **VII. 工具與標準** | `/discover` `/testing` `/guide` `/git` | 參考指南 |
-| **VIII. 進階分析** | `/methodology` | 跨方法論工作流程 |
+| 階段 | UDS 指令 | 目的 | 用途 |
+|------|----------|------|------|
+| **I. 規劃與設計** | `/brainstorm` `/requirement` `/sdd` `/reverse` `/api-design` `/database` | Requirements, specs, API/DB design | 需求、規格、API/DB 設計 |
+| **II. 測試驅動開發** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` `/ac-coverage` | Design tests before code | 先寫測試再寫程式 |
+| **III. 實作** | `/refactor` `/reverse` `/migrate` `/durable` | Write, improve, and migrate code | 撰寫、改善與遷移程式碼 |
+| **IV. 品質關卡** | `/checkin` `/review` `/security` `/scan` `/incident` | Quality, security, incident response | 品質、安全、事故回應 |
+| **V. 發布與提交** | `/commit` `/changelog` `/release` `/pr` `/ci-cd` | Version, commit, PR, CI/CD | 版本、提交、PR、CI/CD |
+| **VI. 文件** | `/docs` `/docgen` | Docs and project structure | 文件與專案結構 |
+| **VII. 工具與標準** | `/discover` `/guide` `/metrics` `/audit` | Reference guides, metrics, audit | 參考指南、指標、審計 |
+| **VIII. 進階分析** | `/methodology` | Cross-methodology workflows | 跨方法論工作流程 |
 
 ## 常見場景
 
-### 場景 1：新功能開發
+### 場景 1：新功能開發（Greenfield）
 
 從零開始建立新功能的推薦流程：
 
@@ -47,15 +50,15 @@ V. 版本提交 ──► VI. 文件與架構 ──► VII. 工具與標準 ─
 /brainstorm → /requirement → /sdd → /derive → /tdd → /checkin → /commit
 ```
 
-| 步驟 | 指令 | 做什麼 |
-|------|------|--------|
-| 1 | `/brainstorm` | 探索想法與方法 |
-| 2 | `/requirement` | 撰寫使用者故事（INVEST 準則） |
-| 3 | `/sdd` | 建立規格文件 |
-| 4 | `/derive` | 從規格產生測試骨架 |
-| 5 | `/tdd` | 用紅綠重構循環實作 |
-| 6 | `/checkin` | 驗證品質關卡 |
-| 7 | `/commit` | 建立規範化提交 |
+| 步驟 | 指令 | 做什麼 | 做什麼 |
+|------|------|--------|--------|
+| 1 | `/brainstorm` | Explore ideas and approaches | 探索想法與方法 |
+| 2 | `/requirement` | Write user stories (INVEST criteria) | 撰寫使用者故事 |
+| 3 | `/sdd` | Create specification document | 建立規格文件 |
+| 4 | `/derive` | Generate test skeletons from spec | 從規格產生測試骨架 |
+| 5 | `/tdd` | Implement with Red-Green-Refactor | 用紅綠重構循環實作 |
+| 6 | `/checkin` | Verify quality gates | 驗證品質關卡 |
+| 7 | `/commit` | Create conventional commit | 建立規範化提交 |
 
 ### 場景 2：修復錯誤
 
@@ -65,13 +68,13 @@ V. 版本提交 ──► VI. 文件與架構 ──► VII. 工具與標準 ─
 /discover → /reverse → /tdd → /checkin → /commit
 ```
 
-| 步驟 | 指令 | 做什麼 |
-|------|------|--------|
-| 1 | `/discover` | 評估受影響區域健康度 |
-| 2 | `/reverse` | 理解現有程式碼結構 |
-| 3 | `/tdd` | 先寫失敗測試，再修復 |
-| 4 | `/checkin` | 驗證品質關卡 |
-| 5 | `/commit` | 建立規範化提交 |
+| 步驟 | 指令 | 做什麼 | 做什麼 |
+|------|------|--------|--------|
+| 1 | `/discover` | Assess affected area health | 評估受影響區域健康度 |
+| 2 | `/reverse` | Understand existing code structure | 理解現有程式碼結構 |
+| 3 | `/tdd` | Write failing test, then fix | 先寫失敗測試，再修復 |
+| 4 | `/checkin` | Verify quality gates | 驗證品質關卡 |
+| 5 | `/commit` | Create conventional commit | 建立規範化提交 |
 
 ### 場景 3：重構
 
@@ -81,41 +84,75 @@ V. 版本提交 ──► VI. 文件與架構 ──► VII. 工具與標準 ─
 /discover → /reverse → /coverage → /refactor → /checkin → /commit
 ```
 
-| 步驟 | 指令 | 做什麼 |
-|------|------|--------|
-| 1 | `/discover` | 評估專案健康度與風險 |
-| 2 | `/reverse` | 記錄目前行為 |
-| 3 | `/coverage` | 確保測試安全網存在 |
-| 4 | `/refactor` | 套用重構策略 |
-| 5 | `/checkin` | 驗證品質關卡 |
-| 6 | `/commit` | 建立規範化提交 |
+| 步驟 | 指令 | 做什麼 | 做什麼 |
+|------|------|--------|--------|
+| 1 | `/discover` | Assess project health and risks | 評估專案健康度與風險 |
+| 2 | `/reverse` | Document current behavior | 記錄目前行為 |
+| 3 | `/coverage` | Ensure test safety net exists | 確保測試安全網存在 |
+| 4 | `/refactor` | Apply refactoring strategies | 套用重構策略 |
+| 5 | `/checkin` | Verify quality gates | 驗證品質關卡 |
+| 6 | `/commit` | Create conventional commit | 建立規範化提交 |
+
+### 場景 4：安全審查
+
+安全審查與漏洞修復的推薦流程：
+
+```
+/scan → /security → /checkin → /commit
+```
+
+| 步驟 | 指令 | 做什麼 | 做什麼 |
+|------|------|--------|--------|
+| 1 | `/scan` | Run automated security scans (deps, secrets) | 執行自動化安全掃描 |
+| 2 | `/security` | Deep security review (OWASP) | 深入安全審查 |
+| 3 | `/checkin` | Verify quality gates | 驗證品質關卡 |
+| 4 | `/commit` | Create conventional commit | 建立規範化提交 |
+
+### 場景 5：API 設計與實作
+
+API 設計與實作的推薦流程：
+
+```
+/brainstorm → /api-design → /sdd → /derive → /tdd → /pr
+```
+
+| 步驟 | 指令 | 做什麼 | 做什麼 |
+|------|------|--------|--------|
+| 1 | `/brainstorm` | Explore API approaches | 探索 API 方案 |
+| 2 | `/api-design` | Design endpoints and schemas | 設計端點與 schema |
+| 3 | `/sdd` | Create specification document | 建立規格文件 |
+| 4 | `/derive` | Generate test skeletons | 產生測試骨架 |
+| 5 | `/tdd` | Implement with tests | 搭配測試實作 |
+| 6 | `/pr` | Create pull request | 建立 Pull Request |
 
 ## 使用方式
 
 ```bash
-/dev-workflow                    # 顯示完整階段總覽
-/dev-workflow planning           # 取得第 I 階段指引
-/dev-workflow testing            # 取得第 II 階段指引
-/dev-workflow new-feature        # 取得新功能工作流程
-/dev-workflow bug-fix            # 取得修復錯誤工作流程
-/dev-workflow refactoring        # 取得重構工作流程
+/dev-workflow                    # Show full phase overview
+/dev-workflow planning           # Get Phase I guidance
+/dev-workflow testing            # Get Phase II guidance
+/dev-workflow new-feature        # Get new feature workflow
+/dev-workflow bug-fix            # Get bug fix workflow
+/dev-workflow refactoring        # Get refactoring workflow
 ```
 
 ### 支援的參數
 
-| 參數 | 說明 |
-|------|------|
-| `planning` | 第 I 階段：規劃與設計 |
-| `testing` | 第 II 階段：測試驅動開發 |
-| `implementation` | 第 III 階段：程式碼開發 |
-| `quality` | 第 IV 階段：品質保證 |
-| `release` | 第 V 階段：版本與提交 |
-| `docs` | 第 VI 階段：文件與架構 |
-| `standards` | 第 VII 階段：工具與標準 |
-| `advanced` | 第 VIII 階段：進階系統分析 |
-| `new-feature` | 場景：新功能開發 |
-| `bug-fix` | 場景：修復錯誤 |
-| `refactoring` | 場景：重構 |
+| 參數 | 說明 | 說明 |
+|------|------|------|
+| `planning` | Phase I: Planning & Design | 需求與設計 |
+| `testing` | Phase II: Test-Driven Development | 測試驅動開發 |
+| `implementation` | Phase III: Implementation | 程式碼開發 |
+| `quality` | Phase IV: Quality Gates | 品質保證 |
+| `release` | Phase V: Release & Commit | 版本與提交 |
+| `docs` | Phase VI: Documentation | 文件與架構 |
+| `standards` | Phase VII: Tools & Standards | 工具與標準 |
+| `advanced` | Phase VIII: Advanced Analysis | 進階系統分析 |
+| `new-feature` | Scenario: New feature workflow | 場景：新功能開發 |
+| `bug-fix` | Scenario: Bug fix workflow | 場景：修復錯誤 |
+| `refactoring` | Scenario: Refactoring workflow | 場景：重構 |
+| `security` | Scenario: Security review workflow | 場景：安全審查 |
+| `api` | Scenario: API design workflow | 場景：API 設計 |
 
 ## 工作流程行為
 
@@ -125,17 +162,41 @@ V. 版本提交 ──► VI. 文件與架構 ──► VII. 工具與標準 ─
 2. **階段參數**：顯示該階段的詳細指引，包含所有相關指令與範例
 3. **場景參數**：顯示該場景的推薦逐步工作流程
 
+此技能會從 [workflow-phases.md](./workflow-phases.md) 讀取詳細的階段資訊。
+
 ## 下一步引導
 
 `/dev-workflow` 完成後，AI 助手應根據使用者情況建議：
 
-> **工作流程已顯示。建議下一步：**
-> - 新功能開發 → 執行 `/brainstorm` 探索想法
-> - 修復錯誤 → 執行 `/discover` 評估受影響區域
-> - 重構程式碼 → 執行 `/discover` 評估健康度
-> - 遺留系統 → 執行 `/reverse` 進行系統考古
+> **工作流程已顯示。建議下一步 / Workflow displayed. Suggested next steps:**
+> - 新功能開發 → 執行 `/brainstorm` 探索想法 ⭐ **Recommended / 推薦** — New feature → Run `/brainstorm` to explore ideas
+> - 修復錯誤 → 執行 `/discover` 評估受影響區域 — Bug fix → Run `/discover` to assess affected area
+> - 重構程式碼 → 執行 `/discover` 評估健康度 — Refactoring → Run `/discover` to assess health
+> - 遺留系統 → 執行 `/reverse` 進行系統考古 — Legacy system → Run `/reverse` for system archeology
+> - 安全審查 → 執行 `/scan` 掃描漏洞 — Security review → Run `/scan` to find vulnerabilities
+> - API 開發 → 執行 `/api-design` 設計端點 — API development → Run `/api-design` to design endpoints
+> - 事故回應 → 執行 `/incident` 啟動回應流程 — Incident → Run `/incident` to start response
 
 ## 參考
 
-- 詳細階段指引：[workflow-phases.md](../../../../skills/dev-workflow-guide/workflow-phases.md)
-- 每日工作流程指南：[DAILY-WORKFLOW-GUIDE.md](../../../../adoption/DAILY-WORKFLOW-GUIDE.md)
+- [詳細階段指引](./workflow-phases.md) - 完整的逐階段參考
+- [每日工作流程指南](../../adoption/DAILY-WORKFLOW-GUIDE.md) - 完整的每日工作流程指南
+- [功能開發工作流程](../workflows/feature-dev.yaml) - 自動化功能開發工作流程
+- [整合流程工作流程](../workflows/integrated-flow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更內容 |
+|------|------|----------|
+| 1.1.0 | 2026-03-24 | 新增 11 個指令、2 個新場景（安全審查、API 設計） |
+| 1.0.0 | 2026-03-04 | 初版：8 個開發階段、3 個場景、以階段為基礎的導覽 |
+
+---
+
+## 授權
+
+本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
+
+**來源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)