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

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

@@ -0,0 +1,84 @@
+---
+source: ../../../../integrations/google-antigravity/README.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-13
+status: current
+---
+
+# Google Antigravity 整合
+
+本目錄提供將通用文件規範與 Google Antigravity 整合的資源。
+
+## 概述
+
+Google Antigravity 是一個先進的代理程式碼開發助理。此整合協助 Antigravity 代理利用通用文件規範來生成更高品質、無幻覺的程式碼與文件。
+
+## 資源
+
+- **[.antigravity/rules.md](../../../../integrations/google-antigravity/.antigravity/rules.md)**（推薦）：
+  專案級規則檔，Antigravity 會自動載入。
+
+- **[INSTRUCTIONS.md](./INSTRUCTIONS.md)**：
+  用於手動配置的系統提示詞片段。
+
+## 規則配置
+
+Google Antigravity 支援兩層規則配置：
+
+| 類型 | 檔案位置 | 說明 |
+|------|---------|------|
+| 全域規則 | `~/.gemini/GEMINI.md` | 適用於所有專案 |
+| 專案規則 | `.antigravity/rules.md` | 專案特定規則（自動載入） |
+
+## 快速開始
+
+### 方式一：專案規則（推薦）
+
+將專案規則檔複製到您的專案：
+
+```bash
+# 建立目錄並複製規則檔
+mkdir -p .antigravity
+cp integrations/google-antigravity/.antigravity/rules.md .antigravity/
+
+# 或使用 curl
+mkdir -p .antigravity
+curl -o .antigravity/rules.md https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/integrations/google-antigravity/.antigravity/rules.md
+```
+
+### 方式二：手動配置
+
+1. **安裝規範**：
+   確保 `core/` 規範已複製到您的專案（例如 `.standards/`）。
+
+2. **配置代理**：
+   將 `INSTRUCTIONS.md` 的內容複製到您的 Antigravity「使用者規則」或特定任務指令中。
+
+### 驗證合規性
+
+要求代理「遵循防幻覺標準審查此程式碼」。
+
+---
+
+## 相關標準
+
+- [防幻覺標準](../../core/anti-hallucination.md)
+- [Commit 訊息指南](../../core/commit-message-guide.md)
+- [INSTRUCTIONS.md](./INSTRUCTIONS.md)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.1.0 | 2026-01-09 | 新增：`.antigravity/rules.md` 專案規則檔、規則配置章節 |
+| 1.0.1 | 2025-12-24 | 新增：相關標準、版本歷史、授權章節 |
+| 1.0.0 | 2025-12-23 | 初始 Google Antigravity 整合 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md

@@ -0,0 +1,111 @@
+---
+source: ../../../../integrations/opencode/AGENTS.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-13
+status: current
+---
+
+# 通用開發標準
+
+本專案遵循通用文件規範，以確保高品質、無幻覺的程式碼與文件。
+
+---
+
+## 規格驅動開發 (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. 建議
+
+當提供選項時，你必須明確說明「推薦」的選擇及其理由。
+
+---
+
+## 文件與提交
+
+### Commit 訊息
+
+遵循 Conventional Commits 格式（參考：`core/commit-message-guide.md`）：
+
+```
+<類型>(<範圍>): <主題>
+
+<內文>
+
+<頁尾>
+```
+
+**類型**：feat、fix、docs、chore、test、refactor、style
+
+### 品質檢查
+
+完成前，依據 `core/checkin-standards.md` 驗證工作：
+- [ ] 程式碼編譯成功
+- [ ] 所有測試通過
+- [ ] 無硬編碼的秘密資訊
+- [ ] 如適用，已更新文件
+
+---
+
+## 程式碼審查標準
+
+參考：`core/code-review-checklist.md`
+
+審查程式碼時，檢查：
+1. **功能性** - 是否按預期運作？
+2. **安全性** - 無漏洞（OWASP Top 10）？
+3. **效能** - 演算法和查詢是否高效？
+4. **可維護性** - 程式碼是否整潔、易讀？
+5. **測試** - 測試覆蓋率是否足夠？
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-09 | 初始 OpenCode 整合 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。

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

@@ -0,0 +1,176 @@
+---
+source: ../../../../integrations/opencode/README.md
+source_version: 1.3.0
+translation_version: 1.3.0
+last_synced: 2026-01-13
+status: current
+---
+
+# OpenCode 整合
+
+本目錄提供將通用開發規範與 OpenCode 整合的資源。
+
+## 概述
+
+OpenCode 是開源 AI 編碼代理，可作為終端介面、桌面應用或 IDE 擴充。此整合協助 OpenCode 理解您的專案並遵循開發規範。
+
+## 資源
+
+- **[AGENTS.md](./AGENTS.md)**（必要）：
+  專案級規則檔，OpenCode 會自動載入。
+
+- **[skills-mapping.md](./skills-mapping.md)**（參考）：
+  將所有 18 個 Claude Code 技能對應到 OpenCode 等效方式。
+
+- **[opencode.json](../../../../integrations/opencode/opencode.json)**（可選）：
+  配置範例，包含權限設定和自訂 agent。
+
+## 配置層級
+
+OpenCode 支援多層配置：
+
+| 類型 | 檔案位置 | 說明 |
+|------|---------|------|
+| 專案規則 | `AGENTS.md` | 專案根目錄，自動載入 |
+| 全域規則 | `~/.config/opencode/AGENTS.md` | 個人規則，適用所有專案 |
+| 專案配置 | `opencode.json` | JSON 格式配置 |
+| 全域配置 | `~/.config/opencode/opencode.json` | 全域 JSON 配置 |
+| 自訂 Agent | `.opencode/agent/*.md` | 專案級 agent |
+| 全域 Agent | `~/.config/opencode/agent/*.md` | 全域 agent |
+
+## 快速開始
+
+### 方式一：複製規則檔（推薦）
+
+```bash
+# 複製到專案根目錄
+cp integrations/opencode/AGENTS.md AGENTS.md
+
+# 可選：複製配置檔
+cp integrations/opencode/opencode.json opencode.json
+```
+
+### 方式二：使用 curl
+
+```bash
+curl -o AGENTS.md https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/integrations/opencode/AGENTS.md
+```
+
+### 方式三：使用 /init（追加模式）
+
+```bash
+opencode
+/init
+```
+
+注意：`/init` 會**追加**到現有 AGENTS.md，而非覆蓋。
+
+### 方式四：使用 UDS CLI（推薦用於 Skills）
+
+```bash
+# 全域安裝 UDS CLI
+npm install -g universal-dev-standards
+
+# 初始化專案 - 選擇 OpenCode 作為 AI 工具
+uds init
+
+# Skills 將安裝到 .claude/skills/（OpenCode 會自動偵測）
+```
+
+**v3.5.0 新功能**：OpenCode 現在在 CLI 中被視為 skills 相容工具。
+當只選擇 OpenCode（或 Claude Code）時，將自動提供帶有 skills 的精簡安裝。
+
+使用 `uds check` 驗證安裝狀態和 skills 相容性。
+
+## 規則合併行為
+
+OpenCode 的規則合併機制：
+
+| 情況 | 行為 |
+|------|------|
+| `/init` 且已有 AGENTS.md | **追加**新內容，不覆蓋 |
+| 全域 + 專案規則同時存在 | **合併**兩者，專案規則優先 |
+| 配置檔（opencode.json） | **合併**，只有衝突的鍵才覆蓋 |
+
+## 配置選項
+
+### opencode.json
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "instructions": ["AGENTS.md", "CONTRIBUTING.md"],
+  "permission": {
+    "edit": "ask",
+    "bash": "ask"
+  },
+  "agent": {
+    "code-reviewer": {
+      "description": "Reviews code following standards",
+      "mode": "subagent",
+      "tools": {"write": false, "edit": false}
+    }
+  }
+}
+```
+
+**關鍵選項**：
+- `instructions`：引用額外規則檔（適用於 monorepo）
+- `permission`：編輯和 bash 指令需使用者確認
+- `agent`：定義具有特定能力的自訂 agent
+
+---
+
+## Skills 相容性
+
+OpenCode **完全相容** Claude Code 技能。所有 18 個 UDS 技能無需修改即可使用。
+
+### 配置對照
+
+| Claude Code | OpenCode |
+|-------------|----------|
+| `CLAUDE.md` | `AGENTS.md` |
+| `.claude/skills/` | `.opencode/skill/`（也讀取 `.claude/skills/`） |
+| `settings.json` | `opencode.json` |
+
+### 技能搜索順序
+
+OpenCode 按以下順序搜索技能：
+1. `.opencode/skill/<name>/SKILL.md`（專案）
+2. `~/.config/opencode/skill/<name>/SKILL.md`（全域）
+3. **`.claude/skills/<name>/SKILL.md`**（Claude 相容 ✅）
+
+### 快速驗證
+
+```bash
+# 在 OpenCode 中測試技能載入
+opencode
+/commit  # 應載入 commit-standards 技能
+```
+
+完整技能對照和安裝方法，請參閱 **[skills-mapping.md](./skills-mapping.md)**
+
+---
+
+## 相關標準
+
+- [防幻覺標準](../../core/anti-hallucination.md)
+- [Commit 訊息指南](../../core/commit-message-guide.md)
+- [程式碼審查清單](../../core/code-review-checklist.md)
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.3.0 | 2026-01-13 | 新增 UDS CLI 安裝選項；OpenCode 現在在 CLI 中支援 skills |
+| 1.2.0 | 2026-01-13 | 新增 skills-mapping.md；簡化 README |
+| 1.1.0 | 2026-01-13 | 新增 Claude Code 遷移指南 |
+| 1.0.0 | 2026-01-09 | 初始 OpenCode 整合 |
+
+---
+
+## 授權
+
+本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。