Antigravity 设置与使用指南¶

Google Antigravity 2.0 会从项目本地的 .agents/ 目录中发现工作区自定义配置。ECC 的 Antigravity 目标会将原生规则、工作流、技能和自定义代理安装到该目录中。

原生 Antigravity 2.0 安装需要 ECC 2.2.0 或更高版本。ECC 2.1.0 使用旧版 .agent/ 适配器，并且不提供下面描述的原生布局。

快速开始¶

验证 2.2.0 可从注册表读取，然后从你要配置的项目中运行固定版本包：

npm view ecc-universal version
npx ecc-universal@2.2.0 install --profile minimal --target antigravity

源代码检出替代方案¶

# Run every command below from the project you want to configure.
# Keep the ECC source checkout separate and use its absolute path.
ECC_ROOT="/absolute/path/to/ECC"

# Install the minimal profile
"$ECC_ROOT/install.sh" --profile minimal --target antigravity

# Compatibility syntax: common rules plus only these language packs
"$ECC_ROOT/install.sh" --target antigravity typescript python go

PowerShell 使用相同的项目根工作目录约定：

$EccRoot = "C:\absolute\path\to\ECC"

& "$EccRoot\install.ps1" --profile minimal --target antigravity
& "$EccRoot\install.ps1" --target antigravity typescript python go

安装后，请开始一个新的 Antigravity 对话，以便代理接收更新后的技能清单。

原生安装映射¶

ECC 源	Antigravity 目标	用途
`rules/`	`.agents/rules/`	工作区规则，使用冲突安全名称展平
`commands/`	`.agents/workflows/`	用户调用的斜杠工作流
`skills/<name>/`	`.agents/skills/<name>/`	带有必需 `SKILL.md` 的代理技能
`agents/<name>.md`	`.agents/agents/<name>.md`	自定义主代理和子代理

ECC 不会整体复制仓库的 .agents/ 目录。该源树是 Codex 打包，并包含 Codex 特定的市场元数据。Antigravity 插件则要求 .agents/plugins/<plugin-name>/plugin.json。

已安装的自定义代理定义会适配 Antigravity 的 frontmatter： Claude 模型层级变为 flash 或 pro，Claude 工具名称变为对应的 Antigravity 等效名称。不支持的工具标识符永远不会被输出，因为 Antigravity 会警告无效工具名称可能导致自定义代理执行挂起。

预期项目树¶

your-project/
└── .agents/
    ├── rules/
    │   ├── common-coding-style.md
    │   └── typescript-testing.md
    ├── workflows/
    │   └── plan.md
    ├── skills/
    │   └── coding-standards/
    │       └── SKILL.md
    ├── agents/
    │   └── code-reviewer.md
    └── ecc-install-state.json

验证安装¶

macOS 和 Linux：

node "$ECC_ROOT/scripts/list-installed.js" --target antigravity
node "$ECC_ROOT/scripts/doctor.js" --target antigravity
rg --files .agents/skills -g 'SKILL.md'
rg --files .agents/agents -g '*.md'

PowerShell：

node "$EccRoot\scripts\list-installed.js" --target antigravity
node "$EccRoot\scripts\doctor.js" --target antigravity
Get-ChildItem .agents\skills -Recurse -Filter SKILL.md
Get-ChildItem .agents\agents -Recurse -Filter *.md

在 Antigravity 中，打开 设置 > 自定义，确认工作区技能出现，开始新对话，并按其准确名称请求一个技能。

现有 `.agent/` 安装¶

Antigravity 仍会读取旧版 .agent/rules 和 .agent/skills，但 ECC 现在使用规范的 .agents/ 布局。不要手动重命名 .agent，因为 ECC 安装状态包含绝对托管路径。

更新后重新运行相同的 ECC 安装命令。ECC 首先写入并验证新的 .agents/ecc-install-state.json，然后仅删除由有效旧版状态拥有的未更改文件。已修改和未托管文件保留在 .agent/ 中，并且在处理之前仍可由 doctor 和卸载发现。

在需要时，可在应用生命周期操作之前预览它们：

macOS 和 Linux：

node "$ECC_ROOT/scripts/doctor.js" --target antigravity
node "$ECC_ROOT/scripts/repair.js" --target antigravity --dry-run
node "$ECC_ROOT/scripts/uninstall.js" --target antigravity --dry-run

PowerShell：

node "$EccRoot\scripts\doctor.js" --target antigravity
node "$EccRoot\scripts\repair.js" --target antigravity --dry-run
node "$EccRoot\scripts\uninstall.js" --target antigravity --dry-run

故障排除¶

技能未出现¶

有效技能必须是 .agents/skills/<name>/SKILL.md。
.agent/.agents/skills 是旧版 ECC 构建中过时的嵌套布局。
更改技能文件后，请开始新对话。

规则未生效¶

确认文件直接位于 .agents/rules/ 下。
运行 doctor 并检查任何缺失或漂移的托管文件警告。

工作流未出现¶

确认文件位于 .agents/workflows/ 下。
重启 Antigravity 后，使用 /<workflow-name> 调用工作流。

官方 Antigravity 参考¶

有关 ECC 贡献指南，请参阅 CONTRIBUTING.md，有关安装器生命周期契约，请参阅 SELECTIVE-INSTALL-ARCHITECTURE.md。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 ev/ECC