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

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

@@ -0,0 +1,67 @@
+---
+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 CLI 是一个 AI 驱动的终端编码助手。此集成帮助 Codex 理解您的项目并遵循开发规范。
+
+## 资源
+
+- **[AGENTS.md](./AGENTS.md)**（必要）：
+  项目级规则文件，Codex 会自动加载。
+
+## 配置层级
+
+OpenAI Codex CLI 支持多层配置：
+
+| 类型 | 文件位置 | 说明 |
+|------|---------|------|
+| 项目规则 | `AGENTS.md` | 项目根目录，自动加载 |
+| 全局规则 | `~/.codex/instructions.md` | 个人规则，适用所有项目 |
+
+## 快速开始
+
+### 方式一：复制规则文件（推荐）
+
+```bash
+# 复制到项目根目录
+cp integrations/codex/AGENTS.md AGENTS.md
+
+# 或使用 curl
+curl -o AGENTS.md https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/integrations/codex/AGENTS.md
+```
+
+### 方式二：手动配置
+
+将 `AGENTS.md` 的内容复制到您的 Codex 配置或系统指令中。
+
+---
+
+## 相关规范
+
+- [防幻觉规范](../../core/anti-hallucination.md)
+- [Commit 消息指南](../../core/commit-message-guide.md)
+- [代码审查清单](../../core/code-review-checklist.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-01-09 | 初始 OpenAI Codex 集成 |
+
+---
+
+## 许可证
+
+本文档以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。

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