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

package/bundled/locales/zh-CN/core/testing-standards.md

@@ -0,0 +1,170 @@
+---
+source: ../../../core/testing-standards.md
+source_version: 2.1.0
+translation_version: 2.1.0
+last_synced: 2026-01-08
+status: current
+---
+
+> **语言**: [English](../../../core/testing-standards.md) | [简体中文](../../zh-TW/core/testing-standards.md) | 简体中文
+
+# 测试标准
+
+**版本**: 1.0.0
+**最后更新**: 2025-12-30
+**适用范围**: 所有需要自动化测试的软件项目
+
+---
+
+## 目的
+
+本标准定义测试策略和最佳实践，确保代码质量和可维护性。
+
+---
+
+## 测试金字塔
+
+### 框架选项
+
+根据项目需求选择测试框架：
+
+| 框架 | 最适合 | 级别 |
+|------|-------|------|
+| ISTQB 标准 | 企业项目、认证需求、正式 QA 流程 | 4 级 |
+| 业界金字塔 | 敏捷开发、CI/CD 优化、快速迭代 | 3 级 |
+
+### 业界金字塔（默认）
+
+```
+        /\
+       /  \        E2E 测试 (10%)
+      /----\
+     /      \      集成测试 (20%)
+    /--------\
+   /          \    单元测试 (70%)
+  /------------\
+```
+
+| 级别 | 缩写 | 比例 | 范围 | 速度 |
+|------|-----|------|------|------|
+| 单元测试 | UT | 70% | 单一函数/方法 | <100ms |
+| 集成测试 | IT/SIT* | 20% | 多个组件 | <1s |
+| 端到端测试 | E2E | 10% | 用户流程 | >10s |
+
+*注：IT（敏捷/DevOps）或 SIT（企业/ISTQB）- 两者都指集成测试
+
+### ISTQB 标准框架
+
+| 级别 | 缩写 | 说明 | 负责人 |
+|------|-----|------|-------|
+| 单元测试 | UT | 验证代码单元 | 开发者 |
+| 集成测试 | IT/SIT | 验证组件交互 | 开发者/QA |
+| 系统测试 | ST | 验证系统符合需求规格 | QA |
+| 验收测试 | AT/UAT | 验证系统符合业务需求 | 用户/业务方 |
+
+---
+
+## FIRST 原则
+
+| 原则 | 说明 |
+|------|------|
+| **F**ast | 测试执行要快 |
+| **I**ndependent | 测试之间相互独立 |
+| **R**epeatable | 每次执行结果一致 |
+| **S**elf-validating | 自动判断通过/失败 |
+| **T**imely | 及时编写测试 |
+
+---
+
+## 测试结构
+
+### AAA 模式
+
+```javascript
+describe('UserService', () => {
+  it('should return user when valid id provided', () => {
+    // Arrange（准备）
+    const userId = 1;
+    const expectedUser = { id: 1, name: 'John' };
+
+    // Act（执行）
+    const result = userService.getUser(userId);
+
+    // Assert（断言）
+    expect(result).toEqual(expectedUser);
+  });
+});
+```
+
+### 命名规范
+
+```
+should_<expected behavior>_when_<condition>
+test_<method>_<condition>_<expected result>
+```
+
+**好的示例**:
+- `should_return_user_when_valid_id_provided`
+- `test_login_fails_with_invalid_credentials`
+
+**差的示例**:
+- `test1`
+- `testLogin`
+
+---
+
+## 测试替身
+
+| 类型 | 用途 | 使用场景 |
+|------|------|---------|
+| Stub | 返回预设响应 | 简单依赖 |
+| Mock | 验证交互 | 复杂依赖 |
+| Fake | 工作中的实现 | 数据库/外部服务 |
+| Spy | 记录调用 | 验证行为 |
+| Dummy | 填充参数 | 未使用的参数 |
+
+---
+
+## 覆盖率指标
+
+| 指标 | 最低要求 | 建议目标 |
+|------|---------|---------|
+| 语句覆盖率 | 70% | 80% |
+| 分支覆盖率 | 60% | 75% |
+| 函数覆盖率 | 80% | 90% |
+
+---
+
+## 快速参考卡
+
+### 测试类型选择
+
+| 测试什么？ | 使用类型 |
+|-----------|---------|
+| 单一函数逻辑 | 单元测试 |
+| 组件间交互 | 集成测试 |
+| 完整用户流程 | E2E 测试 |
+| 安全漏洞 | 安全测试 |
+| 性能瓶颈 | 性能测试 |
+| API 契约 | 契约测试 |
+
+### 检查清单
+
+- [ ] 遵循测试金字塔比例
+- [ ] 使用 AAA 模式
+- [ ] 测试名称具描述性
+- [ ] 测试相互独立
+- [ ] 覆盖边界条件
+
+---
+
+## 相关标准
+
+- [代码审查指南](code-review-guide.md)
+- [测试完整性维度](test-completeness-dimensions.md)
+
+---
+
+## 许可证
+
+本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。

package/bundled/locales/zh-CN/core/versioning.md

@@ -0,0 +1,177 @@
+---
+source: ../../../core/versioning.md
+source_version: 1.2.0
+translation_version: 1.2.0
+last_synced: 2026-01-08
+status: current
+---
+
+> **语言**: [English](../../../core/versioning.md) | [简体中文](../zh-TW/core/versioning.md) | 简体中文
+
+# 语义化版本标准
+
+**版本**: 1.0.0
+**最后更新**: 2025-12-30
+**适用范围**: 所有有版本发布的软件项目
+
+---
+
+## 目的
+
+本标准定义如何使用语义化版本 (SemVer) 为软件发布编号，以清楚地向用户和维护者传达变更。
+
+---
+
+## 语义化版本格式
+
+```
+MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
+
+示例:
+2.3.1
+1.0.0-alpha.1
+3.2.0-beta.2+20250112
+```
+
+### 组成说明
+
+| 组成 | 用途 | 递增时机 |
+|------|------|---------|
+| **MAJOR** | 破坏性变更 | 不兼容的 API 变更 |
+| **MINOR** | 新功能 | 向后兼容的功能 |
+| **PATCH** | 错误修复 | 向后兼容的修复 |
+| **PRERELEASE** | 预发布标识 | Alpha、Beta、RC 版本 |
+| **BUILD** | 构建元数据 | 构建号、提交哈希 |
+
+---
+
+## 递增规则
+
+### MAJOR 版本 (X.0.0)
+
+**递增时机**:
+- 破坏性 API 变更
+- 移除已弃用功能
+- 重大架构变更
+- 不兼容的行为变更
+
+### MINOR 版本 (x.Y.0)
+
+**递增时机**:
+- 添加新功能（向后兼容）
+- 弃用功能（非移除）
+- 实质性内部改进
+- 新的公开 API
+
+### PATCH 版本 (x.y.Z)
+
+**递增时机**:
+- 错误修复（无新功能）
+- 安全补丁
+- 文档更正
+- 内部重构（无 API 变更）
+
+---
+
+## API 版本化策略
+
+| 策略 | 格式 | 优点 | 缺点 |
+|------|------|------|------|
+| URL 路径 | `/api/v1/users` | 清晰、易于路由 | URL 污染 |
+| 查询参数 | `/api/users?version=1` | 可选版本 | 缓存问题 |
+| 标头 | `Accept: application/vnd.api.v1+json` | URL 干净 | 不可见 |
+
+**推荐**: 大多数 API 使用 URL 路径版本化。
+
+---
+
+## 弃用时间线
+
+```
+v1.0.0 - 功能引入
+v1.5.0 - 添加弃用警告（至少 N-1 版本）
+v2.0.0 - 移除功能（记录在迁移指南中）
+```
+
+### 弃用期限指南
+
+| API 类型 | 最短弃用期限 |
+|----------|-------------|
+| 内部 API | 1 个次要版本 |
+| 合作伙伴 API | 2 个次要版本 + 3 个月 |
+| 公开 API | 2 个次要版本 + 6 个月 |
+| 关键基础设施 | 最少 1 年 |
+
+---
+
+## 向后兼容性检查清单
+
+**不要破坏（不升级主版本号）**:
+- [ ] 移除公开 API 端点
+- [ ] 移除必填请求字段
+- [ ] 添加必填请求字段
+- [ ] 更改响应字段类型
+- [ ] 更改错误码含义
+
+**安全变更（次要/补丁版本）**:
+- [ ] 添加可选请求字段
+- [ ] 添加新响应字段
+- [ ] 添加新端点
+- [ ] 添加新错误码
+- [ ] 改进错误消息
+
+---
+
+## 预发布版本
+
+### 预发布标识符
+
+| 标识符 | 用途 | 稳定性 | 受众 |
+|-------|------|-------|-----|
+| alpha | 早期测试 | 不稳定 | 内部团队 |
+| beta | 功能完成 | 基本稳定 | 早期采用者 |
+| rc | 最终测试 | 稳定 | Beta 测试者 |
+
+### 示例
+
+```
+1.0.0-alpha.1       # 第一个 alpha 版本
+1.0.0-beta.1        # 第一个 beta 版本
+1.0.0-rc.1          # 候选版本 1
+1.0.0               # 稳定版本
+```
+
+---
+
+## 快速参考卡
+
+### 版本递增
+
+| 做了什么？ | 递增 |
+|-----------|-----|
+| 破坏性变更 | MAJOR |
+| 新功能 | MINOR |
+| 错误修复 | PATCH |
+
+### 版本格式
+
+```
+MAJOR.MINOR.PATCH
+  │     │     └── 错误修复
+  │     └──────── 新功能
+  └────────────── 破坏性变更
+```
+
+---
+
+## 相关标准
+
+- [变更日志标准](changelog-standards.md)
+- [Git 工作流程](git-workflow.md)
+- [提交消息指南](commit-message-guide.md)
+
+---
+
+## 许可证
+
+本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。

package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md

@@ -0,0 +1,303 @@
+# AI Agent 集成指南
+
+> **语言**: [English](../../../docs/AI-AGENT-ROADMAP.md) | [繁體中文](../../zh-TW/docs/AI-AGENT-ROADMAP.md) | 简体中文
+
+**版本**: 2.2.0
+**最后更新**: 2026-01-15
+
+本文档提供 Universal Development Standards (UDS) 对 AI Agent 支持的完整参考。
+
+---
+
+## 目录
+
+1. [快速参考](#1-快速参考)
+2. [集成深度](#2-集成深度)
+3. [Skills 系统](#3-skills-系统)
+4. [配置参考](#4-配置参考)
+5. [资源](#5-资源)
+6. [附录：未来发展](#附录未来发展)
+
+---
+
+## 1. 快速参考
+
+### 配置文件
+
+| AI Agent | 项目配置 | 全局配置 | 备注 |
+|----------|----------|----------|------|
+| Claude Code | `.claude/CLAUDE.md` | `~/.claude/CLAUDE.md` | ~100KB 限制 |
+| OpenCode | `.opencode/AGENTS.md` | `~/.config/opencode/AGENTS.md` | 无限制 |
+| GitHub Copilot | `.github/copilot-instructions.md` | 个人设置 | ~8KB 限制 |
+| Cline | `.clinerules/` | `~/.cline-rules/` | 文件夹或单一文件 |
+| Roo Code | `.roo/rules/*.md` | `~/.roo/rules/` | 模式特定：`.roo/rules-{mode}/` |
+| OpenAI Codex | `.codex/AGENTS.md` | `~/.codex/AGENTS.md` | 32KB 限制 |
+| Windsurf | `.windsurfrules` | 设置 UI | 6K/文件，总计 12K |
+| Gemini CLI | `.gemini/GEMINI.md` | `~/.gemini/GEMINI.md` | 支持 `@import` |
+| Cursor | `.cursor/rules/*.mdc` | `~/.cursor/rules/` | 需要 YAML frontmatter |
+
+### Skills 路径
+
+| AI Agent | Skills | 项目路径 | 全局路径 | 备注 |
+|----------|:------:|----------|----------|------|
+| Claude Code | ✅ 原生 | `.claude/skills/` | `~/.claude/skills/` | 参考实现 |
+| OpenCode | ✅ 完整 | `.opencode/skill/` | `~/.config/opencode/skill/` | 也读取 `.claude/skills/` |
+| GitHub Copilot | ✅ 完整 | `.github/skills/` | `~/.copilot/skills/` | 旧版：`.claude/skills/` |
+| Cline | ✅ 完整 | `.claude/skills/` | `~/.claude/skills/` | 直接使用 Claude 路径 |
+| Roo Code | ✅ 完整 | `.roo/skills/` | `~/.roo/skills/` | 模式特定：`.roo/skills-{mode}/` |
+| OpenAI Codex | ✅ 完整 | `.codex/skills/` | `~/.codex/skills/` | 也读取 `.claude/skills/` |
+| Windsurf | ✅ 完整 | `.windsurf/rules/` | 设置 UI | 2026/01 起支持 Skills |
+| Gemini CLI | ✅ 预览 | `.gemini/skills/` | `~/.gemini/skills/` | v0.23+ 预览版 |
+| Cursor | ❌ 否 | `.cursor/rules/` | `~/.cursor/rules/` | 仅 Rules，不支持 SKILL.md |
+
+### 斜杠命令
+
+| AI Agent | 支持 | 类型 | 示例 | 自定义路径 |
+|----------|:----:|------|------|------------|
+| Claude Code | ✅ | Skill 触发 | `/commit`, `/review`, `/tdd` | 仅内建 |
+| OpenCode | ✅ | 用户定义 | 可配置 | `.opencode/command/*.md` |
+| GitHub Copilot | ✅ | 内建 | `/fix`, `/tests`, `/explain` | `.github/prompts/*.prompt.md` |
+| Cline | ✅ | 内建 + Workflows | `/smol`, `/plan`, `/newtask` | Workflow 文件 |
+| Roo Code | ✅ | 模式命令 | `/code`, `/architect`, `/init` | `.roo/commands/*.md` |
+| OpenAI Codex | ✅ | 系统命令 | `/model`, `/diff`, `/skills` | 自定义 prompts |
+| Windsurf | ✅ | Rulebook | 自动生成 | 从 `.windsurfrules` |
+| Gemini CLI | ✅ | 系统 + 自定义 | `/clear`, `/memory`, `/mcp` | `.gemini/commands/*.toml` |
+| Cursor | ✅ | 内建 + 自定义 | `/summarize`, `/models` | `.cursor/commands/*.md` |
+
+### 平台支持
+
+| 平台 | CLI 工具 | Skills |
+|------|:--------:|:------:|
+| macOS | 已测试 | 已测试 |
+| Linux | 预期可用 | 预期可用 |
+| Windows | 提供 PowerShell | 预期可用 |
+
+---
+
+## 2. 集成深度
+
+> **说明**: 截至 2026 年 1 月，Agent Skills (SKILL.md) 已成为业界标准。大多数主流 AI 代码工具现在都支持相同的 Skills 格式。
+
+### 原生 Skills（参考实现）
+
+**工具**: Claude Code
+
+- Agent Skills 标准的参考实现
+- 18 个内建 UDS Skills + Marketplace
+- 完整斜杠命令支持（`/commit`、`/review`、`/tdd` 等）
+- 关键字自动触发
+
+### 完整 Skills 支持
+
+**工具**: OpenCode, GitHub Copilot, Cline, Roo Code, OpenAI Codex, Windsurf, Gemini CLI
+
+- 可读取并执行 SKILL.md 文件
+- 跨平台兼容 `.claude/skills/` 目录
+- 大多数工具也有自己的原生路径（见 Skills 路径栏）
+
+### 仅 Rules（无 Skills）
+
+**工具**: Cursor
+
+- 有自己的规则格式（`.cursor/rules/*.mdc`）
+- 尚未支持 SKILL.md 格式
+- 社区已提出功能请求
+
+---
+
+## 3. Skills 系统
+
+### 3.1 UDS Skills 兼容性
+
+| # | Skill | 斜杠命令 | Claude | OpenCode | Cursor | Copilot |
+|---|-------|----------|:------:|:--------:|:------:|:-------:|
+| 1 | ai-collaboration-standards | - | 完整 | 完整 | 完整 | 完整 |
+| 2 | checkin-assistant | `/check` | 完整 | 完整 | 部分 | 部分 |
+| 3 | commit-standards | `/commit` | 完整 | 完整 | 部分 | 部分 |
+| 4 | code-review-assistant | `/review` | 完整 | 完整 | 部分 | 部分 |
+| 5 | testing-guide | - | 完整 | 完整 | 完整 | 完整 |
+| 6 | tdd-assistant | `/tdd` | 完整 | 完整 | 部分 | 部分 |
+| 7 | release-standards | `/release` | 完整 | 完整 | 部分 | 无 |
+| 8 | git-workflow-guide | - | 完整 | 完整 | 完整 | 完整 |
+| 9 | documentation-guide | `/docs` | 完整 | 完整 | 部分 | 无 |
+| 10 | requirement-assistant | `/requirement` | 完整 | 完整 | 部分 | 部分 |
+| 11 | changelog-guide | `/changelog` | 完整 | 完整 | 部分 | 无 |
+| 12 | spec-driven-dev | `/spec` | 完整 | 完整 | 部分 | 部分 |
+| 13 | test-coverage-assistant | `/coverage` | 完整 | 完整 | 部分 | 部分 |
+| 14 | refactoring-assistant | - | 完整 | 完整 | 完整 | 完整 |
+| 15 | error-code-guide | - | 完整 | 完整 | 完整 | 完整 |
+| 16 | methodology-system | `/methodology` | 完整 | 完整 | 部分 | 无 |
+| 17 | project-structure-guide | `/config` | 完整 | 完整 | 部分 | 无 |
+| 18 | logging-guide | - | 完整 | 完整 | 完整 | 完整 |
+
+### 3.2 Skills 路径与启用
+
+#### Skills 发现路径
+
+| AI Agent | 项目路径 | 全局路径 | 读取 `.claude/skills/` |
+|----------|----------|----------|:----------------------:|
+| Claude Code | `.claude/skills/` | `~/.claude/skills/` | 原生 |
+| OpenCode | `.opencode/skill/` | `~/.config/opencode/skill/` | ✅ 是 |
+| GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` | ✅ 是（旧版） |
+| Cline | `.claude/skills/` | `~/.claude/skills/` | ✅ 是 |
+| Roo Code | `.roo/skills/` | `~/.roo/skills/` | ✅ 是 |
+| OpenAI Codex | `.codex/skills/` | `~/.codex/skills/` | ✅ 是 |
+| Windsurf | `.windsurf/rules/` | 设置 UI | ✅ 是 |
+| Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` | ✅ 是 |
+| Cursor | `.cursor/rules/` | `~/.cursor/rules/` | ❌ 否 |
+
+#### 启用方式
+
+| AI Agent | 启用方式 |
+|----------|----------|
+| Claude Code | 斜杠命令、自动触发、提及 |
+| OpenCode | 斜杠命令、Tab 切换 |
+| GitHub Copilot | 自动加载、`applyTo` 模式 |
+| Cline | 自动从目录加载 |
+| Roo Code | 自动加载、模式特定（`.roo/skills-{mode}/`） |
+| OpenAI Codex | `/skills` 命令、自动触发 |
+| Windsurf | 手动（@提及）、始终开启、模型决定 |
+| Gemini CLI | 自动触发、通过设置启用/禁用 |
+| Cursor | Glob 模式、`alwaysApply` 标志（仅 rules） |
+
+**建议**：使用 `.claude/skills/` 作为默认安装路径 — 大多数工具都可读取以获得跨工具兼容性。
+
+### 3.3 跨平台可移植性
+
+> **业界标准**: 截至 2025 年 12 月，SKILL.md 已被 OpenAI、GitHub、Google 及更广泛的 AI 代码生态系统采用。
+
+| 平台 | SKILL.md 支持 | 采用日期 |
+|------|:-------------:|----------|
+| Claude Code | ✅ 原生 | 2025/10 |
+| OpenCode | ✅ 完整 | 2025/11 |
+| GitHub Copilot | ✅ 完整 | 2025/12/18 |
+| OpenAI Codex | ✅ 完整 | 2025/12 |
+| Cline | ✅ 完整 | v3.48.0 |
+| Roo Code | ✅ 完整 | 2025/12/27 |
+| Windsurf | ✅ 完整 | 2026/01/09 |
+| Gemini CLI | ✅ 预览版 | 2026/01/07 |
+| Cursor | ❌ 尚未 | 已请求 |
+
+**跨平台安装器**:
+- [skilz](https://github.com/skilz-ai/skilz) - 通用 Skills 安装器（14+ 平台）
+- [openskills](https://github.com/numman-ali/openskills) - 通用 skills 加载器
+- UDS CLI (`uds init`) - 为多个 AI 工具生成配置
+
+---
+
+## 4. 配置参考
+
+### 4.1 配置文件
+
+| AI Agent | 项目配置 | 全局配置 | 字符限制 |
+|----------|----------|----------|----------|
+| Claude Code | `CLAUDE.md` | `~/.claude/CLAUDE.md` | ~100KB |
+| OpenCode | `AGENTS.md` | `~/.config/opencode/AGENTS.md` | 无限制 |
+| Cursor | `.cursor/rules/*.mdc` | `~/.cursor/rules/` | 每文件不同 |
+| Windsurf | `.windsurfrules` | 设置 UI | 6K/文件，总计 12K |
+| Cline | `.clinerules` | `~/.cline-rules/` | 无限制 |
+| Roo Code | `.roorules` | `~/.roo/rules/` | 无限制 |
+| GitHub Copilot | `.github/copilot-instructions.md` | 个人设置 | ~8KB |
+| OpenAI Codex | `AGENTS.md` | `~/.codex/AGENTS.md` | 32KB |
+| Gemini CLI | `GEMINI.md` | `~/.gemini/GEMINI.md` | 1M tokens |
+
+### 4.2 配置合并行为
+
+| AI Agent | 合并策略 | 优先顺序（高到低） |
+|----------|----------|-------------------|
+| Claude Code | 串接 | 目录范围 > 项目 > 个人 |
+| OpenCode | 串接 | 项目 > 全局 |
+| Cursor | 替换/选择性 | `.mdc` 按 glob，alwaysApply 标志 |
+| Windsurf | 达限制时截断 | 全局 > 工作区 > 模式特定 |
+| Cline | 附加 | 项目目录 > 根文件 |
+| GitHub Copilot | 组合 | 个人 > 仓库 > 组织 |
+| OpenAI Codex | 串接 | 覆盖文件 > 基础，较近者优先 |
+| Gemini CLI | 串接 | 所有文件支持 `@import` |
+
+### 4.3 Skills 文件格式
+
+> **标准格式**: 带有 YAML frontmatter 的 SKILL.md 是大多数工具支持的通用格式。
+
+| AI Agent | Skills 格式 | 配置格式 | Frontmatter |
+|----------|:-----------:|----------|-------------|
+| Claude Code | ✅ SKILL.md | `CLAUDE.md` | YAML (`---`) |
+| OpenCode | ✅ SKILL.md | `AGENTS.md` | YAML |
+| GitHub Copilot | ✅ SKILL.md | `copilot-instructions.md` | YAML |
+| Cline | ✅ SKILL.md | `.clinerules/` | YAML |
+| Roo Code | ✅ SKILL.md | `.roo/rules/` | YAML |
+| OpenAI Codex | ✅ SKILL.md | `AGENTS.md` | YAML |
+| Windsurf | ✅ SKILL.md | `.windsurfrules` | YAML |
+| Gemini CLI | ✅ SKILL.md | `GEMINI.md` | YAML |
+| Cursor | ❌ `.mdc` | `.cursor/rules/` | YAML (globs, alwaysApply) |
+
+---
+
+## 5. 资源
+
+### 官方文档
+
+| 工具 | 文档 |
+|------|------|
+| Claude Code | [docs.anthropic.com/claude-code](https://docs.anthropic.com/claude-code) |
+| OpenCode | [opencode.ai/docs](https://opencode.ai/docs) |
+| Cursor | [docs.cursor.com](https://docs.cursor.com) |
+| GitHub Copilot | [docs.github.com/copilot](https://docs.github.com/copilot) |
+| Windsurf | [docs.windsurf.com](https://docs.windsurf.com/) |
+| OpenAI Codex | [developers.openai.com/codex](https://developers.openai.com/codex/guides/agents-md/) |
+| Gemini CLI | [github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |
+
+### Skills 市场
+
+| 平台 | URL |
+|------|-----|
+| n-skills | [github.com/numman-ali/n-skills](https://github.com/numman-ali/n-skills) |
+| claude-plugins.dev | [claude-plugins.dev/skills](https://claude-plugins.dev/skills) |
+| agentskills.io | [agentskills.io](https://agentskills.io) |
+
+### 贡献指南
+
+1. 研究工具的配置格式
+2. 在 `integrations/<tool-name>/` 下创建集成目录
+3. 添加包含设置说明的 README.md
+4. 更新本文档
+5. 按照 [CONTRIBUTING.md](../../../CONTRIBUTING.md) 提交 PR
+
+**问题反馈**: [GitHub Issues](https://github.com/anthropics-tw/universal-dev-standards/issues)
+
+---
+
+## 附录：未来发展
+
+### 潜在新工具
+
+| 工具 | 优先度 | 备注 |
+|------|--------|------|
+| Aider | 高 | Git 感知、自动提交、本地模型支持 |
+| Continue.dev | 高 | 社区驱动、开源 |
+| Amazon Q Developer | 中 | AWS 生态系统 |
+| JetBrains AI Assistant | 中 | JetBrains 生态系统 |
+| Sourcegraph Cody | 中 | 企业功能 |
+
+### 功能增强路线图
+
+| 功能 | 描述 | 状态 |
+|------|------|------|
+| SKILL.md 标准 | 通用 Skills 格式 | ✅ 已达成 (2025/12) |
+| 跨工具兼容性 | 大多数工具可读取 `.claude/skills/` | ✅ 已达成 |
+| Skills 市场 | 发布和发现 Skills | ✅ 多个平台 |
+| 多 Agent 安装 | 一次安装 Skills 到多个 Agent | ✅ v3.5.0 |
+| Gemini CLI TOML | 自动转换命令为 TOML 格式 | ✅ v3.5.0 |
+| Cursor Skills 支持 | 原生 SKILL.md 支持 | ⏳ 社区已请求 |
+| CLI 自动检测 | 检测已安装的 AI 工具 | 计划中 |
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 2.2.0 | 2026-01-15 | 新增多 Agent 安装、Gemini CLI TOML 转换 |
+| 2.1.0 | 2026-01-15 | 更新所有工具的 Skills 支持状态（业界广泛采用） |
+| 2.0.0 | 2026-01-15 | 重大重构：整合内容、减少表格 |
+| 1.1.0 | 2026-01-15 | 新增配置文件矩阵、Skills 系统配置 |
+| 1.0.0 | 2026-01-14 | 初始发布 |