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

发布时间:2026/9/11 8:18:22
如何在 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/ECCGoogle 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-universal2.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 goPowerShell 遵循同样的项目根目录作为工作目录约定# $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.mdECC 源Antigravity 目标用途rules/.agents/rules/工作区规则拍平为防冲突的文件名commands/.agents/workflows/用户可调用的 slash 工作流skills/name/.agents/skills/name/带必需SKILL.md的 Agent Skillsagents/name.md.agents/agents/name.md自定义主 agent 与 subagent安装完成后的项目目录应形如文档示例结构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 的 frontmatterClaude 模型层级变成flash或proClaude 工具名换成 Antigravity 对应名称无法支持的工具标识符一律不输出因为 Antigravity 会警告无效工具名可能挂起 custom-agent 执行。验证安装macOS 和 Linuxnode $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 *.mdPowerShell 等价命令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 *.mdlist-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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考