Skill Porter for Google Antigravity 是一个用于将本地获取的 Claude Code、Cursor、Codex 或通用智能体技能包适配到 Google Antigravity 的实用工具。它保留支持文件，并预览有限的工具名称替换，但不证明客户端兼容性。
何时使用
当你需要将本地获取的 Claude Code、Cursor、Codex 或通用智能体技能包适配到 Google Antigravity 时使用。该工具保留支持文件，并预览有限的工具名称替换；它不证明客户端兼容性。
前提条件
- Python 3.9+；仅使用标准库。
- 一个经过审查的本地技能目录，包含 SKILL.md、该文件本身，或包含 skills/<lowercase-hyphenated-id>/SKILL.md 目录的仓库。
- 首先验证上游身份、固定版本、许可证和完整包。通过你审查过的下载/克隆工作流单独获取远程材料。
- 使用你控制的稳定本地目录。不要针对正被其他进程或用户修改的目录树运行。检查脚本而不执行它们。
工作流程
从此技能目录预览本地包：
python3 scripts/port_skill.py --source "/absolute/path/my-skill" --dry-run
审查差异。只有精确的反引号工具标识符（如 View、Edit 和 Bash）会改变。Frontmatter 和支持字节保持不变。在实际客户端中验证每个目标工具及其参数语义。
复制到新的暂存目标，然后在激活前检查：
python3 scripts/port_skill.py --source "/absolute/path/my-skill" --dest "/absolute/path/staging"
已存在的技能目标会被拒绝；不会写入全局路径。
当用户请求工作区安装时，验证当前项目：
python3 scripts/port_skill.py --source "/absolute/path/my-skill" --workspace --dry-run
python3 scripts/port_skill.py --source "/absolute/path/my-skill" --workspace
这仅写入当前工作目录下的 .agents/skills/<id>。首先确认预期主机支持该发现路径。
手动审查上下文文件引用、工具参数形状、客户端配置、依赖、许可和多智能体排序。在声称兼容性之前，验证适配后的技能并测试实际客户端调用。
示例
对于多技能仓库，使用其本地根目录作为源：
python3 scripts/port_skill.py --source "/absolute/path/reviewed-repository" --dry-run
python3 scripts/port_skill.py --source "/absolute/path/reviewed-repository" --dest "/absolute/path/fresh-output"
仅源调用默认预览。远程 URL 会被拒绝；先获取并检查固定的本地检出。从此目录运行捆绑测试：
PYTHONDONTWRITEBYTECODE=1 python3 -m unittest scripts/test_port_skill.py -v
限制
- 仅保守文本适配：无 AST 转换、语义优化、自动并行化、工件生成或兼容性认证。
- 上下文引用和支持脚本保留原始字节，可能需要手动适配。二进制支持文件原样复制，从不解释。
- 符号链接和非普通文件会被拒绝。输入限制为 1,000 个文件和 20 MiB。这不是针对并发恶意文件系统更改的沙箱；仅使用你控制的稳定目录。
- 磁盘或文件系统故障可能留下部分新目标。检查它并为重试选择新的输出。没有覆盖或回滚模式。
- 无下载、凭据、网络调用、全局安装、插件清单生成/注册或外部 MCP 设置。在实际主机中验证工具可用性，其版本和能力可能不同。
来源和许可证
改编自 Pranav-Nexus/antigravity-skill-porter。上游 MIT 声明保留在 LICENSE 中。