agent-skills 在 Antigravity CLIagy中的原生插件安装、技能调用与命令兼容性详解【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skillsagent-skills仓库可以将整套工程技能包spec、TDD、代码评审、发布检查等以原生插件形式安装进 Antigravity CLIagy让 Agent 获得结构化的工作流与专业角色personas。本文基于仓库中的 Antigravity 安装指南 展开完整覆盖两种安装方式、插件落盘位置、8 个生命周期斜杠命令在受影响的 agy 版本中的替代调用方式、技能的按需激活机制、AGENTS.md项目级约束、沙箱模式与常用操作提示并结合仓库内的 plugin.json、skills 目录 与 commands 目录 源码解释每条命令背后的真实调用关系帮助你在 Antigravity 环境下完整跑通“规格先行 → 增量实现 → 测试驱动 → 五轴评审 → 发布决策”的研发流程。插件安装远端安装、本地安装与 Gemini CLI 导入Antigravity CLI 提供了原生的插件系统用于注册 skills 与 agents。仓库的插件清单由 plugin.json 描述当前版本为0.6.8名称即agent-skills安装时 agy 会以此注册插件并展开skills/与agents/两个目录。方式一原生插件安装推荐从远端仓库直接安装agy plugin install https://gitcode.com/GitHub_Trending/agentskill/agent-skills从本地克隆安装先克隆仓库git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills再用agy安装插件agy plugin install /path/to/agent-skills安装过程会先校验插件结构然后将其安装进全局 Antigravity 配置目录~/.gemini/config/plugins/agent-skills/。注意当前 agy 版本中插件落在~/.gemini/config/plugins/下而不是旧版本使用的遗留路径~/.gemini/antigravity-cli/plugins/。如果在遗留路径下找不到插件请优先检查~/.gemini/config/plugins/agent-skills/。方式二从 Gemini CLI 导入如果你之前已经在旧版 Gemini CLI 中安装过agent-skills可以直接导入而无需重新拉取agy plugin import gemini两种路径装好后用同一命令验证插件处于激活状态agy plugin list生命周期命令与斜杠命令兼容性安装成功后最需要注意的是命令兼容性问题。仓库在 commands/ 目录下携带了 8 个遗留的 TOML 命令定义spec.toml、planning.toml、ship.toml等Antigravity 的迁移工具会将它们报告为“已转换为 skills”但在受影响的 agy 1.1.x 版本中转换后的包装命令并不会出现在斜杠命令或技能目录里——该问题已被记录为上游缺陷。因此agy plugin validate成功只说明 TOML 文件格式合法不代表/build等短命令可用重新安装或给 TOML 加name字段都无法绕过这一导入器限制官方文档明确警告不要给 TOML 文件添加 YAML frontmatter 作为变通手段。Gemini CLI 使用严格解析器读取这些 TOML---frontmatter 会使文件变成非法 TOML且对 Antigravity 的转换行为没有任何改善。在限制解除前应直接使用带命名空间的技能调用替代原短命令原短命令Antigravity 直接调用方式说明/spec/agent-skills:spec-driven-development在写代码前先产出结构化规格/planning/agent-skills:planning-and-task-breakdownAntigravity 自带的/planning命令是另一个 plan-mode 控制勿混淆/build/agent-skills:incremental-implementation同时调用/agent-skills:test-driven-development包装器专属的/build auto编排不可用/test/agent-skills:test-driven-development执行红-绿-重构red-green-refactor工作流/review/agent-skills:code-review-and-quality执行五轴评审工作流/code-simplify/agent-skills:code-simplification在不改变行为的前提下简化代码/ship/agent-skills:shipping-and-launch包装器中的自动 persona 扇出不可用需分别调用专家 Agent/webperf在/agents中选择web-performance-auditor该工作流是 persona 而非 skill从源码结构看这张表的每一条都有对应依据。以 commands/spec.toml 为例其prompt字段第一步就是“Invoke the spec-driven-development skill”随后要求先澄清目标与验收标准、再生成覆盖六大核心区域目标、命令、项目结构、代码风格、测试策略、边界的结构化规格并保存为项目根目录的SPEC.md——这正是 skills/spec-driven-development/SKILL.md 中“SPECIFY → PLAN → TASKS → IMPLEMENT”门控工作流的入口。同样commands/ship.toml 定义了/ship是一个扇出编排器并发派生code-reviewer、security-auditor、test-engineer三个子 Agent由主 Agent 汇总为带回滚方案的 GO/NO-GO 决策。在 Antigravity 中由于包装器不可用你需要手动完成等价动作先调用/agent-skills:shipping-and-launch再分别以子 Agent 形式调用三个专家角色。技能发现与按需激活机制Antigravity 会自动发现插件内skills/目录下的技能其匹配与激活依赖每个SKILL.md的 YAML frontmatter。仓库内 skills/ 目录包含 24 个技能如spec-driven-development、incremental-implementation、debugging-and-error-recovery等全部遵循 docs/skill-anatomy.md 定义的结构name与目录名一致的 kebab-case 命名description以第三人称说明技能做什么并包含一组明确的 “Use when” 触发条件。以 skills/spec-driven-development/SKILL.md 的 frontmatter 为例--- name: spec-driven-development description: Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when requirements are unclear, ambiguous, or only exist as a vague idea. ... ---发现与激活流程如下Antigravity 读取各技能的触发描述将其纳入意图匹配范围当你的任务与某个技能匹配时Agent 会加载该技能并在执行前向你请求权限意图到技能的映射示例设计一个新系统→ 激活spec-driven-development实现一个功能→ 激活incremental-implementation与test-driven-development修复一个 Bug→ 激活debugging-and-error-recovery。这种“frontmatter 即触发契约”的设计与仓库 AGENTS.md 中的编排哲学一致技能skills回答 how角色personas回答 who用户或命令是编排者。专业化 Agent 角色Personas插件同时注册了 agents/ 目录下的可复用子 Agent 定义。文档中重点列出的是三个agents/code-reviewer.md — 资深代码评审按正确性、可读性、架构、安全、性能五个维度给出分类反馈与/review包装器中的“five-axis review”对应agents/test-engineer.md — QA 工程师专注测试策略、测试编写与覆盖率分析遵循“纯逻辑 → 单元测试、跨边界 → 集成测试、关键用户流 → E2E”的分层原则agents/security-auditor.md — 安全审计角色覆盖漏洞与威胁建模。此外/webperf行对应的 agents/web-performance-auditor.md 也是该目录中的成员它是一个围绕 Core Web Vitals 的审计 persona提供 quick 模式源码静态扫描结论标注为 potential impact与 deep 模式解析 Lighthouse/PSI/CrUX JSON 产物两种工作模式。这些角色可以在会话中直接调用也可在委派子任务时使用。验证与故障排查确认插件结构完整、包含所有技能使用agy plugin validate /path/to/agent-skills然后开启一个新会话输入/agent-skills:查看带命名空间的技能目录。排查要点若验证器报告命令已转换但/build返回No matches直接按上一节的“直接调用”方式操作——这是已知导入器限制重装或加 TOMLname字段均无效若agy plugin list中看不到插件先检查新版路径~/.gemini/config/plugins/agent-skills/而非遗留的~/.gemini/antigravity-cli/plugins/。配置与定制项目级强制约束AGENTS.md如果需要强制技能合规例如要求写代码前必须先有 spec 或 plan可将AGENTS.md复制或链接到你的工作区根目录。Antigravity CLI 会读取该文件使 Agent 的行为与规划阶段对齐团队约定。需要注意的是仓库自带的 AGENTS.md 是为维护本仓库自身而配置的其中声明“不适用于复制到其他项目”你可以参考其写法为自己的项目编写一份其中“意图 → 技能映射”Feature → spec → incremental → TDDBug → debugging-and-error-recovery 等是可直接借鉴的模板。沙箱模式当你要运行技能或脚本但希望限制终端权限例如执行第三方验证测试时更安全用以下参数启动 CLIagy --sandbox使用技巧保持插件更新通过agy update更新 CLI 或检查更新的插件版本执行前评审当 Agent 使用这些技能执行复杂重构时按Ctrlr进入Artifact Review界面在提交前审查、编辑或批准代码权限控制--dangerously-skip-permissions标志仅在受信任的本地项目中使用用于绕过手工工具审批提示。小结在 Antigravity 环境下使用agent-skills核心动作可以归纳为三步agy plugin install远端或本地克隆完成安装agy plugin validate/agent-skills:目录确认可用性之后用命名空间技能调用如/agent-skills:spec-driven-development、/agent-skills:test-driven-development替代受限制的短命令。理解了 frontmatter 触发契约、agents/角色与commands/TOML 包装器之间的对应关系你就能在 Antigravity 中完整复用这套“规格 → 计划 → 增量实现 → 评审 → 发布”的生产级工程流程。【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考