Claugravity：一键迁移Claude Code插件至Antigravity

迁移痛点：当Claude Code遇上Antigravity

如果你同时使用Claude Code和Google Antigravity，可能会遇到一个尴尬的问题：两者的扩展格式完全不兼容。Claude使用CLAUDE.md文件和斜杠命令（slash commands），而Antigravity则要求SKILL.md文件夹、YAML frontmatter、AGENTS.md中的规则映射，以及~/.gemini/下的配置文件。据开发者社区反馈，这种格式差异导致用户难以在两者之间复用已有的插件资产。

开源工具Claugravity正是为解决这一痛点而生。它能够读取现有的Claude插件仓库或文件夹，转换指令结构，并将资产直接部署到你的原生Antigravity环境中。

Claude Code 是 Anthropic 推出的命令行 AI 编程代理，其扩展机制以项目根目录下的 CLAUDE.md 文件为核心——开发者可以在其中写入项目约定、编码规范和上下文提示，Claude Code 会在会话中自动读取。斜杠命令则是以 Markdown 文件形式定义的快捷指令（如 /review、/test），存放在特定目录中供用户手动触发。这套机制的优点是纯文件化、零依赖，但也意味着扩展能力被限定在 Anthropic 自家生态内。

Google Antigravity 是 Google 推出的 AI 编程平台，覆盖桌面应用与 IDE 插件两种形态。它采用名为 Skill 的扩展模型：每个技能是一个独立文件夹，内含 SKILL.md 作为入口说明，并通过 YAML frontmatter 声明技能名称、触发条件、权限范围等元数据。全局规则则集中写在 AGENTS.md 中，运行期配置存放在用户主目录的 ~/.gemini/ 下。这种结构比 Claude 的单文件方案更严格，便于平台做权限隔离和技能发现，代价是与 Claude 的资产无法直接互通。

YAML frontmatter 指位于 Markdown 文件开头、由两行 --- 包裹的元数据区块，采用 YAML 语法书写键值对。在 Antigravity 的 SKILL.md 中，它承担声明式配置的作用，典型字段包括技能标识、描述、允许调用的工具以及适用场景。平台在加载技能时会先解析这段元数据，再决定是否将该技能纳入可用列表、是否需要用户授权。因此 frontmatter 写错或缺失，技能往往会被静默忽略，这也是格式迁移中最容易出问题的环节之一。

Claugravity如何工作

Claugravity是一个本地运行的开源工具，采用MIT许可证，代码托管在GitHub上。它的核心功能是解析Claude插件中的CLAUDE.md和斜杠命令，将其转换为Antigravity所需的SKILL.md文件夹结构，并自动生成YAML frontmatter和AGENTS.md规则映射。转换后的资产会被放置到~/.gemini/配置目录下，供Antigravity应用或IDE读取。

整个过程在本地完成，无需将插件代码上传到云端，对注重隐私的开发者来说是一个加分项。

特色功能：安全扫描与冲突处理

Claugravity在转换之外，还提供了两项值得关注的能力。

静态安全扫描

在激活任何技能之前，工具会运行静态检查，检查规则参考了NVIDIA Agent Skills指南。它能够标记出有风险的shell模式（例如通过管道执行的curl命令），以及提示词中暴露的API凭证。据项目文档描述，这一设计旨在防止恶意或疏忽导致的凭证泄露，尤其适合在团队间共享插件时使用。

静态安全扫描 指在不执行代码的前提下，通过模式匹配和规则集分析文本内容以发现潜在风险。在 AI 技能场景下，扫描对象主要是技能描述文件和其中的命令片段：一方面识别危险 shell 模式，例如把远程内容直接通过管道交给 shell 执行（curl ... | bash）、递归删除、提权命令等；另一方面用正则或熵值检测识别硬编码的 API 密钥、令牌等凭证。这类检查的局限在于只能覆盖已知模式，无法防御经过混淆或逻辑上隐蔽的恶意行为，因此通常作为共享插件前的第一道防线，而非唯一保障。

冲突处理

当内置目录和外部目录中存在重复技能时，Claugravity会识别出来，让你可以清理冲突，避免运行时加载错误的版本。

使用方式：CLI与Web仪表盘

Claugravity提供了终端CLI和本地Web仪表盘两种管理界面。Web仪表盘运行在localhost:4321，方便可视化查看转换后的技能和配置。兼容性方面，该工具支持Windows、macOS和Linux，覆盖Antigravity桌面应用和IDE两种形态。

需要注意一个细节：Antigravity只在启动时读取配置，因此在安装或更新插件包后，必须重启应用才能生效。

本地 Web 仪表盘 指由工具自身在开发机上启动一个轻量 HTTP 服务（此处监听 localhost:4321），用户通过浏览器访问该地址来查看和操作数据。与 CLI 相比，它更适合展示技能列表、转换日志、冲突对比这类结构化信息。由于服务仅绑定回环地址，外部网络无法访问，数据也不离开本机，这与工具整体的本地化、隐私优先定位一致。使用时需注意端口被占用的情况，必要时在配置中更换端口。

总结

Claugravity解决了一个具体的生态割裂问题：Claude Code和Antigravity的扩展格式不互通。通过自动转换、安全扫描和冲突管理，它降低了在两个AI编程环境之间迁移插件的成本。对于同时使用这两款工具的开发者，这是一个值得尝试的本地工具。项目采用MIT许可证，可在GitHub上获取。