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

package/bundled/skills/commands/ac-coverage.md

@@ -0,0 +1,135 @@
+---
+description: "[UDS] Generate AC-to-test traceability matrix and coverage report"
+allowed-tools: Read, Grep, Glob
+argument-hint: "[spec file path | 規格檔案路徑]"
+---
+
+# AC Coverage | AC 覆蓋率
+
+Generate an Acceptance Criteria (AC) to test traceability matrix and coverage report from a specification file.
+
+從規格檔案產生驗收條件（AC）與測試的追蹤矩陣及覆蓋率報告。
+
+## Usage | 用法
+
+```bash
+/ac-coverage specs/SPEC-001.md            # Analyze specific SPEC
+/ac-coverage specs/SPEC-001.md --threshold 90   # Custom threshold
+/ac-coverage specs/SPEC-001.md --test-dir tests/ # Specify test directory
+```
+
+## Workflow | 工作流程
+
+1. **Parse SPEC** — Read the specification file and extract all AC definitions (AC-1, AC-2, ...)
+2. **Scan tests** — Search test files for `@AC` and `@SPEC` annotations
+3. **Build matrix** — Map each AC to its corresponding test references
+4. **Classify status** — ✅ covered | ⚠️ partial | ❌ uncovered
+5. **Calculate coverage** — `Coverage % = (covered + partial × 0.5) / total × 100`
+6. **Generate report** — Output standardized Markdown report
+
+## How This Differs from `/coverage` | 與 `/coverage` 的區別
+
+| | `/coverage` | `/ac-coverage` |
+|-|-------------|----------------|
+| **Level** | Code (line/branch/function) | Requirements (AC-to-test) |
+| **Question** | "How much code is tested?" | "Which AC have tests?" |
+| **Input** | Source code + test runner | SPEC file + test annotations |
+
+Both are complementary — use `/coverage` for code quality, `/ac-coverage` for requirement verification.
+
+兩者互補 — 使用 `/coverage` 確保程式碼品質，使用 `/ac-coverage` 確保需求驗證。
+
+## Quality Thresholds | 品質門檻
+
+| Context | Default Threshold | Configurable |
+|---------|-------------------|--------------|
+| **Check-in** | 80% | `--threshold N` |
+| **Release** | 100% | `--threshold N` |
+| **Warning** | 60% | `--threshold N` |
+
+## Output Format | 輸出格式
+
+```markdown
+# AC Coverage Report
+
+**Specification**: SPEC-001 — Feature Name
+**Generated**: 2026-03-18
+**Coverage**: 75% (6/8 AC)
+
+## Summary
+
+| Status | Count | Percentage |
+|--------|-------|------------|
+| ✅ Covered | 5 | 62.5% |
+| ⚠️ Partial | 2 | 25.0% |
+| ❌ Uncovered | 1 | 12.5% |
+
+## Traceability Matrix
+
+| AC-ID | Description | Status | Test Reference |
+|-------|-------------|--------|----------------|
+| AC-1 | ... | ✅ | test-file.ts:15 |
+
+## Gaps
+- **AC-8**: Blocked by external dependency
+
+## Action Items
+1. [ ] AC-8: Resolve blocker
+```
+
+## Next Steps Guidance | 下一步引導
+
+After `/ac-coverage` completes, the AI assistant should suggest:
+
+> **AC 覆蓋率分析完成。建議下一步 / AC coverage analysis complete. Suggested next steps:**
+> - 覆蓋率達標 → 執行 `/checkin` 品質關卡 — Coverage meets threshold → Run `/checkin` quality gates
+> - 有未覆蓋 AC → 執行 `/derive-tdd` 補齊測試 — Uncovered AC found → Run `/derive-tdd` to add tests
+> - 有部分覆蓋 AC → 檢查缺少的邊界情況 — Partial AC → Review missing edge cases
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/ac-coverage` | 列出可用的 spec 檔案供選擇 |
+| `/ac-coverage <spec-file>` | 直接分析指定 spec 的 AC 覆蓋率 |
+| `/ac-coverage <spec-file> --threshold N` | 使用自訂門檻 |
+
+### Interaction Script | 互動腳本
+
+1. 讀取 spec 檔案，擷取所有 AC
+2. 掃描測試檔案中的 `@AC` 和 `@SPEC` 註解
+3. 建立 AC → Test 追蹤矩陣
+4. 計算覆蓋率
+5. 生成報告
+
+**Decision: 覆蓋率結果**
+- IF 覆蓋率 ≥ 門檻 → 標記 ✅，建議 `/checkin`
+- IF 有未覆蓋 AC → 列出並建議 `/derive-tdd` 補測試
+- IF 有部分覆蓋 AC → 建議檢查缺少的邊界情況
+
+🛑 **STOP**: 報告展示後等待使用者決定下一步
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 報告展示後 | 使用者決定補測試或繼續 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| Spec 檔案不存在 | 列出可用的 spec 檔案 |
+| Spec 無 AC 定義 | 告知並引導修改 spec |
+| 測試檔案無 `@AC` 註解 | 嘗試以命名慣例匹配，標記 `[Inferred]` |
+
+## References | 參考
+
+- [AC Coverage Assistant Skill](../ac-coverage-assistant/SKILL.md)
+- [Core Standard: Acceptance Criteria Traceability](../../core/acceptance-criteria-traceability.md)
+- Related: [/coverage](./coverage.md) (code-level coverage)
+- Related: [/checkin](./checkin.md) (quality gates)

package/bundled/skills/commands/api-design.md

@@ -0,0 +1,86 @@
+---
+description: "[UDS] Guide API design following REST, GraphQL and gRPC best practices"
+allowed-tools: Read, Grep, Glob
+argument-hint: "[API endpoint or module | API 端點或模組]"
+---
+
+# API Design Assistant | API 設計助手
+
+Guide API design following REST, GraphQL and gRPC best practices.
+
+引導 API 設計，遵循 REST、GraphQL 和 gRPC 最佳實踐。
+
+## Workflow | 工作流程
+
+```
+DEFINE ──► DESIGN ──► VALIDATE ──► DOCUMENT
+```
+
+1. **Define** — Gather requirements, identify resources and operations
+2. **Design** — Design endpoints, request/response schemas, error codes
+3. **Validate** — Check consistency, naming conventions, versioning
+4. **Document** — Generate API documentation
+
+## Usage | 使用方式
+
+- `/api-design` - Start interactive API design session
+- `/api-design /users` - Design API for specific resource
+- `/api-design --graphql` - Design using GraphQL approach
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/api-design` | 詢問 API 需求和目標資源，進入 DEFINE 階段 |
+| `/api-design <resource>` | 以指定資源為目標，進入 DEFINE |
+| `/api-design --graphql` | 使用 GraphQL 方法設計 |
+
+### Interaction Script | 互動腳本
+
+#### DEFINE Phase
+1. 收集 API 需求（目標使用者、資源、操作）
+2. 確認 API 風格（REST / GraphQL / gRPC）
+
+🛑 **STOP**: 需求確認後等待使用者確認進入 DESIGN
+
+#### DESIGN Phase
+1. 設計端點/schema
+2. 定義 request/response 格式
+3. 設計錯誤碼和狀態碼
+4. 展示設計結果
+
+🛑 **STOP**: 設計展示後等待使用者確認
+
+#### VALIDATE Phase
+1. 檢查命名一致性、RESTful 慣例
+2. 驗證版本策略
+3. 展示驗證報告
+
+#### DOCUMENT Phase
+1. 生成 API 文件（OpenAPI / GraphQL Schema）
+
+🛑 **STOP**: 文件生成後等待使用者確認寫入
+
+### Stop Points | 停止點
+
+| Phase | Stop Point | 等待內容 |
+|-------|-----------|---------|
+| DEFINE | 需求確認後 | 確認進入 DESIGN |
+| DESIGN | 設計展示後 | 確認設計方案 |
+| DOCUMENT | 文件生成後 | 確認寫入 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 無法判斷 API 風格 | 列出選項（REST/GraphQL/gRPC），請使用者選擇 |
+| 資源命名不符慣例 | 建議修正，展示命名規則 |
+
+## Reference | 參考
+
+- Full standard: [api-design-assistant](../api-design-assistant/SKILL.md)
+- Core guide: [api-design-standards](../../core/api-design-standards.md)

package/bundled/skills/commands/atdd.md

@@ -155,6 +155,75 @@ ATDD Level (Business Acceptance)
 - [ ] Tests shown passing
 - [ ] PO formally accepts
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/atdd` | 詢問使用者故事，進入 🤝 WORKSHOP |
+| `/atdd "user story"` | 以指定故事為目標，進入 🤝 WORKSHOP |
+| `/atdd <story-id>` | 載入現有故事，判斷進入哪個階段 |
+
+### Interaction Script | 互動腳本
+
+#### 🤝 WORKSHOP Phase
+
+1. 請使用者描述使用者故事（As a / I want / So that）
+2. 引導定義驗收條件（Given-When-Then）
+3. 記錄 Out of Scope 項目
+
+**Decision: PO 角色**
+- IF 使用者是 PO → 直接收集 AC
+- IF 使用者是開發者 → AI 模擬 PO 視角提出質疑和補充
+- ELSE → 建議邀請 PO 參與，或由 AI 輔助
+
+🛑 **STOP**: AC 定義完成後展示使用者故事文件，等待確認
+
+#### 🧪 DISTILLATION Phase
+
+1. 將 AC 轉換為可執行的測試格式
+2. 消除歧義
+3. 展示可執行測試
+
+🛑 **STOP**: 展示測試後等待使用者（或 PO）簽核
+
+#### 💻 DEVELOPMENT Phase
+
+1. 執行驗收測試（預期失敗）
+2. 使用 BDD/TDD 實作功能
+3. 迭代直到所有測試通過
+
+🛑 **STOP**: 所有測試通過後等待使用者確認進入 DEMO
+
+#### 🎬 DEMO Phase
+
+1. 展示通過的測試結果
+2. 展示可運作的功能
+3. 等待 PO 正式驗收
+
+🛑 **STOP**: 等待使用者確認 PO 已驗收
+
+### Stop Points | 停止點
+
+| Phase | Stop Point | 等待內容 |
+|-------|-----------|---------|
+| WORKSHOP | AC 定義後 | 確認使用者故事 |
+| DISTILLATION | 測試轉換後 | PO 簽核 |
+| DEVELOPMENT | 所有測試通過後 | 確認進入 DEMO |
+| DEMO | 功能展示後 | PO 正式驗收 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 使用者故事不符合 INVEST 準則 | 指出哪些準則未滿足，建議修改 |
+| PO 不在場 | AI 模擬 PO 視角提問，標記 `[Needs PO Confirmation]` |
+| 驗收測試無法自動化 | 建議手動測試替代方案，產出測試檢查清單 |
+| DEVELOPMENT 階段反覆失敗 | 回到 WORKSHOP 重新審視 AC 是否合理 |
+
 ## Reference | 參考
 
 - Core Standard: [acceptance-test-driven-development.md](../../core/acceptance-test-driven-development.md)

package/bundled/skills/commands/audit.md

@@ -0,0 +1,69 @@
+---
+description: "[UDS] UDS health check and feedback system, diagnose installation integrity and detect development patterns"
+allowed-tools: Read, Grep, Glob, Bash(git log:*, uds audit:*)
+argument-hint: "[--health | --patterns | --friction | --report]"
+---
+
+# Audit Assistant | 審計助手
+
+UDS health check and feedback system — diagnose installation integrity and detect development patterns.
+
+UDS 健康檢查與回饋系統——診斷安裝完整性與偵測開發模式。
+
+## Workflow | 工作流程
+
+```
+DIAGNOSE ──► ANALYZE ──► REPORT
+```
+
+## Usage | 使用方式
+
+- `/audit` - Run full audit
+- `/audit --health` - Installation health check
+- `/audit --patterns` - Detect development patterns
+- `/audit --friction` - Identify friction points
+- `/audit --report` - Generate comprehensive report
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/audit` | 執行完整審計（health + patterns + friction） |
+| `/audit --health` | 僅檢查 UDS 安裝完整性 |
+| `/audit --patterns` | 僅偵測開發模式 |
+| `/audit --friction` | 僅識別摩擦點 |
+| `/audit --report` | 生成完整報告（含建議） |
+
+### Interaction Script | 互動腳本
+
+1. 依模式執行對應的診斷
+2. 收集分析結果
+3. 生成報告
+
+**Decision: 健康狀態**
+- IF ERROR 級問題 → 建議執行 `uds init` 或 `uds check --restore`
+- IF WARNING 級問題 → 列出建議，使用者自行決定
+- IF 全部 OK → 展示健康摘要
+
+🛑 **STOP**: 報告展示後等待使用者決定
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 報告展示後 | 使用者決定採取行動 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| UDS 未安裝 | 建議執行 `uds init` |
+| `.standards/` 目錄不存在 | 告知 UDS 標準未安裝 |
+
+## Reference | 參考
+
+- Full standard: [audit-assistant](../audit-assistant/SKILL.md)

package/bundled/skills/commands/bdd.md

@@ -17,6 +17,43 @@ Guide through the Behavior-Driven Development (BDD) workflow using Given-When-Th
 
 引導行為驅動開發（BDD）流程，使用 Given-When-Then 格式。
 
+## Pre-Flight Checks | 前置檢查
+
+Before executing BDD phases, the AI assistant MUST verify prerequisites. If a check fails, STOP and guide the user.
+
+在執行 BDD 階段前，AI 助手必須驗證前置條件。如果檢查失敗，停止並引導使用者。
+
+### Phase Gate Matrix | 階段閘門矩陣
+
+| Target Phase | Pre-Flight Check | On Failure |
+|-------------|-----------------|------------|
+| `DISCOVERY` | 1. Feature/behavior clearly identified | → Ask user to describe the desired behavior |
+| | 2. If SDD project: spec exists | → Guide to `/sdd` |
+| `FORMULATION` | 1. Discovery output exists (examples, edge cases) | → Guide back to DISCOVERY |
+| | 2. At least one concrete example collected | → Collect examples first |
+| `AUTOMATION` | 1. `.feature` file exists with scenarios | → Guide to FORMULATION |
+| | 2. Scenarios follow Given-When-Then format | → Fix scenario format |
+| `LIVING DOCS` | 1. Step definitions implemented | → Guide to AUTOMATION |
+| | 2. All scenarios passing | → Fix failing scenarios first |
+
+### Feature-Before-Step Enforcement | 功能檔優先強制
+
+```
+🔍 DISCOVERY: Collect examples → identify edge cases
+   ↓ (only proceed with concrete examples)
+📝 FORMULATION: Write .feature file → Given/When/Then
+   ↓ (only proceed with valid Gherkin scenarios)
+🤖 AUTOMATION: Implement step definitions → run
+   ↓ (only proceed when all scenarios pass)
+📚 LIVING DOCS: Maintain and share
+```
+
+**Critical Rule**: The AI MUST NOT write step definitions before `.feature` files with Gherkin scenarios exist. Discovery must produce concrete examples before formulation begins.
+
+**關鍵規則**：AI 不得在 `.feature` 檔案存在前撰寫步驟定義。探索階段必須產出具體範例才能進入制定階段。
+
+---
+
 ## Methodology Integration | 方法論整合
 
 When `/bdd` is invoked:
@@ -136,6 +173,70 @@ BDD works best with collaboration:
 - [ ] Documentation is accessible
 - [ ] Stakeholders can read and understand
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/bdd` | 詢問要探索的行為，進入 🔍 DISCOVERY |
+| `/bdd "feature description"` | 以指定功能為目標，進入 🔍 DISCOVERY |
+| `/bdd <feature-file>` | 載入現有 `.feature` 檔案，判斷進入哪個階段 |
+
+### Interaction Script | 互動腳本
+
+#### 🔍 DISCOVERY Phase
+
+1. 與使用者討論功能行為
+2. 收集具體範例和邊界案例
+3. 以 Three Amigos 視角提問（Business / Dev / Testing）
+
+🛑 **STOP**: 收集足夠範例後展示摘要，等待確認進入 FORMULATION
+
+#### 📝 FORMULATION Phase
+
+1. 將範例轉為 Gherkin 場景（Given-When-Then）
+2. 使用領域語言（ubiquitous language）
+3. 展示生成的 `.feature` 內容
+
+**Decision: 場景品質**
+- IF 場景包含實作細節 → 自動抽離，改用業務語言
+- IF 場景過於模糊 → 要求更具體的範例
+
+🛑 **STOP**: 展示 `.feature` 後等待使用者確認寫入
+
+#### 🤖 AUTOMATION Phase
+
+1. 為每個場景實作 step definitions
+2. 執行場景，確認結果
+3. 場景內部使用 TDD 循環實作
+
+🛑 **STOP**: 所有場景通過後等待使用者確認
+
+#### 📚 LIVING DOCS Phase
+
+1. 確認所有場景是最新狀態
+2. 建議文件可分享給利害關係人
+
+### Stop Points | 停止點
+
+| Phase | Stop Point | 等待內容 |
+|-------|-----------|---------|
+| DISCOVERY | 範例收集完成後 | 確認進入 FORMULATION |
+| FORMULATION | `.feature` 生成後 | 確認寫入 |
+| AUTOMATION | 所有場景通過後 | 確認進入 LIVING DOCS |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 使用者要求跳過 DISCOVERY 直接寫場景 | 提醒需要具體範例，但允許 override |
+| `.feature` 語法無效 | 自動修正 Gherkin 語法 |
+| Step definition 實作失敗 | 報告哪個 step 失敗，嘗試修復，3 次後 STOP |
+| 無 BDD 測試框架（Cucumber 等） | 建議安裝，或改用 TDD 方式實作場景邏輯 |
+
 ## Reference | 參考
 
 - Methodology: [bdd.methodology.yaml](../../methodologies/bdd.methodology.yaml)

package/bundled/skills/commands/brainstorm.md

@@ -75,6 +75,51 @@ After brainstorming, the typical workflow is:
 3. `/sdd` - Create specification documents
 4. `/derive-all` or `/tdd` - Implement with test protection
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/brainstorm` | 詢問要探討的主題或問題，進入 FRAME 階段 |
+| `/brainstorm "topic"` | 以指定主題開始，進入 FRAME 階段 |
+| `/brainstorm --technique <name>` | 使用指定技法開始 DIVERGE 階段 |
+
+### Interaction Script | 互動腳本
+
+#### FRAME Phase
+1. 釐清問題陳述（使用 5 Whys 或 HMW）
+2. 確認問題定義
+
+🛑 **STOP**: 問題定義後等待使用者確認
+
+#### DIVERGE Phase
+1. 使用選定技法生成想法
+2. 鼓勵數量優先於品質
+3. 列出所有想法
+
+#### CONVERGE Phase
+1. 以評估矩陣（可行性、影響力、成本）評分
+2. 排序前 3 名
+
+🛑 **STOP**: 展示 Brainstorm Report 後等待使用者決定下一步
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 問題定義後 | 確認問題正確 |
+| 報告展示後 | 決定進入 `/requirement` 或 `/sdd` |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 主題太廣泛 | 引導縮小範圍 |
+| 指定的技法不存在 | 列出可用技法供選擇 |
+
 ## References | 參考
 
 * [Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md)

package/bundled/skills/commands/changelog.md

@@ -52,6 +52,40 @@ Generate and maintain CHANGELOG.md entries following the Keep a Changelog format
 - Include issue/PR references | 附上 issue/PR 編號
 - Mark breaking changes with **BREAKING** prefix | 用 **BREAKING** 標記破壞性變更
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/changelog` | 分析 git log 自上次 release 以來的 commits，生成 changelog 條目 |
+
+### Interaction Script | 互動腳本
+
+1. 找到最近的 git tag（上次 release）
+2. 讀取從上次 tag 至今的所有 commits
+3. 依類型分類（Added / Changed / Fixed / Security 等）
+4. 轉寫為使用者導向的描述（非開發者語言）
+5. 展示生成的 changelog 條目
+
+🛑 **STOP**: 展示條目後等待使用者確認更新 CHANGELOG.md
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| Changelog 條目展示後 | 確認內容正確並寫入 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 無 git tag（首次 release） | 分析所有 commits |
+| CHANGELOG.md 不存在 | 建立新檔案 |
+| Commit message 格式不規範 | 盡力分類，標記 `[Manual Review]` |
+
 ## References | 參考
 
 *   [Changelog Guide Skill](../changelog-guide/SKILL.md)

package/bundled/skills/commands/check.md

@@ -65,7 +65,7 @@ When issues are detected (modified/missing files), CLI automatically enters inte
 
 ```
 ──────────────────────────────────────────────────
-⚠ Modified: .standards/commit-message-guide.md
+⚠ Modified: .standards/commit-message.ai.yaml
 
 ? What would you like to do?
 ❯ View diff
@@ -210,6 +210,57 @@ Shows standards coverage:
 /check --migrate        # Upgrade manifest format
 ```
 
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action | AI 行為 |
+|-------|-----------|--------|
+| `/check` | 執行 `uds check`，偵測問題時進入互動修復模式 | Run full check, enter interactive mode on issues |
+| `/check --summary` | 執行 `uds check --summary`，顯示精簡狀態 | Show compact status |
+| `/check --restore` | 執行 `uds check --restore`，還原所有修改/遺失檔案 | Restore all files |
+| `/check --offline` | 執行 `uds check --offline`，跳過 npm registry 檢查 | Skip network check |
+| `/check --migrate` | 執行 `uds check --migrate`，升級 manifest 格式 | Migrate legacy manifest |
+
+### Interaction Script | 互動腳本
+
+1. 執行 `uds check` 並解析輸出
+2. 展示狀態摘要（版本、層級、檔案、Skills、Commands）
+
+**Decision: 檢查結果**
+- IF 全部正常 → 顯示綠色摘要，結束
+- IF 有修改/遺失檔案 → 進入互動修復迴圈
+
+3. 互動修復迴圈（每個問題檔案）：
+
+**Decision: 檔案已修改**
+- 使用者可選：View diff → Restore original → Keep current → Skip
+
+**Decision: 檔案遺失**
+- 使用者可選：Restore → Remove from tracking → Skip
+
+🛑 **STOP**: 每個問題檔案逐一詢問使用者處理方式
+
+4. 所有檔案處理完畢，顯示最終狀態
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 每個問題檔案 | 使用者選擇處理方式 |
+| restore 操作前 | 確認還原（批次模式除外） |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 標準未初始化 | 提示執行 `/init` |
+| npm registry 無法連線 | 建議加 `--offline` 重試 |
+| manifest 格式過舊 | 建議執行 `--migrate` |
+| Skills 未安裝 | 建議執行 `/update` 或 `/config skills` |
+
 ## Reference | 參考
 
 - CLI documentation: `uds check --help`