AI Agent Skills 正成为一种开放标准，能让开发者用简单目录为AI编程助手定义能力。面对众多平台，如何实现一次编写、处处运行？本文提供了一套完整的跨平台配置方案与兼容性分析，帮助开发者统一管理技能，提升效率。
智能速览
Agent Skills 是 AI 助手的开放标准，类似智能 npm 包。
多数主流工具已兼容 Claude Code 的标准路径。
“以 Claude 为中心”可实现技能统一管理。
部分工具需通过软链接实现跨平台复用。
标准化的 SKILL.md 文件格式确保最大兼容性。
精华内容
要实现技能的多平台通用，关键在于理解各平台的目录结构差异，并采取统一的配置策略。以下是具体的操作指南和兼容性分析。
兼容性速查
根据对8个主流AI编程工具的分析，兼容性可分为两类。第一类是原生兼容，包括 Claude Code、GitHub Copilot、Cursor、OpenCode 和 Google Antigravity，这些工具会自动扫描 Claude 的标准路径（`.claude/skills`），无需任何额外配置。
第二类是结构兼容，包括 OpenAI Codex、Gemini CLI 和 Windsurf。它们虽然支持相同的 SKILL.md 文件格式，但只扫描自己的专属目录，需要通过复制或建立软链接才能复用技能。
最佳实践
鉴于目前多数工具已支持 Claude 路径，推荐采用“以 Claude 为中心”的策略。即将所有技能文件统一存放在 `~/.claude/skills`（全局）或 `.claude/skills`（项目）目录中。
这样做可以最大程度地减少维护成本，确保技能在多个平台间无缝使用，是实现“一次编写，到处运行”最简单高效的方法。
软链接配置
对于 OpenAI Codex、Gemini CLI、Windsurf 等结构兼容的工具，需建立软链接来访问 Claude 的技能库。在 Mac/Linux 系统下，可使用 `ln -s` 命令；Windows 系统则需以管理员身份运行 PowerShell，使用 `New-Item -ItemType SymbolicLink` 命令。
例如，为 OpenAI Codex 创建链接的命令为：`ln -s ~/.claude/skills ~/.codex/skills`。文中提供了针对所有需配置工具的完整脚本。
技能文件标准
为确保跨平台兼容性，Skill 文件应遵循统一的 `SKILL.md` 格式。文件开头使用 YAML Front Matter 定义元数据，其中 `name` 必须是 kebab-case 格式，`description` 字段至关重要，AI Agent 会据此判断是否调用该技能。
正文部分可包含具体的指令和示例，清晰定义技能的功能和使用方法。
通过统一的配置策略和标准化的文件格式，AI Agent Skills 的跨平台复用已变得相当可行。未来，随着更多工具加入兼容行列，这一生态将更加开放。你准备好开始构建自己的第一个跨平台技能了吗？
