universal-dev-standards 4.2.0 → 5.0.0-beta.10

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

@@ -0,0 +1,281 @@
+---
+source: ../../../../skills/agents/README.md
+source_version: 1.1.0
+translation_version: 1.0.0
+last_synced: 2026-02-05
+status: current
+---
+
+# UDS 代理
+
+> **語言**: [English](../../../../skills/agents/README.md) | 繁體中文
+
+**版本**: 1.1.0
+**最後更新**: 2026-01-21
+**狀態**: 穩定
+
+---
+
+## 概述
+
+UDS 代理是專門的 AI 子代理，可以協調處理複雜的開發工作流程。與技能（提供上下文/知識）不同，代理是可以執行多步驟任務的自主實體。
+
+## AGENT.md 格式規格
+
+### Frontmatter 架構
+
+```yaml
+---
+# === 必填欄位 ===
+name: agent-name              # 唯一識別碼（kebab-case）
+version: 1.0.0                # 語義版本
+description: |                # 用於 AI 匹配的多行描述
+  代理目的的簡要描述。
+  關鍵字: keyword1, keyword2, keyword3.
+
+# === 角色配置 ===
+role: specialist              # orchestrator | specialist | reviewer
+expertise:                    # 領域專長
+  - system-design
+  - api-design
+  - database-modeling
+
+# === 工具權限（Claude Code Task 工具）===
+# 指定此代理可以使用哪些工具
+allowed-tools:
+  - Read                      # 檔案讀取
+  - Glob                      # 模式匹配
+  - Grep                      # 內容搜尋
+  - Bash(git:*)               # 僅 Git 命令
+  - WebFetch                  # 網頁抓取
+  - WebSearch                 # 網頁搜尋
+disallowed-tools:             # 明確封鎖的工具
+  - Write                     # 不可寫入檔案
+  - Edit                      # 不可編輯檔案
+
+# === 技能依賴 ===
+# 為此代理提供上下文/知識的技能
+skills:
+  - spec-driven-dev           # 技能名稱引用
+  - testing-guide
+
+# === 模型偏好（僅 Claude Code）===
+model: claude-sonnet-4-20250514  # 偏好模型
+temperature: 0.3              # 回應創造性（0.0-1.0）
+
+# === 上下文策略（RLM 啟發）===
+# 處理大型程式碼庫和長上下文的配置
+context-strategy:
+  mode: adaptive              # full | chunked | adaptive
+  max-chunk-size: 50000       # 每個區塊的最大 token 數
+  overlap: 500                # 區塊間的 token 重疊
+  analysis-pattern: hierarchical  # hierarchical | parallel | sequential
+
+# === 觸發條件 ===
+triggers:
+  keywords:                   # 這些關鍵字自動啟動
+    - architecture
+    - system design
+    - 架構設計
+  commands:                   # 呼叫此代理的斜線命令
+    - /architect
+---
+```
+
+### 角色類型
+
+| 角色 | 描述 | 使用案例 |
+|------|------|---------|
+| `orchestrator` | 協調多個代理 | 複雜工作流程、功能開發 |
+| `specialist` | 特定領域的深度專業 | 架構、測試、文件 |
+| `reviewer` | 評估並提供回饋 | 程式碼審查、規格審查、PR 審查 |
+
+### 工具權限模式
+
+```yaml
+# 完全工具存取（未指定時的預設）
+allowed-tools: [*]
+
+# 唯讀代理
+allowed-tools: [Read, Glob, Grep]
+disallowed-tools: [Write, Edit, Bash]
+
+# 僅限 Git 的 bash 存取
+allowed-tools:
+  - Bash(git:*)     # 僅 git 命令
+  - Bash(npm:test)  # 僅 npm test
+
+# 特定檔案模式
+allowed-tools:
+  - Write(*.md)     # 僅 markdown 檔案
+  - Edit(src/**)    # 僅 src 目錄
+```
+
+### 上下文策略配置（RLM 啟發）
+
+`context-strategy` 區段使用 RLM（遞迴語言模型）原則實現對大型程式碼庫和長上下文的智慧處理。
+
+#### 模式選項
+
+| 模式 | 描述 | 使用案例 |
+|------|------|---------|
+| `full` | 一次載入完整上下文 | 小專案、文件任務 |
+| `chunked` | 將上下文分成固定大小的區塊 | 順序程式碼審查、大型檔案分析 |
+| `adaptive` | 根據內容結構動態調整 | 複雜分析、架構探索 |
+
+#### 分析模式
+
+| 模式 | 描述 | 最適合 |
+|------|------|--------|
+| `hierarchical` | 先分析高層結構，然後深入細節 | 架構分析、系統設計 |
+| `parallel` | 同時處理多個區段 | 獨立模組分析、規格審查 |
+| `sequential` | 依序處理區段，保留上下文 | 程式碼審查、逐步分析 |
+
+## 內建代理
+
+| 代理 | 角色 | 描述 |
+|------|------|------|
+| [code-architect](../../../../skills/agents/code-architect.md) | specialist | 軟體架構和系統設計 |
+| [test-specialist](../../../../skills/agents/test-specialist.md) | specialist | 測試策略和測試實作 |
+| [reviewer](../../../../skills/agents/reviewer.md) | reviewer | 程式碼審查和品質評估 |
+| [doc-writer](../../../../skills/agents/doc-writer.md) | specialist | 文件和技術寫作 |
+| [spec-analyst](../../../../skills/agents/spec-analyst.md) | specialist | 規格分析和需求萃取 |
+
+## 使用方式
+
+### CLI 安裝
+
+```bash
+# 列出可用的代理
+uds agent list
+
+# 將特定代理安裝到專案
+uds agent install code-architect
+
+# 安裝所有代理
+uds agent install --all
+
+# 安裝到使用者目錄（全域）
+uds agent install code-architect --global
+```
+
+### 在 Claude Code 中直接呼叫
+
+```
+/architect [任務描述]
+```
+
+或透過自然語言觸發：
+
+```
+請幫我設計新認證系統的架構。
+```
+
+## 建立自訂代理
+
+### 1. 建立 AGENT.md 檔案
+
+```bash
+# 在你的專案中
+mkdir -p .claude/agents
+touch .claude/agents/my-agent.md
+```
+
+### 2. 定義 Frontmatter
+
+```yaml
+---
+name: my-custom-agent
+version: 1.0.0
+description: |
+  針對特定專案需求的自訂代理。
+  關鍵字: custom, specific, project.
+
+role: specialist
+expertise: [domain-specific]
+
+allowed-tools: [Read, Glob, Grep, Edit]
+skills: [relevant-skill]
+
+triggers:
+  commands: [/myagent]
+---
+```
+
+### 3. 撰寫代理指令
+
+```markdown
+# 我的自訂代理
+
+## 目的
+
+描述此代理的功能。
+
+## 工作流程
+
+1. 步驟一
+2. 步驟二
+3. 步驟三
+
+## 指南
+
+- 指南 1
+- 指南 2
+```
+
+## 代理 vs 技能比較
+
+| 面向 | 技能 | 代理 |
+|------|------|------|
+| **目的** | 提供知識/上下文 | 執行自主任務 |
+| **執行** | 作為上下文載入 | 作為子代理產生（或內嵌） |
+| **狀態** | 無狀態 | 可維護任務狀態 |
+| **工具存取** | 無（僅上下文） | 可配置權限 |
+| **觸發** | 手動載入 | 關鍵字、命令、工作流程 |
+| **組合** | 由代理引用 | 可使用技能作為上下文 |
+
+## 與工作流程整合
+
+代理可透過工作流程定義進行協調：
+
+```yaml
+# workflows/feature-dev.workflow.yaml
+name: feature-development
+steps:
+  - agent: spec-analyst
+    task: 分析需求
+  - agent: code-architect
+    task: 設計解決方案
+  - agent: test-specialist
+    task: 定義測試策略
+  - manual: 實作
+  - agent: reviewer
+    task: 程式碼審查
+```
+
+請參閱 [workflows/README.md](../../../../skills/workflows/README.md) 取得工作流程文件。
+
+---
+
+## 相關資源
+
+- [技能文件](../README.md)
+- [工作流程文件](../../../../skills/workflows/README.md)
+- [AI 代理路徑配置](../../../../cli/src/config/ai-agent-paths.js)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.1.0 | 2026-01-21 | 新增 RLM 啟發的 context-strategy 配置 |
+| 1.0.0 | 2026-01-20 | 初始發布 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/SKILL.md

@@ -1,17 +1,17 @@
 ---
-source: ../../../../../skills/claude-code/ai-collaboration-standards/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-30
+source: ../../../../skills/ai-collaboration-standards/SKILL.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-25
 status: current
 ---
 
 # AI 協作標準
 
-> **語言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/SKILL.md) | 繁體中文
+> **語言**: [English](../../../../skills/ai-collaboration-standards/SKILL.md) | 繁體中文
 
-**版本**: 1.0.0
-**最後更新**: 2025-12-24
+**版本**: 1.1.0
+**最後更新**: 2026-01-25
 **適用範圍**: Claude Code Skills
 
 ---

package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/anti-hallucination.md

@@ -1,17 +1,17 @@
 ---
-source: skills/claude-code/ai-collaboration-standards/anti-hallucination.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-25
+source: ../../../../skills/ai-collaboration-standards/anti-hallucination.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-25
 status: current
 ---
 
 # 防止幻覺指南
 
-> **語言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/anti-hallucination.md) | 繁體中文
+> **語言**: [English](../../../../skills/ai-collaboration-standards/anti-hallucination.md) | 繁體中文
 
-**版本**: 1.0.0
-**最後更新**: 2025-12-24
+**版本**: 1.1.0
+**最後更新**: 2026-01-25
 **適用範圍**: Claude Code Skills
 
 ---
@@ -203,7 +203,7 @@ AI 助理絕對不能:
 
 ## 相關標準
 
-- [防止幻覺標準](../../../core/anti-hallucination.md)
+- [防止幻覺標準](../../core/anti-hallucination.md)
 - [確定性標籤參考](./certainty-labels.md)
 
 ---

package/bundled/locales/zh-TW/skills/{claude-code/ai-collaboration-standards → ai-collaboration-standards}/certainty-labels.md

@@ -1,17 +1,17 @@
 ---
-source: skills/claude-code/ai-collaboration-standards/certainty-labels.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-25
+source: ../../../../skills/ai-collaboration-standards/certainty-labels.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-25
 status: current
 ---
 
 # 確定性標籤參考
 
-> **語言**: [English](../../../../../skills/claude-code/ai-collaboration-standards/certainty-labels.md) | 繁體中文
+> **語言**: [English](../../../../skills/ai-collaboration-standards/certainty-labels.md) | 繁體中文
 
-**版本**: 1.0.0
-**最後更新**: 2025-12-24
+**版本**: 1.1.0
+**最後更新**: 2026-01-25
 **適用範圍**: Claude Code Skills
 
 ---
@@ -113,7 +113,7 @@ status: current
 ## 相關標準
 
 - [防幻覺指南](./anti-hallucination.md)
-- [防幻覺標準](../../../core/anti-hallucination.md)
+- [防幻覺標準](../../core/anti-hallucination.md)
 
 ---
 

package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md

@@ -0,0 +1,221 @@
+---
+source: ../../../../skills/ai-friendly-architecture/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-05
+status: current
+scope: uds-specific
+description: |
+  設計 AI 友善架構，包含明確模式、分層文件和語義邊界。
+  使用時機：為 AI 協作規劃專案結構、優化程式碼庫以利 AI 分析、設定 AI 上下文。
+  關鍵字：architecture, AI-friendly, context, modules, documentation layers, .ai-context.yaml, 架構, AI 友善, 上下文.
+---
+
+# AI 友善架構指南
+
+> **語言**: [English](../../../../skills/ai-friendly-architecture/SKILL.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2026-01-25
+**適用範圍**: Claude Code Skills
+
+---
+
+> **核心標準**: 本技能實作 [AI 友善架構](../../core/ai-friendly-architecture.md)。完整方法論文件請參閱核心標準。
+
+## 目的
+
+本技能協助設計專案架構，透過明確模式、分層文件和語義邊界，最大化 AI 協作效能。
+
+## 快速參考
+
+### 核心原則
+
+| 原則 | 描述 | 效益 |
+|------|------|------|
+| **明確優於隱含** | 明確記錄行為 | AI 無需猜測即可理解 |
+| **分層上下文** | 多層級文件 | 依任務提供適當細節 |
+| **語義邊界** | 清晰的模組邊界 | 獨立分析 |
+| **可發現結構** | 自我說明的結構 | 快速定位 |
+
+### 上下文層級
+
+| 層級 | Token 預算 | 內容 |
+|------|------------|------|
+| **L1: 快速參考** | < 500 | 單行說明、API 簽章、入口點 |
+| **L2: 詳細** | < 5,000 | 完整 API 文件、使用範例 |
+| **L3: 範例** | 無限制 | 完整實作、邊界案例 |
+
+### 建議結構
+
+```
+project/
+├── .ai-context.yaml          # AI 上下文配置
+├── docs/
+│   ├── QUICK-REF.md          # 第 1 層文件
+│   └── ARCHITECTURE.md       # 第 2 層文件
+├── src/
+│   └── auth/
+│       ├── index.ts          # 入口點與模組標頭
+│       ├── QUICK-REF.md      # 模組快速參考
+│       └── README.md         # 模組文件
+└── CLAUDE.md                 # AI 指令檔案
+```
+
+## 模組標頭範本
+
+```javascript
+/**
+ * ═══════════════════════════════════════════════════════════
+ * 模組: [模組名稱]
+ * ═══════════════════════════════════════════════════════════
+ *
+ * 目的: [單句描述]
+ *
+ * 相依性:
+ *   - [dep1]: [原因]
+ *   - [dep2]: [原因]
+ *
+ * 匯出:
+ *   - [function1](params): [描述]
+ *   - [function2](params): [描述]
+ *
+ * 配置:
+ *   - [CONFIG_VAR]: [描述]
+ *
+ * ═══════════════════════════════════════════════════════════
+ */
+```
+
+## 詳細指南
+
+完整標準請參閱：
+- [AI 友善架構標準](../../core/ai-friendly-architecture.md)
+
+### AI 優化格式（Token 效率）
+
+AI 助手可使用 YAML 格式檔案以減少 Token 使用：
+- 基礎標準：`ai/standards/ai-friendly-architecture.ai.yaml`
+
+## .ai-context.yaml 配置
+
+```yaml
+# .ai-context.yaml - AI 上下文配置
+version: 1.0.0
+
+project:
+  name: my-project
+  type: web-app  # web-app | library | cli | api | monorepo
+  primary-language: typescript
+
+modules:
+  - name: auth
+    path: src/auth/
+    entry: index.ts
+    description: 驗證與授權
+    dependencies: [database, crypto]
+    priority: high
+
+  - name: api
+    path: src/api/
+    entry: routes.ts
+    description: REST API 端點
+    dependencies: [auth, database]
+    priority: high
+
+analysis-hints:
+  entry-points:
+    - src/main.ts
+    - src/index.ts
+  ignore-patterns:
+    - node_modules
+    - dist
+    - "*.test.ts"
+  architecture-type: layered
+
+documentation:
+  quick-ref: docs/QUICK-REF.md
+  detailed: docs/ARCHITECTURE.md
+  examples: docs/examples/
+```
+
+## 上下文優先順序指南
+
+| 優先級 | 內容類型 | 原因 |
+|--------|----------|------|
+| 1 | 入口點 | 應用程式結構 |
+| 2 | .ai-context.yaml | 模組地圖和相依性 |
+| 3 | QUICK-REF 檔案 | 快速 API 理解 |
+| 4 | 修改的檔案 | 與任務直接相關 |
+| 5 | 相依鏈 | 變更的上下文 |
+
+## 應避免的反模式
+
+| 反模式 | 問題 | 解決方案 |
+|--------|------|----------|
+| **魔術字串** | AI 無法追蹤常數 | 帶文件的型別常數 |
+| **隱式路由** | 隱藏行為 | 明確路由映射 |
+| **全域狀態** | 不可預測的相依性 | 依賴注入 |
+| **循環相依** | 上下文混亂 | 階層式相依 |
+| **單體檔案** | 上下文溢出 | 專注的模組 |
+
+## 實作檢查清單
+
+### 快速開始（< 1 小時）
+
+- [ ] 建立 `.ai-context.yaml` 含模組清單
+- [ ] 在專案根目錄新增 `QUICK-REF.md`
+- [ ] 在 README 中記錄入口點
+- [ ] 為主要檔案新增模組標頭
+
+### 標準實作（< 1 天）
+
+- [ ] 完成 `.ai-context.yaml` 配置
+- [ ] 為每個主要模組新增 `QUICK-REF.md`
+- [ ] 記錄所有公開 API 及型別資訊
+- [ ] 為大型檔案新增區段分隔
+
+---
+
+## 配置偵測
+
+本技能支援專案特定配置。
+
+### 偵測順序
+
+1. 檢查是否存在 `.ai-context.yaml`
+2. 檢查是否存在 `QUICK-REF.md` 檔案
+3. 若未找到，**建議建立 AI 友善結構**
+
+### 首次設定
+
+若未找到配置：
+
+1. 建議：「此專案尚未為 AI 協作進行配置。是否要設定 AI 友善結構？」
+2. 建立 `.ai-context.yaml` 範本
+3. 在專案根目錄建立 `QUICK-REF.md`
+
+---
+
+## 相關標準
+
+- [AI 友善架構](../../core/ai-friendly-architecture.md) - 核心架構標準
+- [專案結構](../../core/project-structure.md) - 目錄組織
+- [文件結構](../../core/documentation-structure.md) - 文件分層
+- [反幻覺](../../core/anti-hallucination.md) - AI 準確性標準
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-25 | 初始發布 |
+
+---
+
+## 授權
+
+本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)