universal-dev-standards 5.1.1 → 5.3.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 (65) 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/options/release/publish-mode-github-actions.ai.yaml +65 -0
  4. package/bundled/ai/standards/agent-behavior-discipline.ai.yaml +142 -0
  5. package/bundled/ai/standards/cd-deployment-strategies.ai.yaml +73 -0
  6. package/bundled/ai/standards/no-cicd-deployment.ai.yaml +134 -0
  7. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +71 -0
  8. package/bundled/ai/standards/push-standards.ai.yaml +105 -0
  9. package/bundled/ai/standards/rollback-standards.ai.yaml +68 -0
  10. package/bundled/core/agent-behavior-discipline.md +178 -0
  11. package/bundled/core/cd-deployment-strategies.md +121 -0
  12. package/bundled/core/no-cicd-deployment.md +205 -0
  13. package/bundled/core/pipeline-security-gates.md +109 -0
  14. package/bundled/core/rollback-standards.md +104 -0
  15. package/bundled/core/versioning.md +1 -1
  16. package/bundled/locales/zh-CN/CHANGELOG.md +34 -3
  17. package/bundled/locales/zh-CN/README.md +54 -7
  18. package/bundled/locales/zh-CN/SECURITY.md +8 -0
  19. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +8 -0
  20. package/bundled/locales/zh-CN/core/workflow-enforcement.md +8 -0
  21. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +8 -0
  22. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +8 -0
  23. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -0
  24. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +8 -0
  25. package/bundled/locales/zh-CN/skills/commands/requirement.md +8 -0
  26. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +8 -0
  27. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +8 -0
  28. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +8 -0
  29. package/bundled/locales/zh-CN/skills/commands/reverse.md +8 -0
  30. package/bundled/locales/zh-CN/skills/commands/review.md +8 -0
  31. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +8 -0
  32. package/bundled/locales/zh-CN/skills/commands/sdd.md +8 -0
  33. package/bundled/locales/zh-CN/skills/commands/tdd.md +8 -0
  34. package/bundled/locales/zh-CN/skills/commands/update.md +8 -0
  35. package/bundled/locales/zh-TW/CHANGELOG.md +34 -3
  36. package/bundled/locales/zh-TW/MAINTENANCE.md +17 -6
  37. package/bundled/locales/zh-TW/README.md +53 -6
  38. package/bundled/locales/zh-TW/SECURITY.md +8 -0
  39. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +1 -1
  40. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +8 -0
  41. package/bundled/locales/zh-TW/core/anti-hallucination.md +8 -0
  42. package/bundled/locales/zh-TW/core/git-workflow.md +8 -0
  43. package/bundled/locales/zh-TW/core/refactoring-standards.md +8 -0
  44. package/bundled/locales/zh-TW/core/spec-driven-development.md +8 -0
  45. package/bundled/locales/zh-TW/core/structured-task-definition.md +8 -0
  46. package/bundled/locales/zh-TW/core/test-driven-development.md +8 -0
  47. package/bundled/locales/zh-TW/core/versioning.md +1 -1
  48. package/bundled/locales/zh-TW/core/workflow-enforcement.md +8 -0
  49. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +8 -0
  50. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +8 -0
  51. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +8 -0
  52. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -0
  53. package/bundled/locales/zh-TW/docs/MIGRATION-V5.md +8 -0
  54. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +8 -0
  55. package/bundled/locales/zh-TW/integrations/claude-code/README.md +8 -0
  56. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +178 -0
  57. package/bundled/skills/deploy-assistant/SKILL.md +183 -0
  58. package/bundled/skills/push/SKILL.md +203 -0
  59. package/package.json +1 -1
  60. package/src/config/ai-agent-paths.js +0 -1
  61. package/standards-registry.json +71 -4
  62. package/bundled/locales/zh-CN/docs/AI-AGENT-ROADMAP.md +0 -410
  63. package/bundled/locales/zh-CN/docs/OPERATION-WORKFLOW.md +0 -1074
  64. package/bundled/locales/zh-TW/docs/AI-AGENT-ROADMAP.md +0 -410
  65. 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-CN/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 | 初始發布 |