企业官网建设流程全解析

如何为 Antigravity CLI 安装 agent-skills 插件并用 /agent-skills: 前缀首次调用技能？

【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills

你的任务是把 agent-skills 以原生插件形式装进 Antigravity CLI（agy），让 agent 获得 25 个工程流程技能（skills/目录下的SKILL.md）和agents/目录中的专家 persona，然后在新会话里用/agent-skills:前缀确认技能目录并完成首次调用。文档 docs/antigravity-setup.md 给出了完整的安装、验证与调用路径；需要留意的是，在受影响的agy1.1.x 版本中，仓库里commands/*.toml的短命令包装器（如/build）不会出现在斜杠命令目录里，正确做法是直接调用/agent-skills:命名空间下的技能，这一点后文有具体对照表。

安装插件：一条命令或本地克隆

主路径——从远程仓库安装：

agy plugin install https://github.com/addyosmani/agent-skills.git

这条命令会先校验插件结构，再安装到你的全局 Antigravity 配置目录~/.gemini/config/plugins/agent-skills/。注意路径规则：当前 agy 版本把插件放在~/.gemini/config/plugins/下，而不是旧版本使用的~/.gemini/antigravity-cli/plugins/。如果你在旧路径下找不到插件，先检查~/.gemini/config/plugins/agent-skills/。

可选分支一——从本地克隆安装：

git clone https://github.com/addyosmani/agent-skills.git agy plugin install ./agent-skills

第二条命令中的./agent-skills是克隆到当前目录后的相对路径；如果你的克隆位置不同，替换为对应的本地路径即可。

可选分支二——从旧版 Gemini CLI 导入：如果你之前已经在遗留的 Gemini CLI 安装下装过 agent-skills，可以直接导入：

agy plugin import gemini

验证插件已装好

装完后做两级验证：

1. 确认插件在生效列表中：

   agy plugin list

2. 对本地插件结构做完整校验（确认它结构正确且包含全部技能）。命令里的/path/to/agent-skills是占位路径，替换成你本地的克隆目录，例如上一步克隆出来的./agent-skills：

   agy plugin validate /path/to/agent-skills

第二级校验有一个容易被误读的地方：agy plugin validate成功只说明commands/*.toml这些文件格式合法，不代表/build等短命令包装器已经可用。在受影响的agy1.1.x 版本中，迁移工具会把 8 个遗留命令定义报告为“converted to skills”，但这些转换后的包装器不会出现在斜杠命令或技能目录里。

首次调用：用 /agent-skills: 前缀查看命名空间目录

开启一个全新会话，输入：

/agent-skills:

这会列出带命名空间的技能目录，让你确认技能确实被注册进来。之后的调用都用/agent-skills:<技能名>的形式。由于上述导入器限制，仓库中 8 个短命令包装器在 Antigravity 里的对应直接调用方式如下（来自 docs/antigravity-setup.md）：

首次调用后你会观察到技能按文档描述的方式工作：Antigravity 自动发现插件skills/目录内的技能，按任务意图匹配，匹配命中后 agent 会加载该技能并在执行前向你请求权限。所以“技能被触发 + 出现权限提示”本身就是安装成功的直接信号。

遇到 No matches 时的判断

如果agy plugin validate报告命令已转换，但你输入/build返回No matches，这是文档记录的已知导入器限制，不是安装错误：

• 不要通过重新安装或给 TOML 加name字段来“修复”，文档明确说明这两种方式都不能解决该限制；
• 改为使用上面表格中的/agent-skills:直接调用；
• 也不要给commands/*.toml加 YAML frontmatter 作为绕法——Gemini CLI 用严格的解析器读这些 TOML，---frontmatter 会让它们变成无效 TOML，且不改变 Antigravity 的转换行为。

可选的项目级配置

以下两项不是首次调用所必需，属于装完之后的可选收紧项：

• 项目内强制技能约束：把仓库根目录的 AGENTS.md 复制或链接到你的工作区根目录。Antigravity CLI 会读取这个文件，使 agent 的行为和规划阶段对齐团队约定（例如要求先有 spec 或 plan 才能写代码）。
• 沙箱模式：如果要以受限的终端权限运行技能或脚本（跑第三方校验测试时更安全），用agy --sandbox启动 CLI。

另外，执行复杂重构类任务时可以用Ctrl+r进入 Artifact Review 界面，在提交前审查、编辑或批准代码；--dangerously-skip-permissions参数只建议在你信任的本地项目中使用，它用于绕过手动工具审批提示。

安装后的状态确认

到此可以按以下条件确认安装与首次调用完成：agy plugin list中能看到 agent-skills 插件；agy plugin validate对本地插件目录校验通过；新会话中输入/agent-skills:能看到命名空间技能目录，且至少一次直接调用（例如/agent-skills:code-review-and-quality）能触发技能加载和权限提示。已知边界是：在受影响的agy1.1.x 版本里，短命令包装器持续不可发现，这是上游已跟踪的限制，日常使用一律走/agent-skills:直接调用即可。

【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills