如何在 Google Antigravity 2.0 中启用 ECC 的原生 .agents/ 布局？

如何在 Google Antigravity 2.0 中启用 ECC 的原生 .agents/ 布局？

【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC

Google Antigravity 2.0 会从项目本地的.agents/目录发现工作区定制内容。ECC 的 Antigravity 目标会把 rules、workflows、skills 和 custom agents 原生写入这个目录，从而让 Antigravity 直接识别这些资产。如果你的 Antigravity 项目还没有按.agents/布局配置，或者仍在使用旧版.agent/适配层，本文给出从安装到验证的完整操作路径。

前提条件只有一个：ECC 2.2.0 或更高版本才提供原生 Antigravity 2.0 安装；ECC 2.1.0 仍使用旧版.agent/适配器，不具备本文描述的原生布局。

准备条件

• 安装命令必须从你要配置的那个项目目录里执行，ECC 会把.agents/写入当前工作目录；
• 如果走源码检出方式，ECC 源码需要单独放在别处，用绝对路径引用，不要直接在被配置的项目里运行；
• 本仓库当前发布版本为 2.2.1（见 VERSION），文档中的 npm 命令固定使用满足最低要求 2.2.0 的包版本（见 docs/ANTIGRAVITY-GUIDE.md）。

主路径：通过 npm 包安装

先确认注册表中 2.2.0 可读，然后在目标项目目录运行固定版本的包：

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

--profile minimal安装最小配置文件集，--target antigravity指定 Antigravity 原生目标。

安装完成后，新开一个 Antigravity 会话，让 agent 拿到更新后的 skill 清单——这一步不要跳过，否则可能看不到新装的 skills。

可选：从源码检出安装

如果不用 npm 包，也可以直接跑 ECC 源码里的安装脚本。install.sh是一个薄封装：从 git clone 运行时若没有node_modules会自动执行npm install，然后委托给 Node 安装运行时（见 install.sh）：

# 以下命令都在你要配置的项目里执行； # ECC_ROOT 换成你 ECC 源码检出的绝对路径 ECC_ROOT="/absolute/path/to/ECC" # 安装 minimal profile "$ECC_ROOT/install.sh" --profile minimal --target antigravity # 兼容写法：common rules 加上指定的语言包 "$ECC_ROOT/install.sh" --target antigravity typescript python go

PowerShell 遵循同样的"项目根目录作为工作目录"约定：

# $EccRoot 换成 ECC 源码检出的绝对路径 $EccRoot = "C:\absolute\path\to\ECC" & "$EccRoot\install.ps1" --profile minimal --target antigravity & "$EccRoot\install.ps1" --target antigravity typescript python go

两条 bash/PowerShell 命令含义相同：--profile minimal装最小集；不带 profile 的兼容写法安装 common rules 加你列出的语言包（上例是typescript python go，可按需替换）。

安装后项目里会有什么

安装映射固定为（来源：docs/ANTIGRAVITY-GUIDE.md）：

安装完成后的项目目录应形如（文档示例结构）：

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

两点行为值得注意：

• ECC 不会整体复制仓库自己的.agents/目录——那棵树是 Codex 打包产物，含有 Codex 特有的 marketplace 元数据；
• 自定义 agent 定义会被改写成 Antigravity 的 frontmatter：Claude 模型层级变成flash或pro，Claude 工具名换成 Antigravity 对应名称；无法支持的工具标识符一律不输出，因为 Antigravity 会警告无效工具名可能挂起 custom-agent 执行。

验证安装

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

• list-installed.js和doctor.js都在 scripts/ 目录下，是 ECC 自带的清单与体检脚本；
• 两条rg/Get-ChildItem命令用于确认 skill 的SKILL.md和 agent 定义确实落盘在.agents/对应子目录里。

最后在 Antigravity 里做界面确认：打开Settings > Customizations，确认工作区 skills 出现；然后新开一个会话，按精确名称调用其中一个 skill。release notes 给出的验证口径与此一致：安装后运行ecc doctor --target antigravity，再在新会话中于 Settings > Customizations 下核对工作区 skills（见 docs/releases/2.2.0/release-notes.md）。

已有旧版.agent/安装怎么办

Antigravity 仍能读取旧版.agent/rules和.agent/skills，但 ECC 现在以.agents/为规范布局。关键约束：不要手动重命名.agent，因为 ECC 的 install-state 里保存的是绝对托管路径。

正确做法是更新后重跑同一条 ECC 安装命令。ECC 会先写入并校验新的.agents/ecc-install-state.json，然后只删除由有效旧状态托管且未被修改的文件；被修改过和不受托管的文件保留在.agent/里，在处置之前仍能被 doctor 和卸载流程发现。

执行生命周期操作前可以先做干跑预览（--dry-run只预览不应用）：

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

常见问题

Skills 不出现

• 一个有效 skill 的路径必须是.agents/skills/<name>/SKILL.md；
• .agent/.agents/skills是旧版 ECC 构建遗留的嵌套布局，已废弃；
• 改动 skill 文件后必须新开会话。

Rules 不生效

• 确认文件直接在.agents/rules/下；
• 运行 doctor，检查是否有 managed 文件缺失或漂移的警告。

Workflows 不出现

• 确认文件位于.agents/workflows/下；
• 重启 Antigravity 后用/<workflow-name>调用。

更深入的细节可以对照 docs/ANTIGRAVITY-GUIDE.md 以及 docs/SELECTIVE-INSTALL-ARCHITECTURE.md 中的安装器生命周期契约；升级路径（先npm install -g发布包、再重跑原安装命令）见 docs/releases/2.2.0/release-notes.md。

【免费下载链接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.项目地址: https://gitcode.com/GitHub_Trending/ev/ECC