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

package/bundled/locales/zh-CN/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-CN/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-CN/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-CN/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>
+```