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

package/bundled/skills/commands/dev-workflow.md

@@ -10,6 +10,54 @@ Map your current development phase to UDS commands. Get guidance on which tools
 
 將你目前的開發階段對應到 UDS 指令。了解在每個階段應該使用哪些工具。
 
+## Context-Aware Start | 情境感知啟動
+
+When `/dev-workflow` is invoked, the AI assistant MUST first check the project's workflow state:
+
+當調用 `/dev-workflow` 時，AI 助手必須先檢查專案的工作流程狀態：
+
+### Step 1: Check Active Workflows | 檢查進行中的工作流程
+
+```bash
+ls .workflow-state/*.yaml .workflow-state/*.json 2>/dev/null
+```
+
+**If active workflows found | 如果有進行中的工作流程：**
+
+1. Display active workflow summary (name, phase, progress)
+2. Suggest resuming: "You have an active **{workflow}** at phase **{phase}**. Resume with `/{command}`?"
+3. Show the appropriate next command based on current phase
+
+**Phase → Next Command Mapping | 階段 → 下一步指令對應：**
+
+| Workflow | Current Phase | Suggested Next Command |
+|----------|--------------|----------------------|
+| SDD | discuss | `/sdd create` |
+| SDD | create | `/sdd review` |
+| SDD | review | `/sdd approve` |
+| SDD | approve | `/sdd implement` |
+| SDD | implement | `/sdd verify` |
+| TDD | red | Write failing test, then run tests |
+| TDD | green | Write minimal code to pass |
+| TDD | refactor | Clean up, then `/tdd` for next cycle |
+| BDD | discovery | `/bdd` to formulate scenarios |
+| BDD | formulation | Write `.feature` file |
+| BDD | automation | Implement step definitions |
+
+**If no active workflows | 如果沒有進行中的工作流程：**
+
+Proceed to show the standard phase overview below.
+
+### Step 2: Check for Active Specs | 檢查活躍規格
+
+```bash
+ls docs/specs/SPEC-*.md 2>/dev/null
+```
+
+If active specs exist, highlight them and suggest the appropriate workflow phase.
+
+---
+
 ## Usage | 用法
 
 ```bash
@@ -31,13 +79,13 @@ Map your current development phase to UDS commands. Get guidance on which tools
 
 | Phase | UDS Commands | 用途 |
 |-------|-------------|------|
-| **I. Planning** | `/brainstorm` `/requirement` `/sdd` `/reverse` | 需求、規格、逆向工程 |
-| **II. Testing** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` | 先寫測試再寫程式 |
-| **III. Implementation** | `/refactor` `/reverse` | 撰寫與改善程式碼 |
-| **IV. Quality** | `/checkin` `/review` | 提交前檢查與審查 |
-| **V. Release** | `/commit` `/changelog` `/release` | 版本、提交、發布 |
-| **VI. Docs** | `/docs` `/docgen` `/struct` | 文件與專案結構 |
-| **VII. Standards** | `/discover` `/guide` | 參考指南 |
+| **I. Planning** | `/brainstorm` `/requirement` `/sdd` `/reverse` `/api-design` `/database` | 需求、規格、API/DB 設計 |
+| **II. Testing** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` `/ac-coverage` | 先寫測試再寫程式 |
+| **III. Implementation** | `/refactor` `/reverse` `/migrate` `/durable` | 撰寫、改善與遷移程式碼 |
+| **IV. Quality** | `/checkin` `/review` `/security` `/scan` `/incident` | 品質、安全、事故回應 |
+| **V. Release** | `/commit` `/changelog` `/release` `/pr` `/ci-cd` | 版本、提交、PR、CI/CD |
+| **VI. Docs** | `/docs` `/docgen` | 文件與專案結構 |
+| **VII. Standards** | `/discover` `/guide` `/metrics` `/audit` | 參考指南、指標、審計 |
 | **VIII. Advanced** | `/methodology` | 跨方法論工作流程 |
 
 ## Common Scenarios | 常見場景
@@ -60,6 +108,55 @@ Map your current development phase to UDS commands. Get guidance on which tools
 /discover → /reverse → /coverage → /refactor → /checkin → /commit
 ```
 
+### Security Review | 安全審查
+
+```
+/scan → /security → /checkin → /commit
+```
+
+### API Design | API 設計
+
+```
+/brainstorm → /api-design → /sdd → /derive → /tdd → /pr
+```
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/dev-workflow` | 先檢查 `.workflow-state/`，有活躍工作流程則顯示狀態，否則展示全階段總覽 |
+| `/dev-workflow <phase>` | 展示指定階段的詳細指令和說明 |
+| `/dev-workflow <scenario>` | 展示指定場景的推薦工作流程（new-feature / bug-fix / refactoring） |
+
+### Interaction Script | 互動腳本
+
+1. 檢查 `.workflow-state/` 和 `docs/specs/` 的活躍狀態
+2. 依據結果決定展示內容
+
+**Decision: 活躍工作流程**
+- IF 有進行中的 workflow → 顯示狀態摘要，建議 resume 命令
+- IF 有活躍 spec → 提示 spec 進度，建議下一步
+- ELSE → 展示完整階段總覽或指定內容
+
+**Decision: 場景模式**
+- IF 指定場景（new-feature / bug-fix / refactoring） → 展示該場景的推薦命令序列
+- ELSE → 展示總覽表
+
+### Stop Points | 停止點
+
+此命令為純查詢/導引，無需停止點。
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 指定的 phase/scenario 不存在 | 列出可用的 phase 和 scenario |
+| `.workflow-state/` 目錄不存在 | 跳過活躍工作流程檢查，直接展示總覽 |
+
 ## References | 參考
 
 - [Development Workflow Skill](../dev-workflow-guide/SKILL.md)

package/bundled/skills/commands/discover.md

@@ -74,6 +74,45 @@ After discovery, the typical brownfield workflow is:
 3. `/sdd` - Write specification for new features
 4. `/tdd` or `/bdd` - Implement with test protection
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/discover` | 執行全專案健康評估（所有 5 個維度） |
+| `/discover <area>` | 聚焦評估指定功能區域的相關模組 |
+
+### Interaction Script | 互動腳本
+
+1. 掃描專案結構（package.json、目錄結構、配置檔）
+2. 逐維度分析（Architecture → Dependencies → Test Coverage → Security → Technical Debt）
+3. 計算各維度分數和整體分數
+4. 生成健康報告
+
+**Decision: 整體評估**
+- IF 有 Critical 級問題 → 判定 NO-GO，列出必須修復項目
+- IF 有 Warning 級問題 → 判定 CONDITIONAL，列出建議修復項目
+- IF 全部 Good → 判定 GO，建議進入下一步
+
+🛑 **STOP**: 報告展示後等待使用者決定（GO / NO-GO / CONDITIONAL）
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 健康報告展示後 | 使用者決定是否繼續開發 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 無 package.json 或專案配置 | 仍執行可用的維度分析，標記不可用的維度為 N/A |
+| 指定的功能區域不存在 | 列出可用的模組/目錄供選擇 |
+| npm audit 無法執行 | 跳過相依安全檢查，標記為 SKIP |
+
 ## References | 參考
 
 *   [Project Discovery Skill](../project-discovery/SKILL.md)

package/bundled/skills/commands/docgen.md

@@ -56,6 +56,41 @@ sources:
 language: [en, zh-TW]
 ```
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/docgen` | 尋找預設配置檔 `.usage-docs.yaml`，找到則使用，否則詢問 |
+| `/docgen <config>` | 使用指定配置檔 |
+| `/docgen --format <type>` | 僅生成指定格式（cheatsheet / reference / usage-guide） |
+
+### Interaction Script | 互動腳本
+
+1. 載入配置檔，解析來源和輸出設定
+2. 掃描來源檔案，擷取描述、選項、範例
+3. 依配置格式生成文件
+4. 展示生成的檔案清單和預覽
+
+🛑 **STOP**: 展示生成結果後等待使用者確認寫入
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 文件生成後 | 確認內容正確並寫入 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 配置檔不存在 | 建議建立 `.usage-docs.yaml`，提供模板 |
+| 來源目錄為空 | 告知無內容可擷取，列出已掃描的路徑 |
+| 輸出目錄不存在 | 自動建立目錄 |
+
 ## References | 參考
 
 *   [Docs Generator Skill](../docs-generator/SKILL.md)

package/bundled/skills/commands/docs.md

@@ -53,6 +53,46 @@ Used with `/docs generate`:
 /docs structure
 ```
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/docs` | 展示專案文件狀態總覽（哪些文件存在、是否過時） |
+| `/docs generate` | 生成文件工件（速查表、參考手冊） |
+| `/docs generate --lang <lang>` | 生成指定語言的文件 |
+| `/docs readme` | 審計並更新 README.md |
+| `/docs api` | 從程式碼生成 API 文件 |
+| `/docs structure` | 檢查文件目錄結構是否符合規範 |
+
+### Interaction Script | 互動腳本
+
+**Decision: 子命令分派**
+- IF `generate` → 執行 `/docgen` 的生成流程
+- IF `readme` → 分析 README 完整性，建議更新
+- IF `api` → 掃描程式碼，生成 API 文件
+- IF `structure` → 檢查目錄結構，報告缺失
+- IF 無子命令 → 展示文件狀態總覽
+
+🛑 **STOP**: 生成結果展示後等待使用者確認寫入（僅 generate / readme / api 子命令）
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 生成結果展示後 | 確認寫入（generate / readme / api） |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 子命令無效 | 列出可用子命令 |
+| 目標目錄不存在 | 自動建立或詢問使用者 |
+| 無程式碼可分析（api 子命令） | 告知並建議檢查路徑 |
+
 ## References | 參考
 
 *   [Documentation Guide Skill](../documentation-guide/SKILL.md)

package/bundled/skills/commands/durable.md

@@ -0,0 +1,79 @@
+---
+description: "[UDS] Guide workflow failure recovery with checkpoints, retries and rollback strategies"
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[workflow name or failure context | 工作流名稱或失敗情境]"
+---
+
+# Durable Execution Assistant | 持久執行助手
+
+Guide workflow failure recovery with checkpoints, retries and rollback strategies.
+
+引導工作流程故障恢復，包含檢查點、重試與回滾策略。
+
+## Workflow | 工作流程
+
+```
+DETECT ──► DIAGNOSE ──► RECOVER ──► VERIFY ──► CONTINUE
+```
+
+## Usage | 使用方式
+
+- `/durable` - Start interactive failure recovery
+- `/durable --checkpoint` - Design checkpoint strategy
+- `/durable --retry` - Design retry policy
+- `/durable --rollback` - Plan rollback strategy
+- `/durable <workflow>` - Analyze specific workflow
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/durable` | 詢問工作流程或失敗情境，進入 DETECT |
+| `/durable --checkpoint` | 直接進入檢查點策略設計 |
+| `/durable --retry` | 直接進入重試策略設計 |
+| `/durable --rollback` | 直接進入回滾策略規劃 |
+| `/durable <workflow>` | 分析指定工作流程 |
+
+### Interaction Script | 互動腳本
+
+#### DETECT / DIAGNOSE
+1. 分析工作流程結構和失敗點
+2. 識別需要持久化的狀態
+
+**Decision: 故障類型**
+- IF 暫時性故障（網路、超時） → 建議重試策略（exponential backoff）
+- IF 資料不一致 → 建議檢查點 + 補償交易
+- IF 不可逆失敗 → 建議回滾策略
+
+🛑 **STOP**: 診斷結果展示後等待使用者確認策略方向
+
+#### RECOVER
+1. 設計選定的恢復策略
+2. 展示策略細節和程式碼建議
+
+🛑 **STOP**: 策略設計後等待使用者確認
+
+#### VERIFY
+1. 建議驗證步驟確認恢復成功
+
+### Stop Points | 停止點
+
+| Phase | Stop Point | 等待內容 |
+|-------|-----------|---------|
+| DIAGNOSE | 診斷結果後 | 確認策略方向 |
+| RECOVER | 策略設計後 | 確認實施 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 無法識別工作流程模式 | 詢問使用者描述工作流程步驟 |
+| 多種故障類型並存 | 逐一分析，建議組合策略 |
+
+## Reference | 參考
+
+- Full standard: [durable-execution-assistant](../durable-execution-assistant/SKILL.md)

package/bundled/skills/commands/incident.md

@@ -0,0 +1,84 @@
+---
+description: "[UDS] Guide incident response, root cause analysis and post-mortem documentation"
+allowed-tools: Read, Write, Grep, Glob
+argument-hint: "[incident description or severity | 事故描述或嚴重程度]"
+---
+
+# Incident Response Assistant | 事故回應助手
+
+Guide incident response, root cause analysis and post-mortem documentation.
+
+引導事故回應、根因分析和事後檢討文件撰寫。
+
+## Workflow | 工作流程
+
+```
+DETECT ──► TRIAGE ──► MITIGATE ──► RESOLVE ──► POST-MORTEM
+```
+
+## Usage | 使用方式
+
+- `/incident` - Start interactive incident response
+- `/incident "API 500 errors"` - Respond to specific incident
+- `/incident --post-mortem` - Write post-mortem for resolved incident
+- `/incident --sev1` - Start SEV1 response protocol
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/incident` | 詢問事故描述和嚴重程度，進入 DETECT |
+| `/incident "description"` | 以描述為起點，進入 TRIAGE |
+| `/incident --post-mortem` | 直接進入 POST-MORTEM 階段 |
+| `/incident --sev1` | 啟動 SEV1 緊急回應協議 |
+
+### Interaction Script | 互動腳本
+
+#### DETECT / TRIAGE
+1. 收集事故症狀和影響範圍
+2. 評估嚴重程度（SEV1-4）
+
+**Decision: 嚴重程度**
+- IF SEV1/SEV2 → 立即列出緊急行動清單，建議通知相關人員
+- IF SEV3/SEV4 → 按標準流程排查
+
+🛑 **STOP**: 嚴重程度評估後等待使用者確認
+
+#### MITIGATE
+1. 建議即時緩解措施
+2. 追蹤緩解狀態
+
+#### RESOLVE
+1. 引導根因分析（5 Whys）
+2. 建議修復方案
+
+🛑 **STOP**: 修復方案確認後等待使用者確認實施
+
+#### POST-MORTEM
+1. 收集時間線、根因、影響
+2. 生成事後檢討文件
+
+🛑 **STOP**: 文件生成後等待使用者確認寫入
+
+### Stop Points | 停止點
+
+| Phase | Stop Point | 等待內容 |
+|-------|-----------|---------|
+| TRIAGE | 嚴重程度評估後 | 確認分級 |
+| RESOLVE | 修復方案提出後 | 確認實施 |
+| POST-MORTEM | 文件生成後 | 確認寫入 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 無法判斷嚴重程度 | 列出分級標準，請使用者選擇 |
+| 缺乏足夠症狀資訊 | 引導收集更多資訊（日誌、監控、錯誤訊息） |
+
+## Reference | 參考
+
+- Full standard: [incident-response-assistant](../incident-response-assistant/SKILL.md)

package/bundled/skills/commands/init.md

@@ -280,6 +280,61 @@ See `uds init --help` for all options.
 - Commands (for supported AI tools)
 - `manifest.json` for tracking installation
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action | AI 行為 |
+|-------|-----------|--------|
+| `/init` | 進入互動模式，逐步詢問 13 個配置問題 | Enter interactive mode, 13-step configuration |
+| `/init --yes` | 使用所有預設值直接執行 | Execute with all defaults |
+| `/init --level N` | 設定採用層級，其餘進入互動或搭配 `--yes` | Set level, rest interactive or defaults |
+| `/init --level N --yes` | 指定層級 + 所有預設值直接執行 | Specified level + all defaults |
+
+### Interaction Script | 互動腳本
+
+**Decision: 互動 vs 快速模式**
+- IF `--yes` 存在 → 使用預設值直接執行，跳過所有 AskUserQuestion
+- ELSE → 進入 13 步驟互動流程
+
+#### 互動流程（13 步驟）
+
+1. **偵測專案** — 自動偵測語言、框架、AI 工具
+2. **AI 工具選擇** — 多選，預選偵測到的工具
+3. **Skills 安裝** — Smart Grouping（1-2 工具合併 / 3+ 工具兩階段）
+4. **Commands 安裝** — Smart Grouping（同上策略）
+5. **標準範圍** — Lean（建議）或 Complete
+6. **採用層級** — Level 1/2/3
+7. **標準格式** — AI / Human / Both
+8. **標準選項** — Git Workflow、Merge Strategy、Commit Language、Test Levels
+9. **語言擴展** — 偵測到語言時詢問
+10. **框架擴展** — 偵測到框架時詢問
+11. **地區設定** — English / Traditional Chinese
+12. **內容模式** — Standard / Full Embed / Minimal
+13. **確認並執行** — 展示摘要，確認後一次執行所有安裝
+
+**IMPORTANT**: AskUserQuestion 最多 4 個選項。3+ 工具時必須使用 Smart Grouping 兩階段策略。
+
+🛑 **STOP**: Step 13 展示配置摘要後等待使用者確認再執行安裝
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 配置摘要展示後 | 確認安裝或修改配置 |
+| 偵測到已有 `.standards/` | 詢問是否覆寫或跳過 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 已有 `.standards/` 目錄 | 提示使用 `/update` 更新，或確認覆寫 |
+| 無法偵測專案語言 | 跳過語言擴展步驟，繼續流程 |
+| npm/npx 不可用 | 提示安裝 Node.js >= 18 |
+| AskUserQuestion 超過 4 選項 | 使用 Smart Grouping 拆分為多階段 |
+
 ## Reference | 參考
 
 - CLI documentation: `uds init --help`

package/bundled/skills/commands/methodology.md

@@ -268,6 +268,78 @@ You can also configure methodology settings using:
 
 ---
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action | AI 行為 |
+|-------|-----------|--------|
+| `/methodology` | 顯示當前方法論狀態和 checklist | Show current status |
+| `/methodology status` | 同上 | Same as above |
+| `/methodology switch <id>` | 檢查未提交變更 → 切換方法論 | Check uncommitted → switch |
+| `/methodology phase` | 顯示當前階段 | Show current phase |
+| `/methodology phase <name>` | 移動到指定階段 | Move to specified phase |
+| `/methodology checklist` | 顯示當前階段的 checklist | Show phase checklist |
+| `/methodology skip` | 跳過當前階段（含警告） | Skip phase with warning |
+| `/methodology list` | 列出所有可用方法論 | List available methodologies |
+| `/methodology create` | 啟動自訂方法論建立精靈 | Start creation wizard |
+
+### Interaction Script | 互動腳本
+
+#### Status / Checklist
+
+1. 讀取 `.standards/manifest.json` 中的 methodology 配置
+2. 顯示狀態面板（方法論、階段、checklist 進度）
+
+#### Switch
+
+1. 檢查是否有未提交變更（`git status`）
+
+**Decision: 未提交變更**
+- IF 有未提交變更 → 顯示警告，提供 4 選項：Commit first / Stash / Switch anyway / Cancel
+- IF 無變更 → 直接切換
+
+🛑 **STOP**: 有未提交變更時等待使用者選擇處理方式
+
+2. 更新 manifest 中的 active methodology
+3. 顯示切換結果和新方法論的第一個階段
+
+#### Skip
+
+1. 檢查當前 checklist 未完成項目
+2. 顯示警告（含已跳過次數）
+
+🛑 **STOP**: 顯示跳過警告後等待使用者確認
+
+**Decision: 跳過限制**
+- IF 已達跳過上限（skipLimit） → 強制顯示嚴重警告
+- ELSE → 記錄跳過，進入下一階段
+
+#### Create
+
+1. 啟動互動式精靈，引導使用者定義自訂方法論
+
+🛑 **STOP**: 定義完成後展示方法論結構，等待確認寫入
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| Switch 有未提交變更 | 使用者選擇處理方式 |
+| Skip 確認 | 使用者確認跳過 |
+| Create 完成 | 使用者確認寫入自訂方法論 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 方法論未啟用 | 提示執行 `/methodology switch <id>` |
+| 指定的方法論不存在 | 列出可用方法論（`/methodology list`） |
+| 指定的階段在當前方法論中不存在 | 列出可用階段 |
+| manifest 無 methodology 配置 | 提示透過 `/config methodology` 啟用 |
+
 ## Reference | 參考
 
 - [Methodology System Skill](../methodology-system/SKILL.md) - Full skill documentation

package/bundled/skills/commands/metrics.md

@@ -0,0 +1,65 @@
+---
+description: "[UDS] Track development metrics, code quality indicators and project health"
+allowed-tools: Read, Grep, Glob, Bash(npm:*, git log:*)
+argument-hint: "[metric type or module | 指標類型或模組]"
+---
+
+# Metrics Dashboard Assistant | 指標儀表板助手
+
+Track development metrics, code quality indicators and project health.
+
+追蹤開發指標、程式碼品質指示器與專案健康狀態。
+
+## Workflow | 工作流程
+
+```
+COLLECT ──► ANALYZE ──► REPORT ──► TREND
+```
+
+## Usage | 使用方式
+
+- `/metrics` - Run full metrics analysis
+- `/metrics --quality` - Code quality metrics only
+- `/metrics --debt` - Technical debt analysis
+- `/metrics --test` - Test metrics only
+- `/metrics src/` - Analyze specific module
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/metrics` | 執行全面指標分析 |
+| `/metrics --quality` | 僅分析程式碼品質指標 |
+| `/metrics --debt` | 僅分析技術債 |
+| `/metrics --test` | 僅分析測試指標 |
+| `/metrics <path>` | 分析指定模組 |
+
+### Interaction Script | 互動腳本
+
+1. 偵測專案結構和可用工具
+2. 收集指標資料（git log、測試覆蓋率、程式碼複雜度）
+3. 分析趨勢和異常
+4. 生成報告
+
+🛑 **STOP**: 報告展示後等待使用者決定是否採取行動
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 報告展示後 | 使用者決定後續行動 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 無法執行覆蓋率工具 | 跳過該指標，報告可用的其他指標 |
+| git 歷史不足以分析趨勢 | 僅報告當前快照，標記趨勢為 N/A |
+
+## Reference | 參考
+
+- Full standard: [metrics-dashboard-assistant](../metrics-dashboard-assistant/SKILL.md)