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

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

@@ -0,0 +1,113 @@
+---
+source: ../../../../integrations/codex/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# OpenAI Codex 整合
+
+本目錄提供將通用開發規範與 OpenAI Codex CLI 整合的資源。
+
+## 概述
+
+OpenAI Codex 是雲端 AI 編碼代理，可作為 CLI、IDE 擴充或網頁介面運行。它會在執行任務前讀取 AGENTS.md 檔案，方便自動執行專案規範。
+
+## 資源
+
+- **[AGENTS.md](./AGENTS.md)**（必要）：
+  專案級規則檔，Codex 會自動載入。
+
+- **[config.toml.example](../../../../integrations/codex/config.toml.example)**（可選）：
+  Codex 設定的配置範例。
+
+## 配置層級
+
+Codex 會依以下優先順序建立指令鏈：
+
+| 層級 | 檔案位置 | 說明 |
+|------|---------|------|
+| 全域覆蓋 | `~/.codex/AGENTS.override.md` | 臨時全域覆蓋 |
+| 全域預設 | `~/.codex/AGENTS.md` | 個人規則，適用所有專案 |
+| 專案根目錄 | `AGENTS.md` | 專案級規則 |
+| 子目錄 | `services/*/AGENTS.md` | 服務專屬規則 |
+| 子目錄覆蓋 | `services/*/AGENTS.override.md` | 臨時服務覆蓋 |
+
+**注意**：越接近工作目錄的檔案優先級越高。使用 `AGENTS.override.md` 進行臨時調整，無需修改基礎檔案。
+
+## 快速開始
+
+### 方式一：複製規則檔（推薦）
+
+```bash
+# 複製到專案根目錄
+cp integrations/codex/AGENTS.md AGENTS.md
+
+# 可選：設定全域配置
+mkdir -p ~/.codex
+cp integrations/codex/config.toml.example ~/.codex/config.toml
+```
+
+### 方式二：使用 curl
+
+```bash
+curl -o AGENTS.md https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/integrations/codex/AGENTS.md
+```
+
+### 方式三：驗證指令
+
+設定完成後，驗證 Codex 是否載入指令：
+
+```bash
+codex --ask-for-approval never "Summarize the current instructions."
+```
+
+## 配置選項
+
+### ~/.codex/config.toml
+
+```toml
+# 每個 AGENTS.md 檔案的最大位元組數（預設：32768）
+project_doc_max_bytes = 65536
+
+# AGENTS.md 不存在時的備用檔名
+project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]
+```
+
+**主要選項**：
+- `project_doc_max_bytes`：較大的指令檔可增加此值
+- `project_doc_fallback_filenames`：支援替代檔案名稱
+
+## 規則合併行為
+
+Codex 會從根目錄到工作目錄合併指令：
+
+| 情況 | 行為 |
+|------|------|
+| 全域 + 專案規則同時存在 | **合併**兩者，專案規則優先 |
+| 存在覆蓋檔案 | **取代**該層級的基礎檔案 |
+| 指令被截斷 | 提高 `project_doc_max_bytes` 或分散到子目錄 |
+
+---
+
+## 相關標準
+
+- [防幻覺標準](../../core/anti-hallucination.md)
+- [Commit 訊息指南](../../core/commit-message-guide.md)
+- [程式碼審查清單](../../core/code-review-checklist.md)
+- [規格驅動開發](../../core/spec-driven-development.md)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-09 | 初始 OpenAI Codex 整合 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md

@@ -0,0 +1,102 @@
+---
+source: ../../../../integrations/gemini-cli/GEMINI.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# 通用開發標準
+
+本專案遵循通用文件規範，以確保高品質、無幻覺的程式碼與文件。
+
+---
+
+## 規格驅動開發 (SDD) 優先
+
+**規則**：當專案中整合了 SDD 工具（如 OpenSpec、Spec Kit 等）並提供特定命令時（例如 `/openspec` 或 `/spec` 等斜線命令），你必須優先使用這些命令，而非手動編輯檔案。
+
+**偵測方式**：
+- 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. 建議
+
+當提供選項時，你必須明確說明「推薦」的選擇及其理由。
+
+---
+
+## 文件與提交
+
+### Commit 訊息
+
+遵循 Conventional Commits 格式（參考：`core/commit-message-guide.md`）：
+
+```
+<類型>(<範圍>): <主題>
+
+<內文>
+
+<頁尾>
+```
+
+**類型**：feat、fix、docs、chore、test、refactor、style
+
+### 檔案結構
+
+遵循文件結構指南（參考：`core/documentation-structure.md`）。
+
+### 品質檢查
+
+完成前，依據 `core/checkin-standards.md` 驗證工作：
+- [ ] 程式碼編譯成功
+- [ ] 所有測試通過
+- [ ] 無硬編碼的秘密資訊
+- [ ] 如適用，已更新文件
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-09 | 初始 Gemini CLI 指令檔案 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/integrations/gemini-cli/README.md

@@ -0,0 +1,140 @@
+---
+source: ../../../../integrations/gemini-cli/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Gemini CLI 整合
+
+本目錄提供將通用文件規範與 [Gemini CLI](https://geminicli.com/) 整合的資源。
+
+## 概述
+
+Gemini CLI 是 Google 的開源 AI 代理工具，將 Gemini 模型帶入終端環境。此整合協助 Gemini CLI 利用通用文件規範來生成更高品質、無幻覺的程式碼與文件。
+
+## 資源
+
+- **[GEMINI.md](./GEMINI.md)**（推薦）：
+  專案級指令檔案，Gemini CLI 會自動載入。
+
+- **[settings-example.json](../../../../integrations/gemini-cli/settings-example.json)**：
+  用於自訂 CLI 行為的設定範例檔案。
+
+## 配置層級
+
+Gemini CLI 支援分層配置系統：
+
+| 層級 | 檔案位置 | 說明 |
+|------|---------|------|
+| 全域 | `~/.gemini/GEMINI.md` | 適用於所有專案 |
+| 專案 | `./GEMINI.md` | 專案根目錄 |
+| 子目錄 | `./subdir/GEMINI.md` | 模組特定規則 |
+| 設定 | `.gemini/settings.json` | 行為配置 |
+
+## 快速開始
+
+### 方式一：專案指令（推薦）
+
+將指令檔案複製到專案根目錄：
+
+```bash
+# 將 GEMINI.md 複製到專案根目錄
+cp integrations/gemini-cli/GEMINI.md ./GEMINI.md
+
+# 或使用 curl
+curl -o GEMINI.md https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/integrations/gemini-cli/GEMINI.md
+```
+
+### 方式二：全域指令
+
+加入全域指令，適用於所有專案：
+
+```bash
+# 建立全域目錄（如果不存在）
+mkdir -p ~/.gemini
+
+# 附加或建立全域 GEMINI.md
+cat integrations/gemini-cli/GEMINI.md >> ~/.gemini/GEMINI.md
+```
+
+### 方式三：自訂設定
+
+複製設定範例以自訂 CLI 行為：
+
+```bash
+# 建立專案設定目錄
+mkdir -p .gemini
+
+# 複製設定範例
+cp integrations/gemini-cli/settings-example.json .gemini/settings.json
+```
+
+## 特殊功能
+
+### 模組化導入
+
+Gemini CLI 支援從其他檔案導入內容：
+
+```markdown
+# 在 GEMINI.md 中
+@./docs/coding-style.md
+@./docs/api-guidelines.md
+```
+
+### 記憶命令
+
+在執行時管理指令：
+
+- `/memory show` - 顯示目前指令
+- `/memory refresh` - 重新載入所有 GEMINI.md
+- `/memory add <text>` - 加入全域指令
+
+### 驗證指令
+
+確認標準已載入：
+
+```
+/memory show
+```
+
+要求代理確認：
+
+```
+遵循防幻覺標準審查此程式碼。
+```
+
+## 與 Google Antigravity 的關係
+
+兩個工具共用全域 `~/.gemini/` 目錄：
+
+| 工具 | 專案規則位置 | 共用 |
+|------|------------|------|
+| Gemini CLI | `./GEMINI.md` | `~/.gemini/GEMINI.md` |
+| Antigravity | `.antigravity/rules.md` | `~/.gemini/GEMINI.md` |
+
+兩者可共存，使用相同的全域配置。
+
+---
+
+## 相關標準
+
+- [防幻覺標準](../../core/anti-hallucination.md)
+- [Commit 訊息指南](../../core/commit-message-guide.md)
+- [規格驅動開發](../../core/spec-driven-development.md)
+- [Gemini CLI 官方文件](https://geminicli.com/docs/)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-09 | 初始 Gemini CLI 整合 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md

@@ -0,0 +1,269 @@
+---
+source: ../../../../integrations/github-copilot/COPILOT-CHAT-REFERENCE.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Copilot Chat 參考指南
+
+本文件提供 GitHub Copilot Chat 的提示範本，以實現類似 Claude Code 斜線命令的功能。
+
+---
+
+## 為什麼需要這份文件？
+
+GitHub Copilot 不支援像 Claude Code 那樣的斜線命令。此參考提供標準化提示，讓您在 Copilot Chat 中實現類似效果。
+
+---
+
+## 提示範本
+
+### 1. 產生 Commit 訊息
+
+**Claude Code**：`/commit`
+
+**Copilot Chat 提示**：
+```
+為這些變更產生 commit 訊息，遵循 Conventional Commits 格式：
+- 類型：feat, fix, docs, style, refactor, test 或 chore
+- 格式：type(scope): description
+- 主題行保持在 50 字元以內
+```
+
+**範例**：
+```
+為我剛才對認證模組的變更產生 commit 訊息。
+使用 Conventional Commits 格式：type(scope): description
+```
+
+---
+
+### 2. 程式碼審查
+
+**Claude Code**：`/review`
+
+**Copilot Chat 提示**：
+```
+依照程式碼審查檢查清單審查此程式碼：
+
+1. 功能 - 是否正確運作？
+2. 設計 - 架構正確？
+3. 品質 - 程式碼乾淨，無壞味道？
+4. 安全 - 無漏洞？
+5. 測試 - 覆蓋率足夠？
+6. 效能 - 高效？
+
+使用這些評論前綴：
+- ❗ 阻擋：必須修復
+- ⚠️ 重要：應該修復
+- 💡 建議：可有可無
+- ❓ 問題：需要澄清
+```
+
+---
+
+### 3. TDD 指導
+
+**Claude Code**：`/tdd`
+
+**Copilot Chat 提示**：
+```
+使用 TDD（測試驅動開發）幫我實作 [功能]：
+
+1. 紅燈：先寫失敗的測試
+   - 測試應描述行為，非實作
+   - 使用 AAA 模式（Arrange-Act-Assert）
+
+2. 綠燈：寫最小程式碼通過測試
+   - 「假實作」可接受
+   - 不要過度設計
+
+3. 重構：保持測試通過的同時清理程式碼
+   - 每次變更後執行測試
+
+遵循 FIRST 原則：快速、獨立、可重複、自驗證、及時
+```
+
+---
+
+### 4. 測試覆蓋分析
+
+**Claude Code**：`/coverage`
+
+**Copilot Chat 提示**：
+```
+使用 7 維度分析 [功能] 的測試覆蓋：
+
+1. 正常路徑 - 正常預期行為
+2. 邊界 - 最小/最大值、限制
+3. 錯誤處理 - 無效輸入、例外
+4. 授權 - 角色存取控制
+5. 狀態變更 - 前/後驗證
+6. 驗證 - 格式、業務規則
+7. 整合 - 真實 DB/API 查詢
+
+哪些維度缺失？我應該新增什麼測試？
+```
+
+---
+
+### 5. 需求撰寫
+
+**Claude Code**：`/requirement`
+
+**Copilot Chat 提示**：
+```
+幫我依照 INVEST 條件撰寫使用者故事：
+
+格式：
+作為一個 [角色]，
+我想要 [功能]，
+以便 [效益]。
+
+INVEST 檢查清單：
+- 獨立：可單獨交付？
+- 可協商：細節可討論？
+- 有價值：提供使用者價值？
+- 可估計：可估算工作量？
+- 小：一個 Sprint 內完成？
+- 可測試：有明確驗收條件？
+
+包含具體、可衡量的驗收條件。
+```
+
+---
+
+### 6. 簽入前檢查
+
+**Claude Code**：`/check`
+
+**Copilot Chat 提示**：
+```
+在我提交前，驗證這些品質關卡：
+
+□ 建置：程式碼編譯無錯誤？
+□ 測試：所有測試通過？
+□ 品質：程式碼遵循標準？有機密嗎？
+□ 文件：已更新文件？
+□ 工作流程：分支命名和 commit 訊息正確？
+
+如果有以下情況，我不應該提交：
+- 建置錯誤
+- 測試失敗
+- 功能不完整
+- 含有除錯程式碼（console.log）
+- 含有註解掉的程式碼
+```
+
+---
+
+### 7. 發布準備
+
+**Claude Code**：`/release`
+
+**Copilot Chat 提示**：
+```
+幫我依照語義化版本準備發布：
+
+版本格式：MAJOR.MINOR.PATCH
+- MAJOR：破壞性變更
+- MINOR：新功能（向後相容）
+- PATCH：錯誤修復
+
+任務：
+1. 這應該是什麼版本？
+2. 產生 CHANGELOG 條目，包含：
+   - Added：新功能
+   - Changed：既有功能變更
+   - Fixed：錯誤修復
+   - Deprecated：即將移除的功能
+   - Removed：已移除的功能
+   - Security：安全修復
+```
+
+---
+
+### 8. 文件撰寫
+
+**Claude Code**：`/docs`
+
+**Copilot Chat 提示**：
+```
+幫我為這個 [函式/模組/API] 撰寫文件：
+
+包含：
+1. 目的 - 它做什麼？
+2. 參數 - 輸入參數與型別
+3. 回傳值 - 它回傳什麼
+4. 範例 - 使用範例
+5. 錯誤 - 可能的錯誤情況
+6. 相關 - 相關函式/模組
+```
+
+---
+
+## 快速參考卡
+
+| 任務 | Copilot Chat 提示開頭 |
+|------|----------------------|
+| Commit | "產生 commit 訊息，遵循 Conventional Commits..." |
+| 審查 | "依照檢查清單審查此程式碼..." |
+| TDD | "使用 TDD 幫我實作..." |
+| 覆蓋 | "使用 7 維度分析測試覆蓋..." |
+| 需求 | "依照 INVEST 撰寫使用者故事..." |
+| 簽入前 | "在提交前驗證這些品質關卡..." |
+| 發布 | "依照語義化版本準備發布..." |
+| 文件 | "為此撰寫文件..." |
+
+---
+
+## 最佳實踐
+
+### 1. 具體明確
+
+```
+❌ "審查此程式碼"
+✅ "審查此認證模組的安全漏洞和測試覆蓋"
+```
+
+### 2. 提供上下文
+
+```
+❌ "寫測試"
+✅ "為 calculateDiscount 函式寫單元測試，涵蓋邊界值和錯誤情況"
+```
+
+### 3. 參考標準
+
+```
+"遵循專案的防幻覺標準，先閱讀實際程式碼再驗證你的建議"
+```
+
+### 4. 要求說明理由
+
+```
+"用 [已確認] 或 [假設] 標籤解釋你為什麼做這個建議"
+```
+
+---
+
+## 相關資源
+
+- [copilot-instructions.md](./copilot-instructions.md) - 完整規範參考
+- [skills-mapping.md](./skills-mapping.md) - Claude Code skills 對照
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-13 | 初始發布 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。