universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-TW/integrations/github-copilot/README.md

@@ -0,0 +1,167 @@
+---
+source: ../../../../integrations/github-copilot/README.md
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# GitHub Copilot 整合
+
+本目錄提供將通用開發規範與 [GitHub Copilot](https://github.com/features/copilot) 整合的資源。
+
+## 概述
+
+GitHub Copilot 是內建於 GitHub 和主流 IDE 的 AI 編程助手。此整合提供自訂指令，協助 Copilot 生成更高品質、符合規範的程式碼與文件。
+
+## 資源
+
+| 檔案 | 說明 |
+|------|------|
+| **[copilot-instructions.md](./copilot-instructions.md)** | Copilot Chat 自訂指令 |
+| **[COPILOT-CHAT-REFERENCE.md](./COPILOT-CHAT-REFERENCE.md)** | Chat 提示範本 |
+| **[skills-mapping.md](./skills-mapping.md)** | Skills 對照表 |
+
+## 快速開始
+
+### 方式一：專案層級（推薦）
+
+將指令檔案複製到專案：
+
+```bash
+# 建立 .github 目錄（如果不存在）
+mkdir -p .github
+
+# 複製指令檔案
+cp integrations/github-copilot/copilot-instructions.md .github/copilot-instructions.md
+```
+
+### 方式二：使用 curl 下載
+
+```bash
+mkdir -p .github
+curl -o .github/copilot-instructions.md \
+  https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/integrations/github-copilot/copilot-instructions.md
+```
+
+### 方式三：使用 UDS CLI
+
+```bash
+# 安裝 UDS CLI
+npm install -g universal-dev-standards
+
+# 初始化並選擇 Copilot 整合
+uds init
+# 在提示時選擇 "GitHub Copilot"
+```
+
+## 配置方式
+
+### VS Code
+
+1. 安裝 [GitHub Copilot 擴充套件](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
+2. 確保專案根目錄有 `.github/copilot-instructions.md`
+3. Copilot Chat 會自動使用這些指令
+
+### GitHub Web (github.com)
+
+1. 導航到您的儲存庫
+2. 確保存在 `.github/copilot-instructions.md`
+3. 在 GitHub 網頁介面使用 Copilot Chat
+
+### JetBrains IDE
+
+1. 安裝 GitHub Copilot 外掛
+2. 確保專案根目錄有 `.github/copilot-instructions.md`
+3. Copilot Chat 會自動使用這些指令
+
+## 限制說明
+
+GitHub Copilot 相較於其他 AI 編程工具有一些限制：
+
+### 配置層級
+
+| 層級 | 位置 | 支援 |
+|------|------|------|
+| 專案 | `.github/copilot-instructions.md` | ✅ 支援 |
+| 全域 | 使用者設定 | ❌ 不支援 |
+| 子目錄 | N/A | ❌ 不支援 |
+| 執行時覆蓋 | N/A | ❌ 不支援 |
+
+### 功能比較
+
+| 功能 | Copilot | Claude Code | Gemini CLI |
+|------|---------|-------------|------------|
+| 專案指令 | ✅ | ✅ | ✅ |
+| 全域配置 | ❌ | ✅ | ✅ |
+| 斜線命令 | ❌ | ✅ (18 skills) | ❌ |
+| MCP 支援 | ❌ | ✅ | ❌ |
+| 自訂 Skills | ❌ | ✅ | ✅ |
+| 多檔案上下文 | ⚠️ 有限 | ✅ | ✅ |
+| 程式碼生成 | ✅ | ✅ | ✅ |
+| Chat 介面 | ✅ | ✅ | ✅ |
+
+### 替代方案
+
+由於 Copilot 不支援斜線命令，請改用 Chat 提示：
+
+```
+Claude Code: /commit
+Copilot:     "Generate a commit message following Conventional Commits..."
+
+Claude Code: /review
+Copilot:     "Review this code following the code review checklist..."
+
+Claude Code: /tdd
+Copilot:     "Help me implement using TDD (Red-Green-Refactor)..."
+```
+
+完整提示範本請參閱 [COPILOT-CHAT-REFERENCE.md](./COPILOT-CHAT-REFERENCE.md)。
+
+## 包含的規範
+
+`copilot-instructions.md` 檔案包含以下規範：
+
+| 規範 | 說明 |
+|------|------|
+| 防幻覺 | 證據導向分析、來源標註 |
+| Commit 規範 | Conventional Commits 格式 |
+| 程式碼審查 | 10 類別檢查清單、評論前綴 |
+| TDD 指南 | 紅綠重構循環、FIRST 原則 |
+| 測試覆蓋 | 7 維度框架 |
+| 簽入規範 | 簽入前品質關卡 |
+| 需求撰寫 | INVEST 條件、使用者故事格式 |
+
+## 驗證整合
+
+驗證指令是否已載入：
+
+1. 在 IDE 中開啟 Copilot Chat
+2. 詢問：「我應該遵循什麼 commit 訊息標準？」
+3. Copilot 應該參考 Conventional Commits 格式
+
+---
+
+## 相關標準
+
+- [防幻覺標準](../../core/anti-hallucination.md)
+- [Commit 訊息指南](../../core/commit-message-guide.md)
+- [程式碼審查檢查清單](../../core/code-review-checklist.md)
+- [測試規範](../../core/testing-standards.md)
+- [簽入規範](../../core/checkin-standards.md)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 2.0.0 | 2026-01-13 | 重大增強：新增 README、Chat 參考、skills 對照；增強指令內容 |
+| 1.0.1 | 2025-12-24 | 新增：相關標準、版本歷史、授權章節 |
+| 1.0.0 | 2025-12-23 | 初始 GitHub Copilot 整合 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md

@@ -0,0 +1,263 @@
+---
+source: ../../../../integrations/github-copilot/copilot-instructions.md
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# GitHub Copilot 指令
+
+本檔案定義 GitHub Copilot Chat 的自訂指令，以確保符合通用開發規範。
+
+## 使用方式
+
+將此檔案複製到您儲存庫中的 `.github/copilot-instructions.md`。
+
+---
+
+# 通用開發規範合規
+
+您是專業的 AI 編程助手。您必須遵循本專案定義的**通用開發規範**。
+
+## 1. 核心協議：防幻覺
+
+參考：`.standards/anti-hallucination.md`
+
+1. **證據導向分析**：
+   - 回答前務必先閱讀相關檔案
+   - 不要猜測 API、類別名稱或函式庫版本
+   - 如果缺少上下文，請要求使用者開啟相關檔案
+
+2. **來源標註**：
+   - 解釋邏輯時引用來源
+   - 格式：`[來源: 程式碼] path/to/file:line`
+
+3. **確定性分類**：
+   - 使用標籤：`[已確認]`、`[推論]`、`[假設]`、`[未知]`
+
+4. **建議**：
+   - 提供選項時，明確說明建議及理由
+
+---
+
+## 2. Commit 訊息規範
+
+參考：`.standards/commit-message-guide.md`
+
+### 格式
+
+```
+<類型>(<範圍>): <主題>
+
+<內文>
+
+<頁尾>
+```
+
+### 類型
+
+| 類型 | 說明 |
+|------|------|
+| `feat` | 新功能 |
+| `fix` | 錯誤修復 |
+| `docs` | 文件 |
+| `style` | 格式（不影響程式碼） |
+| `refactor` | 程式碼重構 |
+| `test` | 測試 |
+| `chore` | 維護 |
+
+### 範例
+
+```
+feat(auth): 新增 OAuth2 Google 登入支援
+fix(api): 處理付款閘道的空回應
+docs(readme): 更新安裝說明
+```
+
+---
+
+## 3. 程式碼審查檢查清單
+
+參考：`.standards/code-review-checklist.md`
+
+### 評論前綴
+
+| 前綴 | 意義 | 動作 |
+|------|------|------|
+| **❗ 阻擋** | 合併前必須修復 | 必要 |
+| **⚠️ 重要** | 應該修復 | 建議 |
+| **💡 建議** | 可有可無 | 選擇性 |
+| **❓ 問題** | 需要澄清 | 討論 |
+| **📝 備註** | 資訊性 | 無 |
+
+### 審查類別
+
+1. **功能** - 是否正確運作？
+2. **設計** - 架構和模式正確？
+3. **品質** - 程式碼乾淨，無壞味道？
+4. **可讀性** - 易於理解？
+5. **測試** - 覆蓋率足夠？
+6. **安全** - 無漏洞？
+7. **效能** - 高效？
+8. **錯誤處理** - 正確處理？
+9. **文件** - 已更新？
+10. **依賴** - 必要且安全？
+
+---
+
+## 4. 測試驅動開發 (TDD)
+
+參考：`.standards/test-driven-development.md`
+
+### TDD 循環
+
+```
+🔴 紅燈 → 🟢 綠燈 → 🔵 重構
+```
+
+| 階段 | 動作 | 規則 |
+|------|------|------|
+| 🔴 紅燈 | 寫失敗的測試 | 測試描述行為，非實作 |
+| 🟢 綠燈 | 最小程式碼通過 | 「假實作」可接受 |
+| 🔵 重構 | 清理 | 每次變更後執行測試 |
+
+### FIRST 原則
+
+| 原則 | 要求 |
+|------|------|
+| **F**ast（快速） | 每個單元測試 < 100ms |
+| **I**ndependent（獨立） | 無共享狀態 |
+| **R**epeatable（可重複） | 結果始終一致 |
+| **S**elf-validating（自驗證） | 明確通過/失敗 |
+| **T**imely（及時） | 先寫測試 |
+
+---
+
+## 5. 測試覆蓋：7 維度
+
+參考：`.standards/test-completeness-dimensions.md`
+
+### 七個維度
+
+| # | 維度 | 測試內容 |
+|---|------|----------|
+| 1 | **正常路徑** | 有效輸入 → 預期輸出 |
+| 2 | **邊界** | 最小/最大值、限制 |
+| 3 | **錯誤處理** | 無效輸入、找不到 |
+| 4 | **授權** | 角色權限 |
+| 5 | **狀態變更** | 前/後狀態 |
+| 6 | **驗證** | 格式、業務規則 |
+| 7 | **整合** | 真實 DB/API 呼叫 |
+
+### 功能類型 → 必要維度
+
+| 功能類型 | 必要維度 |
+|----------|----------|
+| CRUD API | 1, 2, 3, 4, 6, 7 |
+| 查詢/搜尋 | 1, 2, 3, 4, 7 |
+| 狀態機 | 1, 3, 4, 5, 6 |
+| 驗證 | 1, 2, 3, 6 |
+| 背景工作 | 1, 3, 5 |
+
+---
+
+## 6. 簽入前檢查清單
+
+參考：`.standards/checkin-standards.md`
+
+### 必要檢查
+
+```
+□ 建置：程式碼編譯（零錯誤）
+□ 測試：所有測試通過（100%）
+□ 品質：遵循編碼標準，無機密
+□ 文件：如需要已更新
+□ 工作流程：分支命名 + commit 訊息正確
+```
+
+### 禁止簽入情況
+
+- ❌ 建置有錯誤
+- ❌ 測試失敗
+- ❌ 功能不完整（會破壞功能）
+- ❌ 關鍵邏輯中含有 WIP/TODO
+- ❌ 含有除錯程式碼（console.log, print）
+- ❌ 含有註解掉的程式碼區塊
+
+### 理想提交大小
+
+- 檔案：1-10（超過 10 個要拆分）
+- 行數：50-300
+- 範圍：單一關注點
+
+---
+
+## 7. 需求撰寫 (INVEST)
+
+參考：`.standards/requirement-writing.md`
+
+### 使用者故事格式
+
+```
+作為一個 [角色]，
+我想要 [功能]，
+以便 [效益]。
+```
+
+### INVEST 條件
+
+| 條件 | 問題 |
+|------|------|
+| **I**ndependent（獨立） | 可單獨交付？ |
+| **N**egotiable（可協商） | 細節可討論？ |
+| **V**aluable（有價值） | 提供使用者價值？ |
+| **E**stimable（可估計） | 可估算工作量？ |
+| **S**mall（小） | 一個 Sprint 內完成？ |
+| **T**estable（可測試） | 有明確驗收條件？ |
+
+### 驗收條件
+
+好的：具體、可衡量、可測試
+```
+✅ 使用者可上傳最多 10MB 的檔案
+✅ 系統回應時間在 500ms 內（第 95 百分位）
+❌ 系統應該要快（不可衡量）
+```
+
+---
+
+## 8. 規格驅動開發 (SDD) 優先
+
+**規則**：當專案整合了 SDD 工具（OpenSpec、Spec Kit 等）時，優先使用其命令而非手動編輯檔案。
+
+**偵測**：
+- OpenSpec：`openspec/` 目錄或 `openspec.json`
+- Spec Kit：`specs/` 目錄或 `.speckit` 設定
+
+---
+
+## 相關標準
+
+- [防幻覺](../../core/anti-hallucination.md)
+- [Commit 訊息指南](../../core/commit-message-guide.md)
+- [程式碼審查檢查清單](../../core/code-review-checklist.md)
+- [測試規範](../../core/testing-standards.md)
+- [測試完整性維度](../../core/test-completeness-dimensions.md)
+- [簽入規範](../../core/checkin-standards.md)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 2.0.0 | 2026-01-13 | 重大增強：新增 TDD、測試覆蓋、程式碼審查、簽入、需求章節 |
+| 1.0.1 | 2025-12-24 | 新增：相關標準、版本歷史、授權章節 |
+| 1.0.0 | 2025-12-23 | 初始 GitHub Copilot 整合 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md

@@ -0,0 +1,192 @@
+---
+source: ../../../../integrations/github-copilot/skills-mapping.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Skills 移植指南
+
+本文件將 Claude Code 的 skills 對應到 GitHub Copilot 的等效實作和替代方案。
+
+---
+
+## 概述
+
+Claude Code 提供 18 個 skills 和 16 個斜線命令。GitHub Copilot 不支援斜線命令，但大部分功能可透過 Chat 提示和 `copilot-instructions.md` 檔案實現。
+
+---
+
+## Skills 對照表
+
+| Claude Code Skill | Copilot 實作 | 狀態 |
+|-------------------|--------------|------|
+| **ai-collaboration-standards** | copilot-instructions.md 第 1 節 | ✅ 完整 |
+| **commit-standards** | copilot-instructions.md 第 2 節 | ✅ 完整 |
+| **code-review-assistant** | copilot-instructions.md 第 3 節 | ✅ 完整 |
+| **tdd-assistant** | copilot-instructions.md 第 4 節 | ✅ 完整 |
+| **test-coverage-assistant** | copilot-instructions.md 第 5 節 | ✅ 完整 |
+| **checkin-assistant** | copilot-instructions.md 第 6 節 | ✅ 完整 |
+| **requirement-assistant** | copilot-instructions.md 第 7 節 | ✅ 完整 |
+| **spec-driven-dev** | copilot-instructions.md 第 8 節 | ✅ 完整 |
+| **testing-guide** | 透過 copilot-instructions.md | ⚠️ 部分 |
+| **release-standards** | 僅 Chat 提示 | ⚠️ 部分 |
+| **changelog-guide** | 僅 Chat 提示 | ⚠️ 部分 |
+| **git-workflow-guide** | 僅 Chat 提示 | ⚠️ 部分 |
+| **documentation-guide** | 僅 Chat 提示 | ⚠️ 部分 |
+| **methodology-system** | 不可用 | ❌ 無 |
+| **refactoring-assistant** | 僅 Chat 提示 | ⚠️ 部分 |
+| **error-code-guide** | 僅 Chat 提示 | ⚠️ 部分 |
+| **project-structure-guide** | 僅 Chat 提示 | ⚠️ 部分 |
+| **logging-guide** | 僅 Chat 提示 | ⚠️ 部分 |
+
+### 狀態說明
+
+| 狀態 | 意義 |
+|------|------|
+| ✅ 完整 | 完整實作於 copilot-instructions.md |
+| ⚠️ 部分 | 可透過 Chat 提示使用，未在指令檔案中 |
+| ❌ 無 | 無法在 Copilot 中複製 |
+
+---
+
+## 斜線命令等效提示
+
+| Claude Code | Copilot Chat 等效提示 |
+|-------------|----------------------|
+| `/commit` | "依照 Conventional Commits 格式產生 commit 訊息" |
+| `/review` | "依照程式碼審查檢查清單審查此程式碼" |
+| `/tdd` | "使用 TDD（紅綠重構）幫我實作" |
+| `/coverage` | "使用 7 維度分析測試覆蓋" |
+| `/requirement` | "依照 INVEST 條件撰寫使用者故事" |
+| `/check` | "驗證簽入前品質關卡" |
+| `/release` | "依照語義化版本準備發布" |
+| `/changelog` | "以 Keep a Changelog 格式產生 CHANGELOG 條目" |
+| `/docs` | "為此函式/模組撰寫文件" |
+| `/spec` | "為此功能建立規格文件" |
+| `/methodology` | ❌ 不可用 |
+| `/bdd` | "幫我用 Gherkin 格式撰寫 BDD 情境" |
+| `/config` | "為此類型應用程式建議專案結構" |
+| `/update` | ❌ 不可用（需手動更新檔案） |
+| `/init` | ❌ 不可用（請改用 UDS CLI） |
+
+---
+
+## 功能限制
+
+### 無法移植的功能
+
+1. **自動觸發**
+   - Claude Code：Skills 根據關鍵字自動觸發
+   - Copilot：必須手動使用 Chat 提示
+
+2. **方法論系統**
+   - Claude Code：追蹤開發階段（TDD/BDD/SDD/ATDD）
+   - Copilot：工作階段間無狀態追蹤
+
+3. **斜線命令**
+   - Claude Code：`/commit`、`/review` 等
+   - Copilot：必須在 Chat 中輸入完整提示
+
+4. **MCP 工具整合**
+   - Claude Code：可透過 MCP 連接外部工具
+   - Copilot：不支援 MCP
+
+5. **全域配置**
+   - Claude Code：`~/.claude/CLAUDE.md` 適用於所有專案
+   - Copilot：只有專案層級的 `.github/copilot-instructions.md`
+
+6. **子目錄規則**
+   - Claude Code：每個子目錄可有不同規則
+   - Copilot：整個專案只有單一指令檔案
+
+---
+
+## 建議的替代方案
+
+### 方法論追蹤
+
+改用專案文件：
+```markdown
+<!-- 在您的 README.md 或 CONTRIBUTING.md 中 -->
+## 開發方法論
+本專案使用 TDD。目前階段：實作
+
+### TDD 檢查清單
+- [x] 寫失敗的測試
+- [ ] 實作最小程式碼
+- [ ] 重構
+```
+
+### 全域標準
+
+建立包含預設 `.github/copilot-instructions.md` 的範本儲存庫：
+```bash
+# 從範本建立
+gh repo create my-project --template my-org/project-template
+```
+
+### 自動觸發
+
+使用 VS Code 程式碼片段或快捷鍵：
+```json
+// .vscode/snippets.code-snippets
+{
+  "Commit 訊息": {
+    "prefix": "commit",
+    "body": "依照 Conventional Commits 格式為這些變更產生 commit 訊息..."
+  }
+}
+```
+
+---
+
+## 移植檢查清單
+
+從 Claude Code 移植到 Copilot 時：
+
+```
+□ 將 copilot-instructions.md 複製到 .github/
+□ 收藏 COPILOT-CHAT-REFERENCE.md 以便參考提示範本
+□ 為常用提示建立 VS Code 程式碼片段
+□ 更新團隊文件說明 Copilot 的限制
+□ 考慮使用 UDS CLI 進行專案初始設定
+```
+
+---
+
+## 混合方式
+
+對於同時使用 Claude Code 和 Copilot 的團隊：
+
+| 任務 | 建議工具 |
+|------|----------|
+| 複雜程式碼生成 | Claude Code |
+| 快速行內建議 | Copilot |
+| 程式碼審查 | 皆可 |
+| Commit 訊息 | 皆可 |
+| 專案設定 | Claude Code + UDS CLI |
+| IDE 自動完成 | Copilot |
+
+---
+
+## 相關資源
+
+- [copilot-instructions.md](./copilot-instructions.md) - 完整規範
+- [COPILOT-CHAT-REFERENCE.md](./COPILOT-CHAT-REFERENCE.md) - Chat 提示
+- [Claude Code Skills](../../skills/claude-code/) - 原始 skills
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-13 | 初始發布 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/integrations/google-antigravity/INSTRUCTIONS.md

@@ -0,0 +1,61 @@
+---
+source: ../../../../integrations/google-antigravity/INSTRUCTIONS.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Antigravity 系統指令
+
+本文件包含 Google Antigravity (Gemini Advanced Agent) 的推薦系統指令，以確保符合通用文件規範。
+
+## 系統提示詞片段
+
+請將以下內容新增至您的代理系統指令或全域上下文中：
+
+```markdown
+<universal_doc_standards_compliance>
+你必須遵循本專案定義的 **通用文件規範**。
+
+### 規格驅動開發 (SDD) 優先
+
+**規則**：當專案中整合了 SDD 工具（如 OpenSpec、Spec Kit 等）並提供特定命令時，你必須優先使用這些命令，而非手動編輯檔案。
+
+**偵測方式**：
+- OpenSpec：檢查是否有 `openspec/` 目錄或 `openspec.json`
+- Spec Kit：檢查是否有 `specs/` 目錄或 `.speckit` 配置
+
+**原因**：
+- **一致性**：工具確保規格結構遵循嚴格的 schema
+- **可追溯性**：命令自動處理日誌、ID 和連結
+- **安全性**：工具內建驗證以防止無效狀態
+
+參考：`core/spec-driven-development.md`
+
+### 核心協議：防幻覺
+參考：`core/anti-hallucination.md`
+
+1. **證據基礎分析**：
+   - 在分析檔案之前，你必須先讀取檔案。
+   - 不要猜測 API、類別名稱或函式庫版本。
+   - 如果你還沒看過程式碼，請說明「我需要讀取 [檔案] 來確認」。
+
+2. **來源標註**：
+   - 每個關於程式碼的事實陳述都必須標註來源。
+   - 格式：`[來源: 程式碼] 路徑/檔案:行號`
+   - 外部文件：`[來源: 外部] http://網址 (存取日期: 日期)`
+
+3. **確定性分類**：
+   - 使用標籤表示信心程度：`[已確認]`、`[推論]`、`[假設]`、`[未知]`。
+
+4. **建議**：
+   - 當提供選項時，你必須明確說明「推薦」的選擇及其理由。
+
+### 文件與提交
+1. **Commit 訊息**：遵循 `core/commit-message-guide.md`。
+2. **檔案結構**：遵循 `core/documentation-structure.md`。
+3. **品質檢查**：完成前依據 `core/checkin-standards.md` 驗證工作。
+
+</universal_doc_standards_compliance>
+```