universal-dev-standards 5.1.1 → 5.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/bundled/ai/options/push/single-owner-mode.ai.yaml +60 -0
  2. package/bundled/ai/options/push/team-mode.ai.yaml +64 -0
  3. package/bundled/ai/standards/agent-behavior-discipline.ai.yaml +142 -0
  4. package/bundled/core/agent-behavior-discipline.md +178 -0
  5. package/bundled/core/versioning.md +1 -1
  6. package/bundled/locales/zh-CN/CHANGELOG.md +23 -3
  7. package/bundled/locales/zh-CN/README.md +9 -1
  8. package/bundled/locales/zh-CN/SECURITY.md +8 -0
  9. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +8 -0
  10. package/bundled/locales/zh-CN/core/workflow-enforcement.md +8 -0
  11. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +8 -0
  12. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +8 -0
  13. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -0
  14. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +8 -0
  15. package/bundled/locales/zh-CN/skills/commands/requirement.md +8 -0
  16. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +8 -0
  17. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +8 -0
  18. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +8 -0
  19. package/bundled/locales/zh-CN/skills/commands/reverse.md +8 -0
  20. package/bundled/locales/zh-CN/skills/commands/review.md +8 -0
  21. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +8 -0
  22. package/bundled/locales/zh-CN/skills/commands/sdd.md +8 -0
  23. package/bundled/locales/zh-CN/skills/commands/tdd.md +8 -0
  24. package/bundled/locales/zh-CN/skills/commands/update.md +8 -0
  25. package/bundled/locales/zh-TW/CHANGELOG.md +23 -3
  26. package/bundled/locales/zh-TW/MAINTENANCE.md +17 -6
  27. package/bundled/locales/zh-TW/README.md +9 -1
  28. package/bundled/locales/zh-TW/SECURITY.md +8 -0
  29. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +1 -1
  30. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +8 -0
  31. package/bundled/locales/zh-TW/core/anti-hallucination.md +8 -0
  32. package/bundled/locales/zh-TW/core/git-workflow.md +8 -0
  33. package/bundled/locales/zh-TW/core/refactoring-standards.md +8 -0
  34. package/bundled/locales/zh-TW/core/spec-driven-development.md +8 -0
  35. package/bundled/locales/zh-TW/core/structured-task-definition.md +8 -0
  36. package/bundled/locales/zh-TW/core/test-driven-development.md +8 -0
  37. package/bundled/locales/zh-TW/core/versioning.md +1 -1
  38. package/bundled/locales/zh-TW/core/workflow-enforcement.md +8 -0
  39. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +8 -0
  40. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +8 -0
  41. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +8 -0
  42. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -0
  43. package/bundled/locales/zh-TW/docs/MIGRATION-V5.md +8 -0
  44. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +8 -0
  45. package/bundled/locales/zh-TW/integrations/claude-code/README.md +8 -0
  46. package/bundled/skills/push/SKILL.md +203 -0
  47. package/package.json +1 -1
  48. package/src/config/ai-agent-paths.js +0 -1
  49. package/standards-registry.json +15 -4
  50. package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +0 -410
  51. package/bundled/locales/zh-CN/docs/OPERATION-WORKFLOW.md +0 -1074
  52. package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +0 -410
  53. package/bundled/locales/zh-TW/docs/OPERATION-WORKFLOW.md +0 -1074
@@ -1,410 +0,0 @@
1
- ---
2
- source: ../../../docs/AI-AGENT-ROADMAP.md
3
- source_version: 2.5.0
4
- translation_version: 2.5.0
5
- last_synced: 2026-02-09
6
- status: current
7
- ---
8
-
9
- # AI Agent 集成指南
10
-
11
- > **语言**: [English](../../../docs/AI-AGENT-ROADMAP.md) | [繁體中文](../../zh-TW/docs/AI-AGENT-ROADMAP.md) | 简体中文
12
-
13
- **版本**: 2.5.0
14
- **最后更新**: 2026-02-09
15
-
16
- 本文档提供 Universal Development Standards (UDS) 对 AI Agent 支持的完整参考。
17
-
18
- ---
19
-
20
- ## 2026 年产业变动摘要
21
-
22
- > **2026 年 2 月更新**:UDS 追踪的所有 10 个 AI 代码工具现在都支持 SKILL.md。业界已达成 100% Skills 覆盖率。
23
- >
24
- > *研究日期:2026-02-09。来源:各工具的官方文档与变更日志。*
25
-
26
- ### 重要发展
27
-
28
- | 变动 | 影响 | 日期 | 来源 |
29
- |------|------|------|------|
30
- | **Cursor SKILL.md 支持** | Cursor v2.4 通过 agentskills.io 标准原生支持 SKILL.md | 2026/01/22 | [cursor.com/changelog/2-4](https://cursor.com/changelog/2-4) |
31
- | **SKILL.md 业界标准** | 所有主流 AI 代码工具都支持相同的 Skills 格式 | 2025/12 - 2026/01 | [agentskills.io](https://agentskills.io) |
32
- | **Skills/Commands 合并** | Claude Code 在 v2.1.3+ 合并了 Skills 与 Commands | 2026/01/09 | [Claude Code Changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) |
33
- | **Gemini CLI Skills 稳定版** | Skills 在 v0.27.0 从预览升级为稳定版 | 2026/02/03 | [geminicli.com/docs/changelogs/latest](https://geminicli.com/docs/changelogs/latest/) |
34
- | **Antigravity Skills** | Google Antigravity 支持 SKILL.md 与斜杠命令 | 2025/11/18 | [antigravity.google/docs/skills](https://antigravity.google/docs/skills) |
35
- | **Windsurf 被 Cognition 收购** | Windsurf (Devin) 现在有完整的 Skills + Workflows 支持 | 2025/07 | [TechCrunch](https://techcrunch.com/2025/07/14/cognition-maker-of-the-ai-coding-agent-devin-acquires-windsurf/) |
36
- | **Codex 桌面应用** | OpenAI Codex 桌面应用发布,支持 Skills | 2026/02/02 | [openai.com/index/introducing-the-codex-app](https://openai.com/index/introducing-the-codex-app/) |
37
- | **Vibe Coding 时代** | 自然语言 → 代码生成成为主流 | 2026 | - |
38
-
39
- ### 通用 Skills 覆盖率
40
-
41
- 截至 2026 年 2 月,SKILL.md 已被**全部 10 个追踪的 AI 工具**支持:
42
- - ✅ Claude Code(原生,参考实现,2025/10)
43
- - ✅ OpenCode(完整支持,v1.1.53)
44
- - ✅ Cursor(完整支持,v2.4,2026/01)
45
- - ✅ GitHub Copilot(完整支持,2025/12)
46
- - ✅ Cline(完整支持,v3.48.0,2026/01)
47
- - ✅ Roo Code(完整支持,v3.47.3)
48
- - ✅ OpenAI Codex(完整支持,CLI v0.98.0)
49
- - ✅ Windsurf(完整支持,2026/01)
50
- - ✅ Gemini CLI(稳定版,v0.27.0,2026/02)
51
- - ✅ Antigravity(完整支持,2025/11)
52
-
53
- ### 对 UDS 的影响
54
-
55
- 1. **跨平台可移植性**:Skills 只需编写一次即可在全部 10 个 AI 工具上使用(100% 覆盖率)
56
- 2. **简化维护**:不需要工具专用的转换
57
- 3. **统一工作流程**:在所有工具中使用相同的 `/commit`、`/review`、`/tdd` 命令
58
-
59
- ---
60
-
61
- ## 目录
62
-
63
- 1. [UDS CLI 实现状态](#1-uds-cli-实现状态)
64
- 2. [快速参考](#2-快速参考)
65
- 3. [集成深度](#3-集成深度)
66
- 4. [Skills 系统](#4-skills-系统)
67
- 5. [配置参考](#5-配置参考)
68
- 6. [资源](#6-资源)
69
- 7. [附录:未来发展](#附录未来发展)
70
-
71
- ---
72
-
73
- ## 1. UDS CLI 实现状态
74
-
75
- > **重要**: 本节描述的是 UDS CLI 对各工具的实现状态,而非工具的原生能力。关于原生能力,请参阅[快速参考](#2-快速参考)。
76
-
77
- ### 状态定义
78
-
79
- | 状态 | 定义 |
80
- |------|------|
81
- | `complete` | Skills + Commands 完整支持,已测试且生产就绪 |
82
- | `partial` | Skills 可用,Commands 受限或不支持 |
83
- | `preview` | 功能可用但为预览版,可能有边缘案例 |
84
- | `planned` | CLI 中代码存在但未完整测试 |
85
- | `minimal` | 仅生成规则文件,不支持 Skills/Commands |
86
-
87
- ### 实现矩阵
88
-
89
- | AI 工具 | UDS 状态 | Skills | Commands | 配置文件 | 备注 |
90
- |---------|:--------:|:------:|:--------:|----------|------|
91
- | **Claude Code** | ✅ complete | ✅ | 内建 | `CLAUDE.md` | Marketplace + User + Project 三层级 |
92
- | **OpenCode** | ✅ complete | ✅ | ✅ | `AGENTS.md` | 完整实现,可读取 Claude 规则 |
93
- | Cline | 🔶 partial | ✅ | - | `.clinerules` | Skills 通过 fallback,Commands 使用 Workflow |
94
- | GitHub Copilot | 🔶 partial | ✅ | ✅ | `copilot-instructions.md` | 补充 Copilot Chat |
95
- | OpenAI Codex | 🔶 partial | ✅ | - | `AGENTS.md`(共享) | Skills 可用 |
96
- | Gemini CLI | 🧪 preview | ✅ | ✅ (TOML) | `GEMINI.md` | Commands 自动转换为 TOML |
97
- | Roo Code | ⏳ planned | ✅ | ✅ | - | 实现存在,待测试 |
98
- | Cursor | ✅ complete | ✅ | ✅ | `.cursorrules` | Skills 支持自 v2.4(2026/01/22) |
99
- | Windsurf | 🔶 partial | ✅ | ✅ | `.windsurfrules` | Skills + Workflows(2026/01) |
100
- | Antigravity | 📄 minimal | - | - | `INSTRUCTIONS.md` | UDS CLI 尚未更新(工具原生支持 Skills) |
101
-
102
- ### 两种「支持」的区别
103
-
104
- | 概念 | 定义 | 记录位置 |
105
- |------|------|----------|
106
- | **工具原生能力** | AI 工具本身支持什么功能 | [快速参考](#2-快速参考) |
107
- | **UDS CLI 实现** | UDS CLI 对该工具的实现程度 | 本节 |
108
-
109
- 示例:Cursor 自 v2.4(2026/01/22)起原生支持 SKILL.md,UDS CLI 提供完整的 Skills、Commands 与 `.cursorrules` 生成集成。
110
-
111
- ---
112
-
113
- ## 2. 快速参考
114
-
115
- ### 2.1 配置文件
116
-
117
- | AI Agent | 项目配置 | 全局配置 | 备注 |
118
- |----------|----------|----------|------|
119
- | Claude Code | `.claude/CLAUDE.md` | `~/.claude/CLAUDE.md` | ~100KB 限制 |
120
- | OpenCode | `.opencode/AGENTS.md` | `~/.config/opencode/AGENTS.md` | 无限制 |
121
- | GitHub Copilot | `.github/copilot-instructions.md` | 个人设置 | ~8KB 限制 |
122
- | Cline | `.clinerules/` | `~/.cline-rules/` | 文件夹或单一文件 |
123
- | Roo Code | `.roo/rules/*.md` | `~/.roo/rules/` | 模式特定:`.roo/rules-{mode}/` |
124
- | OpenAI Codex | `.codex/AGENTS.md` | `~/.codex/AGENTS.md` | 32KB 限制 |
125
- | Windsurf | `.windsurfrules` | 设置 UI | 6K/文件,总计 12K |
126
- | Gemini CLI | `.gemini/GEMINI.md` | `~/.gemini/GEMINI.md` | 支持 `@import` |
127
- | Cursor | `.cursor/skills/` | `~/.cursor/skills/` | SKILL.md + Rules 支持 |
128
- | Antigravity | `INSTRUCTIONS.md` | `~/.antigravity/` | Skills + 斜杠命令 |
129
-
130
- ### 2.2 Skills 路径
131
-
132
- | AI Agent | Skills | 项目路径 | 全局路径 | 备注 |
133
- |----------|:------:|----------|----------|------|
134
- | Claude Code | ✅ 原生 | `.claude/skills/` | `~/.claude/skills/` | 参考实现 |
135
- | OpenCode | ✅ 完整 | `.opencode/skill/` | `~/.config/opencode/skill/` | 也读取 `.claude/skills/` |
136
- | GitHub Copilot | ✅ 完整 | `.github/skills/` | `~/.copilot/skills/` | 旧版:`.claude/skills/` |
137
- | Cline | ✅ 完整 | `.claude/skills/` | `~/.claude/skills/` | 直接使用 Claude 路径 |
138
- | Roo Code | ✅ 完整 | `.roo/skills/` | `~/.roo/skills/` | 模式特定:`.roo/skills-{mode}/` |
139
- | OpenAI Codex | ✅ 完整 | `.codex/skills/` | `~/.codex/skills/` | 也读取 `.claude/skills/` |
140
- | Windsurf | ✅ 完整 | `.windsurf/rules/` | 设置 UI | 2026/01 起支持 Skills |
141
- | Gemini CLI | ✅ 稳定版 | `.gemini/skills/` | `~/.gemini/skills/` | v0.27.0 稳定版 |
142
- | Cursor | ✅ 完整 | `.cursor/skills/` | `~/.cursor/skills/` | SKILL.md 支持自 v2.4 |
143
- | Antigravity | ✅ 完整 | `.agent/skills/` | `~/.gemini/antigravity/skills/` | 2025/11 起支持 Skills |
144
-
145
- ### 2.3 斜杠命令
146
-
147
- | AI Agent | 支持 | 类型 | 示例 | 自定义路径 |
148
- |----------|:----:|------|------|------------|
149
- | Claude Code | ✅ | Skill 触发 | `/commit`, `/review`, `/tdd` | 仅内建 |
150
- | OpenCode | ✅ | 用户定义 | 可配置 | `.opencode/command/*.md` |
151
- | GitHub Copilot | ✅ | 内建 | `/fix`, `/tests`, `/explain` | `.github/prompts/*.prompt.md` |
152
- | Cline | ✅ | 内建 + Workflows | `/smol`, `/plan`, `/newtask` | Workflow 文件 |
153
- | Roo Code | ✅ | 模式命令 | `/code`, `/architect`, `/init` | `.roo/commands/*.md` |
154
- | OpenAI Codex | ✅ | 系统命令 | `/model`, `/diff`, `/skills` | 自定义 prompts |
155
- | Windsurf | ✅ | Rulebook | 自动生成 | 从 `.windsurfrules` |
156
- | Gemini CLI | ✅ | 系统 + 自定义 | `/clear`, `/memory`, `/mcp` | `.gemini/commands/*.toml` |
157
- | Cursor | ✅ | 内建 + 自定义 + Skills | `/summarize`, `/models`, `/rules`, `/mcp` | `.cursor/skills/`, `.cursor/commands/*.md` |
158
- | Antigravity | ✅ | 斜杠命令 | `/deslop`, `/refactor`, `/write-tests` | 社区驱动 |
159
-
160
- ### 2.4 平台支持
161
-
162
- | 平台 | CLI 工具 | Skills |
163
- |------|:--------:|:------:|
164
- | macOS | 已测试 | 已测试 |
165
- | Linux | 预期可用 | 预期可用 |
166
- | Windows | 提供 PowerShell | 预期可用 |
167
-
168
- ---
169
-
170
- ## 3. 集成深度
171
-
172
- > **说明**: 截至 2026 年 2 月,Agent Skills (SKILL.md) 已成为业界标准。所有 10 个追踪的 AI 代码工具现在都支持相同的 Skills 格式。
173
-
174
- ### 原生 Skills(参考实现)
175
-
176
- **工具**: Claude Code
177
-
178
- - Agent Skills 标准的参考实现
179
- - 25 个内建 UDS Skills + Marketplace
180
- - 37 个斜杠命令(25 个基于 Skill + 12 个仅 Commands)
181
- - 完整斜杠命令支持(`/commit`、`/review`、`/tdd` 等)
182
- - 关键字自动触发
183
-
184
- ### 完整 Skills 支持
185
-
186
- **工具**: OpenCode, Cursor, GitHub Copilot, Cline, Roo Code, OpenAI Codex, Windsurf, Gemini CLI
187
-
188
- - 可读取并执行 SKILL.md 文件
189
- - 跨平台兼容 `.claude/skills/` 目录
190
- - 大多数工具也有自己的原生路径(见 Skills 路径栏)
191
-
192
- ### 最低 UDS CLI 支持
193
-
194
- **工具**: Antigravity
195
-
196
- - 工具原生支持 SKILL.md 与斜杠命令(自 2025/11 起)
197
- - UDS CLI 集成尚未更新 — 目前仅生成 `INSTRUCTIONS.md`
198
- - 计划中:升级 UDS CLI 以为 Antigravity 生成 Skills
199
-
200
- ---
201
-
202
- ## 4. Skills 系统
203
-
204
- ### 4.1 UDS Skills 兼容性
205
-
206
- | # | Skill | 斜杠命令 | Claude | OpenCode | Cursor | Copilot |
207
- |---|-------|----------|:------:|:--------:|:------:|:-------:|
208
- | 1 | ai-collaboration-standards | - | 完整 | 完整 | 完整 | 完整 |
209
- | 2 | checkin-assistant | `/check` | 完整 | 完整 | 部分 | 部分 |
210
- | 3 | commit-standards | `/commit` | 完整 | 完整 | 部分 | 部分 |
211
- | 4 | code-review-assistant | `/review` | 完整 | 完整 | 部分 | 部分 |
212
- | 5 | testing-guide | - | 完整 | 完整 | 完整 | 完整 |
213
- | 6 | tdd-assistant | `/tdd` | 完整 | 完整 | 部分 | 部分 |
214
- | 7 | release-standards | `/release` | 完整 | 完整 | 部分 | 无 |
215
- | 8 | git-workflow-guide | - | 完整 | 完整 | 完整 | 完整 |
216
- | 9 | documentation-guide | `/docs` | 完整 | 完整 | 部分 | 无 |
217
- | 10 | requirement-assistant | `/requirement` | 完整 | 完整 | 部分 | 部分 |
218
- | 11 | changelog-guide | `/changelog` | 完整 | 完整 | 部分 | 无 |
219
- | 12 | spec-driven-dev | `/sdd` | 完整 | 完整 | 部分 | 部分 |
220
- | 13 | test-coverage-assistant | `/coverage` | 完整 | 完整 | 部分 | 部分 |
221
- | 14 | refactoring-assistant | - | 完整 | 完整 | 完整 | 完整 |
222
- | 15 | error-code-guide | - | 完整 | 完整 | 完整 | 完整 |
223
- | 16 | methodology-system | `/methodology` | 完整 | 完整 | 部分 | 无 |
224
- | 17 | project-structure-guide | `/config` | 完整 | 完整 | 部分 | 无 |
225
- | 18 | logging-guide | - | 完整 | 完整 | 完整 | 完整 |
226
-
227
- ### 4.2 Skills 路径与启用
228
-
229
- #### Skills 发现路径
230
-
231
- | AI Agent | 项目路径 | 全局路径 | 读取 `.claude/skills/` |
232
- |----------|----------|----------|:----------------------:|
233
- | Claude Code | `.claude/skills/` | `~/.claude/skills/` | 原生 |
234
- | OpenCode | `.opencode/skill/` | `~/.config/opencode/skill/` | ✅ 是 |
235
- | GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` | ✅ 是(旧版) |
236
- | Cline | `.claude/skills/` | `~/.claude/skills/` | ✅ 是 |
237
- | Roo Code | `.roo/skills/` | `~/.roo/skills/` | ✅ 是 |
238
- | OpenAI Codex | `.codex/skills/` | `~/.codex/skills/` | ✅ 是 |
239
- | Windsurf | `.windsurf/rules/` | 设置 UI | ✅ 是 |
240
- | Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` | ✅ 是 |
241
- | Cursor | `.cursor/skills/` | `~/.cursor/skills/` | ✅ 是 |
242
- | Antigravity | `.agent/skills/` | `~/.gemini/antigravity/skills/` | ✅ 是 |
243
-
244
- #### 启用方式
245
-
246
- | AI Agent | 启用方式 |
247
- |----------|----------|
248
- | Claude Code | 斜杠命令、自动触发、提及 |
249
- | OpenCode | 斜杠命令、Tab 切换 |
250
- | GitHub Copilot | 自动加载、`applyTo` 模式 |
251
- | Cline | 自动从目录加载 |
252
- | Roo Code | 自动加载、模式特定(`.roo/skills-{mode}/`) |
253
- | OpenAI Codex | `/skills` 命令、自动触发 |
254
- | Windsurf | 手动(@提及)、始终开启、模型决定 |
255
- | Gemini CLI | 自动触发、通过设置启用/禁用 |
256
- | Cursor | 斜杠命令、Glob 模式、`alwaysApply` 标志 |
257
- | Antigravity | 斜杠命令、语义触发 |
258
-
259
- **建议**:使用 `.claude/skills/` 作为默认安装路径 — 大多数工具都可读取以获得跨工具兼容性。
260
-
261
- ### 4.3 跨平台可移植性
262
-
263
- > **业界标准**: 截至 2025 年 12 月,SKILL.md 已被 OpenAI、GitHub、Google 及更广泛的 AI 代码生态系统采用。
264
-
265
- | 平台 | SKILL.md 支持 | 采用日期 |
266
- |------|:-------------:|----------|
267
- | Claude Code | ✅ 原生 | 2025/10 |
268
- | OpenCode | ✅ 完整 | 2025/11 |
269
- | GitHub Copilot | ✅ 完整 | 2025/12/18 |
270
- | OpenAI Codex | ✅ 完整 | 2025/12 |
271
- | Cline | ✅ 完整 | v3.48.0 |
272
- | Roo Code | ✅ 完整 | 2025/12/27 |
273
- | Windsurf | ✅ 完整 | 2026/01/09 |
274
- | Gemini CLI | ✅ 稳定版 | 2026/02/03,v0.27.0 |
275
- | Cursor | ✅ 完整 | 2026/01/22,v2.4 |
276
- | Antigravity | ✅ 完整 | 2025/11/18 |
277
-
278
- **跨平台安装器**:
279
- - [skilz](https://github.com/skilz-ai/skilz) - 通用 Skills 安装器(14+ 平台)
280
- - [openskills](https://github.com/numman-ali/openskills) - 通用 skills 加载器
281
- - UDS CLI (`uds init`) - 为多个 AI 工具生成配置
282
-
283
- ---
284
-
285
- ## 5. 配置参考
286
-
287
- ### 5.1 配置文件
288
-
289
- | AI Agent | 项目配置 | 全局配置 | 字符限制 |
290
- |----------|----------|----------|----------|
291
- | Claude Code | `CLAUDE.md` | `~/.claude/CLAUDE.md` | ~100KB |
292
- | OpenCode | `AGENTS.md` | `~/.config/opencode/AGENTS.md` | 无限制 |
293
- | Cursor | `.cursor/skills/`, `.cursor/rules/*.mdc` | `~/.cursor/skills/` | 每文件不同 |
294
- | Windsurf | `.windsurfrules` | 设置 UI | 6K/文件,总计 12K |
295
- | Cline | `.clinerules` | `~/.cline-rules/` | 无限制 |
296
- | Roo Code | `.roorules` | `~/.roo/rules/` | 无限制 |
297
- | GitHub Copilot | `.github/copilot-instructions.md` | 个人设置 | ~8KB |
298
- | OpenAI Codex | `AGENTS.md` | `~/.codex/AGENTS.md` | 32KB |
299
- | Gemini CLI | `GEMINI.md` | `~/.gemini/GEMINI.md` | 1M tokens |
300
- | Antigravity | `INSTRUCTIONS.md` | `~/.antigravity/` | Skills + 斜杠命令 |
301
-
302
- ### 5.2 配置合并行为
303
-
304
- | AI Agent | 合并策略 | 优先顺序(高到低) |
305
- |----------|----------|-------------------|
306
- | Claude Code | 串接 | 目录范围 > 项目 > 个人 |
307
- | OpenCode | 串接 | 项目 > 全局 |
308
- | Cursor | 替换/选择性 | `.mdc` 按 glob,alwaysApply 标志 |
309
- | Windsurf | 达限制时截断 | 全局 > 工作区 > 模式特定 |
310
- | Cline | 附加 | 项目目录 > 根文件 |
311
- | GitHub Copilot | 组合 | 个人 > 仓库 > 组织 |
312
- | OpenAI Codex | 串接 | 覆盖文件 > 基础,较近者优先 |
313
- | Gemini CLI | 串接 | 所有文件支持 `@import` |
314
- | Antigravity | 串接 | 工作区 > 全局 |
315
-
316
- ### 5.3 Skills 文件格式
317
-
318
- > **标准格式**: 带有 YAML frontmatter 的 SKILL.md 是大多数工具支持的通用格式。
319
-
320
- | AI Agent | Skills 格式 | 配置格式 | Frontmatter |
321
- |----------|:-----------:|----------|-------------|
322
- | Claude Code | ✅ SKILL.md | `CLAUDE.md` | YAML (`---`) |
323
- | OpenCode | ✅ SKILL.md | `AGENTS.md` | YAML |
324
- | GitHub Copilot | ✅ SKILL.md | `copilot-instructions.md` | YAML |
325
- | Cline | ✅ SKILL.md | `.clinerules/` | YAML |
326
- | Roo Code | ✅ SKILL.md | `.roo/rules/` | YAML |
327
- | OpenAI Codex | ✅ SKILL.md | `AGENTS.md` | YAML |
328
- | Windsurf | ✅ SKILL.md | `.windsurfrules` | YAML |
329
- | Gemini CLI | ✅ SKILL.md | `GEMINI.md` | YAML |
330
- | Cursor | ✅ SKILL.md | `.cursor/skills/`, `.cursor/rules/` | YAML (globs, alwaysApply) |
331
- | Antigravity | ✅ SKILL.md | `INSTRUCTIONS.md` | YAML |
332
-
333
- ---
334
-
335
- ## 6. 资源
336
-
337
- ### 官方文档
338
-
339
- | 工具 | 文档 |
340
- |------|------|
341
- | Claude Code | [docs.anthropic.com/claude-code](https://docs.anthropic.com/claude-code) |
342
- | OpenCode | [opencode.ai/docs](https://opencode.ai/docs) |
343
- | Cursor | [docs.cursor.com](https://docs.cursor.com) |
344
- | GitHub Copilot | [docs.github.com/copilot](https://docs.github.com/copilot) |
345
- | Windsurf | [docs.windsurf.com](https://docs.windsurf.com/) |
346
- | OpenAI Codex | [developers.openai.com/codex](https://developers.openai.com/codex/guides/agents-md/) |
347
- | Gemini CLI | [github.com/google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |
348
-
349
- ### Skills 市场
350
-
351
- | 平台 | URL |
352
- |------|-----|
353
- | n-skills | [github.com/numman-ali/n-skills](https://github.com/numman-ali/n-skills) |
354
- | claude-plugins.dev | [claude-plugins.dev/skills](https://claude-plugins.dev/skills) |
355
- | agentskills.io | [agentskills.io](https://agentskills.io) |
356
-
357
- ### 贡献指南
358
-
359
- 1. 研究工具的配置格式
360
- 2. 在 `integrations/<tool-name>/` 下创建集成目录
361
- 3. 添加包含设置说明的 README.md
362
- 4. 更新本文档
363
- 5. 按照 [CONTRIBUTING.md](../../../CONTRIBUTING.md) 提交 PR
364
-
365
- **问题反馈**: [GitHub Issues](https://github.com/anthropics-tw/universal-dev-standards/issues)
366
-
367
- ---
368
-
369
- ## 附录:未来发展
370
-
371
- ### 潜在新工具
372
-
373
- | 工具 | 优先度 | 备注 |
374
- |------|--------|------|
375
- | Aider | 高 | Git 感知、自动提交、本地模型支持 |
376
- | Continue.dev | 高 | 社区驱动、开源 |
377
- | Amazon Q Developer | 中 | AWS 生态系统 |
378
- | JetBrains AI Assistant | 中 | JetBrains 生态系统 |
379
- | Sourcegraph Cody | 中 | 企业功能 |
380
-
381
- ### 功能增强路线图
382
-
383
- | 功能 | 描述 | 状态 |
384
- |------|------|------|
385
- | SKILL.md 标准 | 通用 Skills 格式 | ✅ 已达成 (2025/12) |
386
- | 跨工具兼容性 | 大多数工具可读取 `.claude/skills/` | ✅ 已达成 |
387
- | Skills 市场 | 发布和发现 Skills | ✅ 多个平台 |
388
- | 多 Agent 安装 | 一次安装 Skills 到多个 Agent | ✅ v3.5.0 |
389
- | Gemini CLI TOML | 自动转换命令为 TOML 格式 | ✅ v3.5.0 |
390
- | Cursor Skills 支持 | 原生 SKILL.md 支持 | ✅ v2.4(2026/01/22) |
391
- | Antigravity Skills | 原生 SKILL.md + 斜杠命令 | ✅ 2025/11 |
392
- | Gemini CLI Skills 稳定版 | Skills 从预览升级为稳定版 | ✅ v0.27.0(2026/02/03) |
393
- | Windsurf 完整 Skills | Skills + Workflows(Cognition 拥有) | ✅ 2026/01 |
394
- | 100% SKILL.md 覆盖率 | 所有 10 个追踪的 AI 工具支持 SKILL.md | ✅ 已达成(2026/02) |
395
- | CLI 自动检测 | 检测已安装的 AI 工具 | 计划中 |
396
-
397
- ---
398
-
399
- ## 版本历史
400
-
401
- | 版本 | 日期 | 变更 |
402
- |------|------|------|
403
- | 2.5.0 | 2026-02-09 | 研究更新:Antigravity 支持 Skills + 斜杠命令(先前错误标记为不支持);Gemini CLI Skills 升级为稳定版(v0.27.0);Windsurf 升级为 partial(Skills + Workflows);Cursor 版本更正为 v2.4;新增来源 URL 至重要发展;所有 10 个 AI 工具现在支持 SKILL.md(100% 覆盖率) |
404
- | 2.4.0 | 2026-01-27 | 更新 Cursor 为 complete/完整 Skills 支持(v2.3.35);新增「2026 年产业变动摘要」章节;移除「仅 Rules」分类(Cursor 已升级) |
405
- | 2.3.0 | 2026-01-22 | 新增 UDS CLI 实现状态章节与状态定义;新增 Antigravity 至所有表格以与 CLI 保持一致 |
406
- | 2.2.0 | 2026-01-15 | 新增多 Agent 安装、Gemini CLI TOML 转换 |
407
- | 2.1.0 | 2026-01-15 | 更新所有工具的 Skills 支持状态(业界广泛采用) |
408
- | 2.0.0 | 2026-01-15 | 重大重构:整合内容、减少表格 |
409
- | 1.1.0 | 2026-01-15 | 新增配置文件矩阵、Skills 系统配置 |
410
- | 1.0.0 | 2026-01-14 | 初始发布 |