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

package/bundled/locales/zh-CN/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-CN/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-CN/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/) 许可发布。