universal-dev-standards 5.4.0 → 5.5.0

package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../skills/ai-instruction-standards/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-05
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-05-05
 status: current
 scope: partial
 description: |
@@ -15,8 +15,8 @@ description: |
 
 > **语言**: [English](../../../../skills/ai-instruction-standards/SKILL.md) | 简体中文
 
-**版本**: 1.0.0
-**最后更新**: 2026-01-25
+**版本**: 2.0.0
+**最后更新**: 2026-05-05
 **适用范围**: Claude Code Skills
 
 ---

package/bundled/locales/zh-TW/CHANGELOG.md

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.4.0
-translation_version: 5.4.0
-last_synced: 2026-04-27
+source_version: 5.5.0
+translation_version: 5.5.0
+last_synced: 2026-05-05
 status: current
 ---
 

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

@@ -14,7 +14,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 5.4.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.5.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md

@@ -1,42 +1,78 @@
 ---
 name: ai-instruction-standards
 source: ../../../../skills/ai-instruction-standards/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-05
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-04-28
 status: current
 scope: partial
-description: "[UDS] 建立和維護 AI 指令檔案（CLAUDE.md、.cursorrules 等）並採用適當結構"
+description: "[UDS] 建立和維護 AI 指令檔案（CLAUDE.md、AGENTS.md、.cursor/rules/ 等）並採用適當結構"
 ---
 
 # AI 指令檔案標準指南
 
 > **語言**: [English](../../../../skills/ai-instruction-standards/SKILL.md) | 繁體中文
 
-**版本**: 1.0.0
-**最後更新**: 2026-01-25
-**適用範圍**: Claude Code Skills
+**版本**: 2.0.0
+**最後更新**: 2026-04-28
+**適用範圍**: 所有主流 AI 輔助編程工具
 
 ---
 
 > **核心標準**: 本技能實作 [AI 指令檔案標準](../../core/ai-instruction-standards.md)。完整方法論文件請參閱核心標準。
 
+## AI 技能層級
+
+本技能是三層 AI 協作系統的一部分：
+
+| 層級 | 技能 | 回答的問題 |
+|------|------|-----------|
+| **行為**（即時） | `/ai-collaboration` | 「AI 如何準確回應？」 |
+| **配置**（Session） | `/ai-instruction-standards`（本技能） | 「CLAUDE.md / AGENTS.md 該寫什麼？」 |
+| **架構**（長期） | `/ai-friendly-architecture` | 「如何讓專案對 AI 友善？」 |
+
 ## 目的
 
-本技能協助建立和維護 AI 指令檔案，適當區分通用標準與專案特定配置。
+本技能協助建立和維護 AI 指令檔案，適當區分通用標準與專案特定配置，適用於所有主流 AI 輔助編程工具。
+
+---
 
 ## 快速參考
 
-### 支援的 AI 工具
+### 支援的 AI 工具（2026-04-28 更新）
+
+#### CLI / Agent 型（終端機代理）
+
+| 工具 | 主要指令檔案 | Workflow 機制 | MCP |
+|------|------------|--------------|-----|
+| **Claude Code** | `CLAUDE.md` + `.claude/rules/*.md` | Skills (`.claude/skills/` → `/{name}`) | ✅ |
+| **Gemini CLI** | `GEMINI.md` | `.gemini/commands/*.toml` → `/{name}` | ✅ |
+| **OpenAI Codex CLI** | `AGENTS.md`（+ `AGENTS.override.md`） | 團隊指令；`/review` 內建 | ✅ |
+| **OpenCode** | `AGENTS.md`（相容 CLAUDE.md） | 僅內建（`/init` `/undo` `/share`） | ✅ |
+
+#### AI-native IDE / 編輯器整合
+
+| 工具 | 主要指令檔案 | Workflow 機制 | MCP |
+|------|------------|--------------|-----|
+| **Cursor** | `.cursor/rules/*.mdc` ⚠️ | `@`-mention；`/multitask` | ✅ |
+| **GitHub Copilot** | `.github/copilot-instructions.md` | `.github/prompts/*.prompt.md` → `/{name}` | ✅ |
+| **Windsurf** | `.windsurfrules` / `.windsurf/rules/*.md` | `.windsurf/workflows/*.md` → `/{name}` | ✅ |
+| **Cline** | `.clinerules` | 無 | ✅ |
+
+> ⚠️ **Cursor**：`.cursorrules` 已**棄用** — 請遷移至 `.cursor/rules/*.mdc`
+
+---
+
+### 跨工具通用標準：`AGENTS.md`
 
-| AI 工具 | 指令檔案 | 格式 |
-|---------|----------|------|
-| Claude Code | `CLAUDE.md` | Markdown |
-| Cursor | `.cursorrules` | Markdown |
-| Windsurf | `.windsurfrules` | Markdown |
-| Cline | `.clinerules` | Markdown |
-| GitHub Copilot | `.github/copilot-instructions.md` | Markdown |
-| OpenCode | `.opencode/instructions.md` | Markdown |
+`AGENTS.md` 正成為事實上的跨工具指令標準：
+
+**支援的工具**：Gemini CLI、OpenAI Codex CLI、OpenCode、GitHub Copilot、Windsurf、Cursor
+**不支援的工具**：Claude Code（使用 `CLAUDE.md`）、Cline（使用 `.clinerules`）
+
+**建議**：多工具專案使用 `AGENTS.md` 作為通用基準，再為各工具添加特定檔案（Skills、Workflows、Prompts）。
+
+---
 
 ### 核心原則：通用 vs 專案特定
 
@@ -45,6 +81,8 @@ description: "[UDS] 建立和維護 AI 指令檔案（CLAUDE.md、.cursorrules
 | **通用** | 通用規則 | 「提交前執行測試」 |
 | **專案特定** | 具體命令 | 「提交前執行 `npm test`」 |
 
+---
+
 ### 建議配置
 
 ```markdown
@@ -72,89 +110,152 @@ description: "[UDS] 建立和維護 AI 指令檔案（CLAUDE.md、.cursorrules
 [你的專案結構]
 ```
 
-## 詳細指南
+---
 
-完整標準請參閱：
-- [AI 指令檔案標準](../../core/ai-instruction-standards.md)
+## 各工具設定指南
 
-### AI 優化格式（Token 效率）
+### Claude Code
 
-AI 助手可使用 YAML 格式檔案以減少 Token 使用：
-- 基礎標準：`ai/standards/ai-instruction-standards.ai.yaml`
+```
+CLAUDE.md                        # 主要指令（階層式：全域 → 專案 → 子目錄）
+.claude/rules/                   # Glob 範圍的附加規則
+.claude/skills/{name}/SKILL.md   # 自訂斜線命令 → /{name}
+.claude/agents/{name}.md         # 子代理定義
+```
 
-## 內容指南
+### Gemini CLI
 
-### 通用內容（保持通用）
+```
+GEMINI.md                          # 主要指令
+.gemini/commands/{name}.toml       # 自訂斜線命令 → /{name}
+.gemini/agents/{name}.yaml         # 子代理定義
+```
 
-| 類別 | 良好範例 |
-|------|----------|
-| **提交標準** | 「遵循 Conventional Commits 格式」 |
-| **程式碼審查** | 「使用 BLOCKING、IMPORTANT、SUGGESTION 前綴」 |
-| **測試** | 「維持最低 80% 覆蓋率」 |
-| **AI 行為** | 「分析前務必先讀取程式碼」 |
+`.gemini/commands/review.toml` 範例：
+```toml
+description = "執行程式碼審查清單"
+prompt = "審查以下變更：!{git diff HEAD}"
+```
 
-**通用區段應避免：**
-- 特定命令（`npm test`、`pytest`）
-- 固定路徑（`cli/src/`、`/var/www/`）
-- 版本號（`Node.js 18`、`Python 3.11`）
-- 專案名稱和 URL
+### OpenAI Codex CLI
 
-### 專案特定內容
+```
+AGENTS.md                  # 主要指令（從 Git root 到 cwd 逐層讀取）
+AGENTS.override.md         # 暫時覆蓋（最高優先級）
+~/.codex/AGENTS.md         # 全域備援
+.codex/agents/             # 自訂代理定義
+```
 
-| 類別 | 範例 |
-|------|------|
-| **技術棧** | Node.js 18、React 18、PostgreSQL 15 |
-| **命令** | `npm run lint`、`./scripts/deploy.sh` |
-| **檔案結構** | `src/`、`cli/`、`tests/` |
-| **團隊慣例** | 繁體中文註解 |
+### OpenCode
 
-## 標籤慣例
+```
+AGENTS.md                       # 主要（自動識別）
+CLAUDE.md                       # 同樣識別（遷移相容性）
+.opencode/agents/               # 自訂代理定義
+opencode.json (instructions)    # Glob 模式檔案引用
+```
 
-### 選項 A：區段標題
+### Cursor
 
-```markdown
-## 通用標準
-[通用內容]
+```
+.cursor/rules/                  # MDC 格式規則（取代 .cursorrules）
+  {name}.mdc                    # Frontmatter: description, globs, alwaysApply
+AGENTS.md                       # 也支援（代理上下文）
+```
 
-## 專案特定配置
-[專案特定內容]
+MDC frontmatter 範例：
+```yaml
+---
+description: "TypeScript 編碼標準"
+globs: ["**/*.ts", "**/*.tsx"]
+alwaysApply: false
+---
 ```
 
-### 選項 B：行內標記
+> **遷移指引**：若有 `.cursorrules`，請將內容移至 `.cursor/rules/*.mdc`。
 
-```markdown
-> ⚠️ **專案特定**：本區段包含此專案獨有的配置。
+### GitHub Copilot
 
-### 技術棧
-...
+```
+.github/copilot-instructions.md         # 永遠啟用，所有對話
+.github/instructions/*.instructions.md  # 條件式，Glob 範圍（applyTo frontmatter）
+.github/prompts/*.prompt.md             # 可重用模板 → /{name} 斜線命令
+.github/agents/*.agent.md               # 自訂代理，精細工具存取控制
+AGENTS.md                               # 也被識別
 ```
 
-### 選項 C：註解標註
+### Windsurf
 
-```markdown
-<!-- 通用：以下適用於所有專案 -->
-### Commit 訊息格式
-...
+```
+.windsurfrules                   # 專案規則（可 Git 共享）
+.windsurf/rules/*.md             # MDC frontmatter 結構化規則
+.windsurf/workflows/*.md         # 可重用任務序列 → /{name}
+AGENTS.md                        # 也被識別
+```
 
-<!-- 專案特定：為你的專案自訂 -->
-### 快速命令
-...
+Workflow 範例（`.windsurf/workflows/review.md`）：
+```markdown
+執行程式碼審查：
+1. 執行 `git diff HEAD`
+2. 檢查 BLOCKING 問題（安全性、正確性）
+3. 檢查 IMPORTANT 問題（設計、測試）
+4. 以 BLOCKING/IMPORTANT/SUGGESTION 前綴輸出發現
 ```
 
-## 多工具配置
+---
+
+## 多工具專案配置
 
-使用多個 AI 工具時，保持一致性：
+當專案使用多個 AI 工具時：
 
 ```
 project/
-├── CLAUDE.md              # Claude Code 指令
-├── .cursorrules           # Cursor 指令（可從 CLAUDE.md 匯入）
-├── .windsurfrules         # Windsurf 指令
+├── AGENTS.md                            # 通用基準（跨工具）
+├── CLAUDE.md                            # Claude Code（擴展 AGENTS.md）
+├── GEMINI.md                            # Gemini CLI
+├── .cursor/rules/
+│   └── standards.mdc                    # Cursor
+├── .windsurf/
+│   └── workflows/                       # Windsurf Workflows
+│       ├── review.md
+│       └── checkin.md
 └── .github/
-    └── copilot-instructions.md  # Copilot 指令
+    ├── copilot-instructions.md          # Copilot 永遠啟用
+    └── prompts/
+        └── review.prompt.md             # Copilot 斜線命令
 ```
 
-**最佳實踐**：建立共用的 `docs/ai-standards.md` 並從各工具檔案引用，避免重複。
+**最佳實踐**：將通用內容寫在 `AGENTS.md` 一次，從各工具特定檔案引用，避免重複。
+
+---
+
+## 內容指南
+
+### 通用內容（保持通用）
+
+| 類別 | 良好範例 |
+|------|----------|
+| **提交標準** | 「遵循 Conventional Commits 格式」 |
+| **程式碼審查** | 「使用 BLOCKING、IMPORTANT、SUGGESTION 前綴」 |
+| **測試** | 「維持最低 80% 覆蓋率」 |
+| **AI 行為** | 「分析前務必先讀取程式碼」 |
+
+**通用區段應避免：**
+- 特定命令（`npm test`、`pytest`）
+- 固定路徑（`cli/src/`、`/var/www/`）
+- 版本號（`Node.js 18`、`Python 3.11`）
+- 專案名稱和 URL
+
+### 專案特定內容
+
+| 類別 | 範例 |
+|------|------|
+| **技術棧** | Node.js 18、React 18、PostgreSQL 15 |
+| **命令** | `npm run lint`、`./scripts/deploy.sh` |
+| **檔案結構** | `src/`、`cli/`、`tests/` |
+| **團隊慣例** | 繁體中文註解 |
+
+---
 
 ## 維護檢查清單
 
@@ -164,27 +265,29 @@ project/
 - [ ] 專案特定區段有明確標記
 - [ ] 標準文件的交叉引用正確
 - [ ] 格式與現有區段一致
+- [ ] 若使用 Cursor：`.cursorrules` 已遷移至 `.cursor/rules/*.mdc`
+- [ ] 若為多工具專案：`AGENTS.md` 已涵蓋通用基準
 
 ---
 
 ## 配置偵測
 
-本技能支援專案特定配置。
-
 ### 偵測順序
 
-1. 檢查是否存在 `CLAUDE.md` 或等效檔案
-2. 分析內容結構是否區分通用/專案特定
-3. 若未找到，**建議建立結構化 AI 指令檔案**
+1. 檢查是否存在 `CLAUDE.md`、`AGENTS.md`、`GEMINI.md` 或等效檔案
+2. 偵測使用中的 AI 工具（檢查 `.cursor/`、`.windsurf/`、`.github/copilot-instructions.md` 等）
+3. 分析內容結構是否區分通用/專案特定
+4. 若未找到，**建議建立結構化 AI 指令檔案**
 
 ### 首次設定
 
 若未找到 AI 指令檔案：
 
-1. 詢問：「此專案沒有 AI 指令檔案。是否要建立一個？」
-2. 確定專案類型和技術棧
-3. 產生包含適當區段的範本
-4. 若包含敏感資訊，新增到 `.gitignore`
+1. 詢問：「此專案沒有 AI 指令檔案。你使用哪些 AI 工具？」
+2. 多工具專案推薦 `AGENTS.md` 作為基準，純 Claude Code 使用 `CLAUDE.md`
+3. 確定專案類型和技術棧
+4. 產生包含適當區段的範本
+5. 若包含敏感資訊，新增到 `.gitignore`
 
 ---
 
@@ -201,6 +304,7 @@ project/
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 2.0.0 | 2026-04-28 | 新增 Gemini CLI、OpenAI Codex CLI；更新 Cursor（MDC 格式，標記 .cursorrules 棄用）；更新 OpenCode（AGENTS.md 為主）；更新 Copilot（多種指令檔案類型）；更新 Windsurf（Workflows）；新增 AGENTS.md 跨工具標準章節 |
 | 1.0.0 | 2026-01-25 | 初始發布 |
 
 ---

package/bundled/skills/README.md

@@ -34,14 +34,15 @@ These skills provide standard guidance and workflows. They can be accessed via s
 | `bdd-assistant` | `/bdd` | [UDS] Behavior-Driven Development |
 | `atdd-assistant` | `/atdd` | [UDS] Acceptance Test-Driven Development |
 | `e2e-assistant` | `/e2e` | [UDS] E2E test skeleton generation from BDD scenarios |
+| `journey-test-assistant` | `/journey-test` | [UDS] Connected user journey test plan (TESTPLAN) + E2E skeleton generation |
 | `release-standards` | `/release` | [UDS] Release & Changelog management |
 | `documentation-guide` | `/docs` | [UDS] Documentation management |
 | `requirement-assistant` | `/requirement` | [UDS] Requirement writing |
 | `reverse-engineer` | `/reverse` | [UDS] Reverse engineer code |
-| `forward-derivation` | `/derive` | [UDS] Derive artifacts from spec |
+| `spec-derivation` | `/spec-derive` | [UDS] Derive BDD/TDD/ATDD artifacts from spec |
 | `spec-driven-dev` | `/sdd` | [UDS] Spec-Driven Development |
 | `test-coverage-assistant` | `/coverage` | [UDS] Test coverage analysis |
-| `methodology-system` | `/methodology` | [UDS] Development methodology |
+| `dev-methodology` | `/methodology` | [UDS] Development methodology |
 | `refactoring-assistant` | `/refactor` | [UDS] Refactoring guidance |
 | `project-discovery` | `/discover` | [UDS] Assess project health and risks |
 | `brainstorm-assistant` | `/brainstorm` | [UDS] Structured AI-assisted ideation |
@@ -62,7 +63,7 @@ These skills provide standard guidance and workflows. They can be accessed via s
 | `observability-assistant` | `/observability` | [UDS] Observability setup, metrics, alerting 🆕 |
 | `slo-assistant` | `/slo` | [UDS] SLI selection, SLO setting, Error Budget 🆕 |
 | `runbook-assistant` | `/runbook` | [UDS] Runbook creation, drills, coverage 🆕 |
-| `process-automation` | `/process-to-skill` | [UDS] Identify repeated processes and build Skills with the right development depth |
+| `skill-builder` | `/skill-builder` | [UDS] Identify repeated processes and build Skills with the right development depth |
 
 > **Note**: For reference guides (e.g., Git Workflow, Logging, Error Codes), use the `/guide` command.
 

package/bundled/skills/SKILL_NAMING.md

@@ -0,0 +1,94 @@
+# UDS Skill 命名規範
+
+> **版本**: 1.0.0 | **建立**: 2026-04-29 | **依據**: XSPEC-100
+
+本文件定義所有 UDS Skill 的命名規則，確保命令一致、可猜測、不需背景知識即可理解。
+
+---
+
+## 規則
+
+### 規則 1：目錄名稱以功能領域為主詞
+
+- **格式**：`{領域}-{動作/角色}` 或 `{領域}-{類型}`
+- **良好範例**：`tdd-assistant`、`api-design-assistant`、`dev-methodology`
+- **避免**：`methodology-system`（`-system` 不傳遞任何資訊）、`process-automation`（太廣泛）
+
+### 規則 2：後綴使用 `-assistant` 或無後綴
+
+| 後綴 | 使用時機 |
+|------|---------|
+| `-assistant` | Skill 提供互動式引導流程（問答式、多階段） |
+| 無後綴 | 工具型（`push`）、短命令（`xspec`）、名詞型（`dev-methodology`） |
+| **禁止** `-guide` 與 `-standards` 混用 | 改為描述性名詞（`logging-guide` → `logging`，長期計畫） |
+
+### 規則 3：縮寫只限業界公認的詞彙
+
+| 允許縮寫 | 全稱 | 說明 |
+|---------|------|------|
+| `tdd` | Test-Driven Development | 業界公認 |
+| `bdd` | Behavior-Driven Development | 業界公認 |
+| `atdd` | Acceptance TDD | 業界公認（需在 README 說明） |
+| `e2e` | End-to-End | 業界公認 |
+| `api` | Application Programming Interface | 通用 |
+| `ci-cd` | Continuous Integration/Delivery | 業界公認 |
+| `slo` | Service Level Objective | SRE 領域公認（需在 README 說明） |
+
+**禁止使用未說明的專案特定縮寫作為主要識別名稱**（如 `xspec`、`dec` 屬於工具型短命令，已在說明文件補充全稱）。
+
+### 規則 4：slash command（`name:` 欄位）必須比目錄名更短
+
+- 目錄名用於 system-reminder 顯示（描述性）
+- `name:` 欄位是使用者實際輸入的命令（應短、清楚）
+- 例：目錄 `tdd-assistant` → `name: tdd`；目錄 `api-design-assistant` → `name: api-design`
+
+### 規則 5：命令名稱必須能預測功能
+
+判斷標準：對不認識此 Skill 的開發者說「這個命令叫 `/xxx`」，他能否猜出大概是做什麼？
+
+- `/tdd` ✅ → 測試驅動開發
+- `/eval-source` ✅ → 評估外部來源
+- `/borrow` ❌ → 借什麼？
+- `/derive` ⚠️ → 可接受（SDD 脈絡下清楚），但 `/spec-derive` 更明確
+
+---
+
+## 命名範例對照表
+
+| 舊命令目錄 | 新命令目錄 | slash command | 改名原因 |
+|----------|----------|--------------|---------|
+| `ac-coverage-assistant` | `ac-coverage` | `/ac-coverage` | 去冗餘後綴；已有 `name: ac-coverage` |
+| `forward-derivation` | `spec-derivation` | `/derive` | 明確「從規格衍生」語意 |
+| `methodology-system` | `dev-methodology` | `/methodology` | `-system` 無意義，改為名詞形式 |
+| `process-automation` | `skill-builder` | `/skill-builder` | 功能是「建立 Skill」，非廣義自動化 |
+| `borrow-assistant` | `eval-source` | `/eval-source` | 明確「評估外部來源」語意 |
+| `dec-update-assistant` | `dec-update` | `/dec-update` | 去冗餘後綴；已有 `name: dec-update` |
+| `session-prompt-assistant` | `session-init` | `/session-init` | 明確「初始化 session」語意 |
+| `xspec-assistant` | `xspec` | `/xspec` | 工具型短命令，已有 `name: xspec` |
+
+---
+
+## 新增 Skill 命名檢查清單
+
+新增 Skill 時，依序確認：
+
+- [ ] 目錄名以功能領域為主詞（非動詞或系統名詞）
+- [ ] 後綴：引導式用 `-assistant`，工具型無後綴
+- [ ] 只用業界公認縮寫；專案特定縮寫需在 README 補說明
+- [ ] `name:` 欄位比目錄名短，且能預測功能
+- [ ] 更新 `skills/README.md` 加入新 Skill 的縮寫說明
+
+---
+
+## 歷史改名紀錄
+
+| 日期 | 舊名 | 新名 | XSPEC |
+|------|------|------|-------|
+| 2026-04-29 | `ac-coverage-assistant` | `ac-coverage` | XSPEC-100 |
+| 2026-04-29 | `forward-derivation` | `spec-derivation` | XSPEC-100 |
+| 2026-04-29 | `methodology-system` | `dev-methodology` | XSPEC-100 |
+| 2026-04-29 | `process-automation` | `skill-builder` | XSPEC-100 |
+| 2026-04-29 | `borrow-assistant` | `eval-source` | XSPEC-100 |
+| 2026-04-29 | `dec-update-assistant` | `dec-update` | XSPEC-100 |
+| 2026-04-29 | `session-prompt-assistant` | `session-init` | XSPEC-100 |
+| 2026-04-29 | `xspec-assistant` | `xspec` | XSPEC-100 |