# Agent Skills 文件格式统一了，但各家客户端执行起来还是各管各的

> 原标题：Agent Skills 统一了文件格式，Harness 仍然各自为政

- 来源：Computing Life · Share · 鸭哥调研
- 发布时间：2026-07-20T00:00:00.000Z
- AX AI 日报：https://ai-daily.ax0x.ai/items/45637
- 原文：https://yage.ai/share/agent-skills-harness-portability-20260720.html

## 摘要

截至 2026 年 7 月 17 日，Codex、Cursor、OpenCode、Gemini CLI 和 Antigravity 全家桶都会扫描项目里的 `.agents/skills/` 共享目录来找 Skill，唯独 Claude Code 只认自己的 `.claude/skills/`，需要额外建一个 symlink 桥接。更麻烦的是，就算 C...

## 推荐理由

三条 HKR 都打中了：标准制定者自己掉队的反差制造了悬念，精确的客户端列表和时间线提供了硬知识，多工具开发者踩坑的痛点又直接引发共鸣。分数卡在 74 没往上走，是因为这本质上是工具链互操作性的问题，影响范围集中在多工具用户，还没上升到行业级震荡。

## 锐评

这条新闻值得点开看，因为它讲清楚了一个很实际的坑：文件格式统一不等于行为统一。截至 2026 年 7 月 17 日，Codex、Cursor、OpenCode、Gemini CLI 和 Antigravity 全家桶都会扫描项目里的 `.agents/skills/` 共享目录，唯独 Claude Code 只认自己的 `.claude/skills/`，需要额外建 symlink 桥接。更麻烦的是，就算 Claude Code 找到了同一个 Skill，它那 14 个私有 frontmatter 字段——比如 model、effort、hooks、disallowed-tools——在其他客户端里会被直接忽略。这意味着你写的 Skill 在 Claude Code 里能控制模型行为、限制工具调用，换到 Gemini CLI 或 OpenCode 里就只剩 name 和 description 还管用，安全策略得重新配。

执行层的差异更大。Gemini CLI 加载 Skill 前会弹确认框，OpenCode 要求模型先调 skill 工具，Antigravity CLI 直接用文件工具读。脚本从哪个目录启动、工具名叫什么、权限怎么管，全看各家 Harness 自己的规矩。正文没披露这些差异在实际项目里导致过什么事故，但如果你打算让一个 Skill 跨客户端跑，光靠格式兼容远远不够。

自建 Harness 的开发者更得注意：OpenAI 和微软的 SDK 都只解决了 Skill 怎么进模型，扫描目录、准备依赖、沙箱、授权这些活还得自己写。文章建议维护一份克制的核心 Skill，适配层按客户端单独加，这个思路务实，但没给出具体适配成本的数据。