universal-dev-standards 5.17.0 → 6.0.0

package/bundled/locales/zh-TW/skills/README.md

@@ -1,187 +1,150 @@
 ---
 source: ../../../skills/README.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-01-07
+translation_version: 1.2.0
+last_synced: 2026-06-20
 status: current
 ---
 
-# Claude Code Skills
+# 通用開發 Skills
 
 > **語言**: [English](../../../skills/README.md) | 繁體中文
 
-軟體開發標準的 Claude Code Skills。
+本目錄收錄通用開發標準（UDS）skill 的參考實作。這些 skill 盡可能設計為與工具無關，作為 AI 程式設計助理的「真實來源（Source of Truth）」。
 
 > 衍生自 [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards) 核心標準。
 
-## 概述
+> **完整的索引式 skill 清單**（依 Tier、分類與使用情境）請見 **[docs/user/SKILLS-INDEX.md](../../../docs/user/SKILLS-INDEX.md)**（自動產生）。
+> 斜線命令參考請見 **[docs/user/COMMANDS-INDEX.md](../../../docs/user/COMMANDS-INDEX.md)**。
 
-這些技能會根據上下文在使用 Claude Code 時自動觸發，協助您：
+## 目錄結構
 
-- 透過基於證據的回應防止 AI 幻覺
-- 撰寫一致且格式良好的提交訊息
-- 進行全面的程式碼審查
-- 遵循測試最佳實踐
-- 使用語意化版本管理發布
+```
+skills/
+├── commands/          # 通用斜線命令定義（.md）
+├── agents/            # 通用 Agent 定義（.md）
+├── workflows/         # 通用 Workflow 定義（.yaml）
+├── tools/             # 工具專屬的 adapter 與設定
+│   ├── cline/         # Cline (.clinerules)
+│   ├── cursor/        # Cursor (.cursorrules)
+│   ├── windsurf/      # Windsurf (.windsurfrules)
+│   └── copilot/       # GitHub Copilot (instructions.md)
+├── _shared/           # 共用範本與工具
+└── [skill-name]/      # 個別 skill 定義（例如 git-workflow-guide/）
+```
+
+## 通用 Skills 與命令
 
-## 可用的 Skills
+這些 skill 提供標準指引與工作流程。在支援的工具中（如 Claude Code、OpenCode）可透過斜線命令存取，也可手動引用。
 
-| Skill（資料夾） | 指令 | 描述 |
+| Skill（資料夾） | 命令 | 描述 |
 |----------------|---------|-------------|
 | `guide` | `/guide` | [UDS] 存取所有標準指南 |
-| `checkin-assistant` | `/checkin` | [UDS] 提交前品質閘道 |
+| `checkin-assistant` | `/checkin` | [UDS] 提交前品質閘門 |
 | `commit-standards` | `/commit` | [UDS] Conventional Commits 格式 |
-| `code-review-assistant` | `/review` | [UDS] 系統化程式碼審查 |
+| `code-review-assistant` | `/code-review` | [UDS] 系統化程式碼審查 |
 | `tdd-assistant` | `/tdd` | [UDS] 測試驅動開發 |
 | `bdd-assistant` | `/bdd` | [UDS] 行為驅動開發 |
 | `atdd-assistant` | `/atdd` | [UDS] 驗收測試驅動開發 |
-| `e2e-assistant` | `/e2e` | [UDS] 從 BDD 場景生成 E2E 測試骨架 |
-| `release-standards` | `/release` | [UDS] 發布與變更日誌管理 |
+| `e2e-assistant` | `/e2e` | [UDS] 從 BDD 場景產生 E2E 測試骨架 |
+| `journey-test-assistant` | `/journey-test` | [UDS] 連貫使用者旅程測試計畫（TESTPLAN）＋ E2E 骨架產生 |
+| `release-standards` | `/release` | [UDS] 發行與 Changelog 管理 |
 | `documentation-guide` | `/docs` | [UDS] 文件管理 |
 | `requirement-assistant` | `/requirement` | [UDS] 需求撰寫 |
 | `reverse-engineer` | `/reverse` | [UDS] 逆向工程程式碼 |
-| `forward-derivation` | `/derive` | [UDS] 從規格衍生產出物 |
+| `spec-derivation` | `/derive` | [UDS] 從 spec 推導 BDD/TDD/ATDD 產物 |
 | `spec-driven-dev` | `/sdd` | [UDS] 規格驅動開發 |
 | `test-coverage-assistant` | `/coverage` | [UDS] 測試覆蓋率分析 |
-| `methodology-system` | `/methodology` | [UDS] 開發方法論 |
+| `dev-methodology` | `/methodology` | [UDS] 開發方法論 |
 | `refactoring-assistant` | `/refactor` | [UDS] 重構指引 |
 | `project-discovery` | `/discover` | [UDS] 評估專案健康度與風險 |
-| `brainstorm-assistant` | `/brainstorm` | [UDS] 結構化 AI 輔助構想 |
-| `changelog-guide` | `/changelog` | [UDS] 生成變更日誌條目 |
+| `brainstorm-assistant` | `/brainstorm` | [UDS] 結構化 AI 輔助發想 |
+| `changelog-guide` | `/changelog` | [UDS] 產生 changelog 條目 |
 | `dev-workflow-guide` | `/dev-workflow` | [UDS] 將開發階段對應到 UDS 命令 |
-| `docs-generator` | `/docgen` | [UDS] 生成使用文件 |
-
-## 靜態與動態規範
-
-規範依據應用時機分為兩類：
-
-Standards are classified into two types based on when they should be applied:
-
-### 靜態規範（專案檔案）
-
-這些規範應該**隨時生效**，建議放在專案的 `CLAUDE.md` 或 `.cursorrules` 中：
-
-These standards should **always be active**. Add them to your project's `CLAUDE.md` or `.cursorrules`:
+| `docs-generator` | `/docgen` | [UDS] 產生使用文件 |
+| `security-assistant` | `/security` | [UDS] 安全審查與漏洞評估 |
+| `security-scan-assistant` | `/scan` | [UDS] 自動化安全掃描與相依稽核 |
+| `api-design-assistant` | `/api-design` | [UDS] API 設計（REST、GraphQL、gRPC）|
+| `database-assistant` | `/database` | [UDS] 資料庫設計、遷移、查詢最佳化 |
+| `ci-cd-assistant` | `/ci-cd` | [UDS] CI/CD 管線設計與最佳化 |
+| `incident-response-assistant` | `/incident` | [UDS] 事故回應與事後檢討 |
+| `pr-automation-assistant` | `/pr` | [UDS] Pull request 建立與審查自動化 |
+| `metrics-dashboard-assistant` | `/metrics` | [UDS] 開發指標與專案健康度 |
+| `durable-execution-assistant` | `/durable` | [UDS] 工作流程故障復原與回滾 |
+| `migration-assistant` | `/migrate` | [UDS] 程式碼遷移與框架升級 |
+| `audit-assistant` | `/audit` | [UDS] 標準合規稽核 |
+| `observability-assistant` | `/observability` | [UDS] 可觀測性設定、指標、告警 🆕 |
+| `slo-assistant` | `/slo` | [UDS] SLI 選擇、SLO 設定、Error Budget 🆕 |
+| `runbook-assistant` | `/runbook` | [UDS] Runbook 建立、演練、覆蓋率 🆕 |
+| `skill-builder` | `/skill-builder` | [UDS] 識別重複流程並以正確的開發深度建立 Skill |
+
+> **注意**：參考型指南（如 Git Workflow、Logging、Error Codes）請使用 `/guide` 命令。
+
+## Skill Tier（列出預算最佳化）
+
+> 背景：Claude Code 透過 `skillListingBudgetFraction` 保留一小部分 context（預設 1%）用於列出 skill。當有 40+ 個 UDS skill 加上採用者安裝的 plugin 時，描述可能被截斷。UDS 將 skill 組織為三個 tier，讓採用者可選擇性抑制較少用的描述，同時保持 skill 仍可透過 `/<name>` 呼叫。
+>
+> 決策與取捨見 [DEC-061](https://github.com/AsiaOstrich/dev-platform/blob/main/cross-project/decisions/DEC-061-uds-skill-listing-budget.md)。參考設定位於 [`examples/skill-overrides-recommended.json`](../../../examples/skill-overrides-recommended.json)。詳細調整：[`docs/skill-budget-tuning.md`](../../../docs/skill-budget-tuning.md)。
 
-| Standard | 核心規則 | Key Rules |
-|----------|---------|-----------|
-| [anti-hallucination](../../../core/anti-hallucination.md) | 確定性標籤、建議原則 | Certainty labels, suggestion principles |
-| [checkin-standards](../../../core/checkin-standards.md) | 編譯通過、測試通過、覆蓋率達標 | Build passes, tests pass, coverage met |
-| [project-structure](../../../core/project-structure.md) | 目錄結構規範 | Directory structure conventions |
+### Tier 1 — Core（每日使用）
+**列出預設**：`"on"`（顯示完整描述）。永遠可自動探索。
 
-> 📄 參見 [CLAUDE.md.template](../../../templates/CLAUDE.md.template) 取得可直接使用的範本。
->
-> 📄 See [CLAUDE.md.template](../../../templates/CLAUDE.md.template) for a ready-to-use template.
+`commit-standards`、`push`、`git-workflow-guide`、`tdd-assistant`、`bdd-assistant`、`testing-guide`、`code-review-assistant`、`refactoring-assistant`、`requirement-assistant`、`spec-driven-dev`、`adr-assistant`、`dev-workflow-guide`、`checkin-assistant`
 
-### 動態規範（Skills）
+### Tier 2 — Advanced（每週使用）
+**列出預設**：`"on"`（顯示完整描述）。
 
-這些規範由**關鍵字觸發**，按需載入。安裝為 Skills 使用：
+`atdd-assistant`、`e2e-assistant`、`journey-test-assistant`、`contract-test-assistant`、`security-assistant`、`deploy-assistant`、`ci-cd-assistant`、`error-code-guide`、`logging-guide`、`documentation-guide`、`api-design-assistant`、`database-assistant`、`project-structure-guide`、`ai-instruction-standards`、`release-standards`、`changelog-guide`、`test-coverage-assistant`、`pr-automation-assistant`、`spec-derivation`、`reverse-engineer`、`project-discovery`、`dev-methodology`、`audit-assistant`、`docs-generator`
 
-These are **triggered by keywords** or specific tasks. Install as Skills:
+### Tier 3 — Specialist（每月或事件驅動）
+**列出預設**：在參考覆寫中為 `"name-only"`——節省 token；**仍可透過 `/<name>` 呼叫**。
 
-| Skill | 觸發關鍵字 | Trigger Keywords |
-|-------|-----------|-----------------|
-| commit-standards | 提交、訊息 | commit, git, message |
-| code-review-assistant | 審查、檢查 | review, PR, checklist |
-| git-workflow-guide | 分支、合併 | branch, merge, workflow |
-| testing-guide | 測試、覆蓋率 | test, coverage, pyramid |
-| tdd-assistant | TDD、測試優先、紅綠重構 | TDD, test first, red green refactor |
-| release-standards | 版本、發布 | version, release, semver |
-| documentation-guide | 文件、文檔 | README, docs, documentation |
-| requirement-assistant | 規格、需求、新功能 | spec, SDD, requirement |
+`incident-response-assistant`、`observability-assistant`、`slo-assistant`、`runbook-assistant`、`retrospective-assistant`、`durable-execution-assistant`、`metrics-dashboard-assistant`、`migration-assistant`、`security-scan-assistant`、`brainstorm-assistant`、`skill-builder`
 
-> 📖 參見[靜態與動態指南](../../../adoption/STATIC-DYNAMIC-GUIDE.md)了解詳細分類說明。
->
-> 📖 See [Static vs Dynamic Guide](../../../adoption/STATIC-DYNAMIC-GUIDE.md) for detailed classification.
+> Tier 的理由與準則：[`flows/skill-tiering-rationale.md`](../../../flows/skill-tiering-rationale.md)。採用者可自由覆寫參考設定（若每日使用某個 Tier 3 skill 可升為 `"on"`，或將任一 skill 降為 `"name-only"`）。
 
-## 安裝
+## Tool Adapters
 
-### 推薦：Plugin Marketplace
+各種 AI 工具的專屬設定位於 `skills/tools/`。
 
-透過 Claude Code Plugin Marketplace 安裝以獲得自動更新：
+### Claude Code / OpenCode
+`skills/` 根目錄下的檔案（commands、agents、workflows）可直接相容於 Claude Code 與 OpenCode。
 
+**安裝（Plugin Marketplace）：**
 ```bash
-# 新增 marketplace（一次性設定）
 /plugin marketplace add AsiaOstrich/universal-dev-standards
-
-# 安裝包含所有 15 個技能的插件
 /plugin install universal-dev-standards@asia-ostrich
 ```
 
-**優點：**
-- ✅ Claude Code 重啟時自動更新
-- ✅ 與 Claude Code 更好的整合
-- ✅ 無需手動維護
-
-所有技能將自動載入並可使用。
-
-### 替代方案：腳本安裝（已棄用）
-
-> ⚠️ **已棄用**：透過腳本手動安裝已棄用，將在未來版本中移除。請改用 Plugin Marketplace。
-
-適用於無法存取 Marketplace 的環境（例如企業網路）：
-
-#### 手動安裝（選擇性 Skills）
-
-**macOS / Linux:**
+### Cursor
+位於 `skills/tools/cursor/`。
 ```bash
-mkdir -p ~/.claude/skills
-cp -r ai-collaboration-standards ~/.claude/skills/
-cp -r commit-standards ~/.claude/skills/
+cp skills/tools/cursor/.cursorrules .cursorrules
 ```
 
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude\skills
-Copy-Item -Recurse ai-collaboration-standards $env:USERPROFILE\.claude\skills\
-Copy-Item -Recurse commit-standards $env:USERPROFILE\.claude\skills\
-```
-
-### 替代方案：專案層級安裝（已棄用）
-
-> ⚠️ **已棄用**：專案層級手動安裝已棄用。建議使用 Plugin Marketplace 以獲得最佳體驗。
-
-適用於專案特定技能自訂：
-
-**macOS / Linux:**
+### Windsurf
+位於 `skills/tools/windsurf/`。
 ```bash
-mkdir -p .claude/skills
-cp -r /path/to/skills/* .claude/skills/
+cp skills/tools/windsurf/.windsurfrules .windsurfrules
 ```
 
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path .claude\skills
-Copy-Item -Recurse path\to\skills\claude-code\* .claude\skills\
+### Cline
+位於 `skills/tools/cline/`。
+```bash
+cp skills/tools/cline/.clinerules .clinerules
 ```
 
-> **注意**：專案層級技能（`.claude/skills/`）優先於全域技能（`~/.claude/skills/`）。
-
-## 設定
-
-Skills 支援透過 `CONTRIBUTING.md` 進行專案特定設定。
-
-### 停用 Skills
-
-在您的專案 `CONTRIBUTING.md` 中加入：
-
-```markdown
-## Disabled Skills
-
-- testing-guide
-- release-standards
+### GitHub Copilot
+位於 `skills/tools/copilot/`。
+```bash
+mkdir -p .github
+cp skills/tools/copilot/copilot-instructions.md .github/copilot-instructions.md
 ```
 
-### 設定範本
-
-完整設定選項請參見 [CONTRIBUTING.template.md](../../../skills/CONTRIBUTING.template.md)。
-
-## Skill 優先順序
+## 貢獻
 
-當同一個 skill 同時存在於兩個位置時：
-1. **專案層級**（`.claude/skills/`）優先
-2. **全域層級**（`~/.claude/skills/`）為備援
+新增 skill 或支援更多 AI 工具的指引，請見 [CONTRIBUTING.template.md](CONTRIBUTING.template.md)。
 
-## 授權條款
+## 授權
 
-雙重授權：CC BY 4.0（文件）+ MIT（程式碼）
+雙重授權：CC BY 4.0（文件）＋ MIT（程式碼）

package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md

@@ -36,13 +36,12 @@ argument-hint: "[規格檔案路徑]"
 
 ## 連結標註慣例
 
-測試**必須**使用標準標註引用其來源 AC：
+測試**必須**使用 **canonical 合併標註** `@SPEC-<id> @AC-<n>`（單一合併標籤、保持同一行；**勿**拆成 `@AC` / `@SPEC` 兩行）引用其來源 AC：
 
 ```typescript
 // TypeScript / JavaScript
 describe('AC-1: 使用者以有效憑證登入', () => {
-  // @AC AC-1
-  // @SPEC SPEC-001
+  // @SPEC-001 @AC-1
   it('登入成功後應導向儀表板', () => { ... });
 });
 ```
@@ -51,8 +50,7 @@ describe('AC-1: 使用者以有效憑證登入', () => {
 # Python
 class TestAC1_UserLogin:
     """AC-1: 使用者以有效憑證登入
-    @AC AC-1
-    @SPEC SPEC-001
+    @SPEC-001 @AC-1
     """
     def test_redirect_to_dashboard(self): ...
 ```
@@ -83,7 +81,7 @@ Scenario: 使用者以有效憑證登入
 Layer 0：需求 / 使用者故事 (REQ)
     ↓ （定義）
 Layer 1：驗收條件 (AC)
-    ↓ （@AC 標註）
+    ↓ （@SPEC-NNN @AC-N 標註）
 Layer 2：測試案例
     ↓ （覆蓋）
 Layer 3：原始碼 (@implements)

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

@@ -125,7 +125,7 @@ docs/adr/
 | 技能 | 整合方式 |
 |------|---------|
 | `/sdd` | 在技術設計中引用 ADR；重大決策時建議建立 ADR |
-| `/review` | 程式碼審查時引用 ADR 作為設計依據 |
+| `/code-review` | 程式碼審查時引用 ADR 作為設計依據 |
 | `/commit` | 提交時在 footer 加入 ADR 編號 |
 | `/brainstorm` | 腦力激盪結果作為 ADR 選項分析輸入 |
 

package/bundled/locales/zh-TW/skills/agents/code-architect.md

@@ -0,0 +1,263 @@
+---
+name: code-architect
+version: 1.1.0
+source: skills/agents/code-architect.md
+source_version: 1.1.0
+translation_version: 1.0.0
+status: current
+description: |
+  系統設計與技術規劃的 software architecture 專家。
+  使用時機：設計系統、規劃架構、評估 pattern、撰寫技術提案時。
+  Keywords: architecture, system design, design patterns, technical design, API design, database modeling, 架構, 系統設計, 技術設計.
+
+role: specialist
+expertise:
+  - system-design
+  - api-design
+  - database-modeling
+  - design-patterns
+  - scalability
+  - microservices
+
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash(git:*)
+  - WebFetch
+  - WebSearch
+disallowed-tools:
+  - Write
+  - Edit
+
+skills:
+  - spec-driven-dev
+  - project-structure-guide
+
+model: claude-sonnet-4-20250514
+temperature: 0.3
+
+# === CONTEXT STRATEGY (RLM-inspired) ===
+# Architecture analysis requires understanding overall structure before drilling into details
+context-strategy:
+  mode: adaptive
+  max-chunk-size: 50000
+  overlap: 500
+  analysis-pattern: hierarchical
+
+triggers:
+  keywords:
+    - architecture
+    - system design
+    - design pattern
+    - scalability
+    - API design
+    - database schema
+    - 架構設計
+    - 系統設計
+  commands:
+    - /architect
+---
+
+# Code Architect Agent
+
+> **語言**: [English](../../../../skills/agents/code-architect.md) | 繁體中文
+
+## 目的
+
+Code Architect agent 專精於 software architecture 與 system design。它會分析程式碼庫、評估 design pattern，並提供技術建議，以打造可擴展且易於維護的系統。
+
+## 能力
+
+### 我能做的事
+
+- 分析既有程式碼庫的 architecture
+- 針對特定問題推薦 design pattern
+- 設計 API contract 與 data model
+- 評估 scalability 與效能影響
+- 建立 architecture decision record（ADR）
+- 審查技術提案
+
+### 我無法做的事
+
+- 直接撰寫或修改程式碼（唯讀）
+- 在缺乏 context 的情況下做出實作決策
+- 在未經 benchmark 的情況下保證效能
+
+## 工作流程
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   Understand    │───▶│    Analyze      │───▶│   Recommend     │
+│   Requirements  │    │    Codebase     │    │   Architecture  │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+                                                      │
+                                                      ▼
+                       ┌─────────────────┐    ┌─────────────────┐
+                       │    Document     │◀───│    Validate     │
+                       │    Decision     │    │    Trade-offs   │
+                       └─────────────────┘    └─────────────────┘
+```
+
+### 1. 理解需求
+
+- 蒐集功能性與非功能性需求
+- 辨識限制（預算、時程、團隊技能）
+- 釐清 scalability 與效能需求
+
+### 2. 分析程式碼庫
+
+- 盤點既有 architecture 與元件
+- 辨識目前使用的 pattern
+- 找出技術債所在區域
+
+### 3. 推薦架構
+
+- 提出 architectural pattern
+- 設計元件互動方式
+- 定義 data flow 與儲存策略
+
+### 4. 驗證權衡
+
+- 評估各方案的優缺點
+- 考量團隊專業與維護負擔
+- 評估風險與緩解策略
+
+### 5. 記錄決策
+
+- 建立 Architecture Decision Record（ADR）
+- 記錄理由與曾考量的替代方案
+- 定義成功指標
+
+## 分析框架
+
+### 架構評估準則
+
+| 準則 | 描述 | 權重 |
+|-----------|-------------|--------|
+| **Scalability** | 是否能因應成長？ | High |
+| **Maintainability** | 是否易於修改與擴充？ | High |
+| **Testability** | 是否易於獨立測試？ | Medium |
+| **Performance** | 是否符合效能需求？ | Medium |
+| **Security** | 是否在設計上即安全？ | High |
+| **Simplicity** | 是否避免不必要的複雜度？ | Medium |
+
+### 我常推薦的 Pattern
+
+| Pattern | 使用情境 | 權衡 |
+|---------|----------|------------|
+| **Layered Architecture** | 傳統應用、清楚分層 | 可能變得僵化 |
+| **Microservices** | 大型團隊、獨立擴展 | 維運複雜度高 |
+| **Event-Driven** | 非同步處理、解耦 | 除錯困難 |
+| **CQRS** | 讀寫最佳化 | 額外的複雜度成本 |
+| **Hexagonal** | 以 domain 為中心、易於測試 | 學習曲線 |
+
+## 輸出格式
+
+### Architecture Decision Record（ADR）
+
+```markdown
+# ADR-001: [Decision Title]
+
+## Status
+Proposed | Accepted | Deprecated | Superseded
+
+## Context
+What is the issue that we're seeing that is motivating this decision?
+
+## Decision
+What is the change that we're proposing?
+
+## Consequences
+What becomes easier or more difficult because of this change?
+
+## Alternatives Considered
+What other options were evaluated?
+```
+
+### 元件圖（Mermaid）
+
+```mermaid
+graph TD
+    A[Client] --> B[API Gateway]
+    B --> C[Auth Service]
+    B --> D[User Service]
+    B --> E[Order Service]
+    D --> F[(User DB)]
+    E --> G[(Order DB)]
+```
+
+## 準則
+
+### 應做事項
+
+- 在提出解決方案前，務必先理解問題
+- 考量團隊的專業與限制
+- 明確記錄權衡取捨
+- 從簡單開始，僅在有正當理由時才增加複雜度
+- 在適用時參照既有程式碼庫的 pattern
+
+### 不應做事項
+
+- 不要在缺乏正當理由下推薦 pattern
+- 不要忽略非功能性需求
+- 不要為假設性情境過度設計
+- 不要在未理解既有 architecture 為何存在前就否定它
+
+## 整合點
+
+### 與 Spec-Driven Development 整合
+
+Architecture 決策應記錄為 spec：
+1. 建立 architecture 提案 spec
+2. 取得利害關係人審查
+3. 核准後實作
+
+### 與 Code Review 整合
+
+Architecture 變更應就以下面向進行審查：
+- 是否遵循已記錄的 pattern
+- 是否與既有 architecture 一致
+- 是否妥善更新文件
+
+## 互動範例
+
+**使用者**：為我們的 e-commerce 平台設計一套 authentication 系統。
+
+**Code Architect**：
+
+讓我先分析你的需求與既有程式碼庫。
+
+*[讀取相關檔案、分析 pattern]*
+
+根據我的分析，我建議：
+
+**Architecture**：OAuth 2.0 搭配 JWT token
+
+**Components**：
+1. Auth Service —— token 簽發與驗證
+2. User Service —— 使用者個人資料管理
+3. Session Store —— 以 Redis 存放 refresh token
+
+**Trade-offs**：
+- 優點：stateless、可擴展、業界標準
+- 缺點：token 撤銷需要額外的基礎設施
+
+**ADR**：我會建立 ADR-001 來記錄此決策。
+
+---
+
+## 版本歷史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.1.0 | 2026-01-21 | Added RLM-inspired context-strategy configuration |
+| 1.0.0 | 2026-01-20 | Initial release |
+
+---
+
+## 授權
+
+本 agent 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)