Antigravity Customizations: Skills、Rules 与插件扩展体系

---
name: code-review
description: 自动审查 Git 变更集中的安全性、性能与 TypeScript 类型完整度，输出精简修复建议
---

# 自动化代码审查规范 (Code Review Guidelines)

当用户请求对当前分支或提交进行代码审查时，按以下顺序执行：

1. **差异比对**：通过 `run_command` 执行 `git diff HEAD~1` 获取最新改动。
2. **安全核对**：检查是否存在明文 API 密钥、未经转义的输入注入或不安全的 `eval` 调用。
3. **性能与类型**：确认异步异常已被妥善捕获，无冗余 `any` 类型声明。
4. **输出标准**：输出格式遵循 GitHub Flavored Markdown，直接提供带有具体行号的精准修正建议。

Antigravity 定制体系三大支柱

在 Antigravity 2.0 中，定制化并不是通过松散的 Prompt 碎片拼接完成的，而是由三个严格分层的系统共同构建：

+-----------------------------------------------------------+
|                      Antigravity 平台                      |
+-----------------------------------------------------------+
         |                        |                        |
         v                        v                        v
+------------------+     +------------------+     +------------------+
|   Rules (规则库)  |     |   Skills (技能包) |     |  Plugins (插件总线)|
| - 永久生效的行为约束 |     | - 任务驱动按需唤起  |     | - 命名空间集成打包  |
| - 编码风格/命名规范  |     | - 含独立脚本与工件  |     | - 包含 MCP 守护进程 |
+------------------+     +------------------+     +------------------+

---

1. Rules（行为规则约束）

Rules 负责定义 Agent 必须始终遵守的行为准则。 它们在会话启动时就会自动注入到上下文环境中，用于锁定 Agent 的身份、响应风格、分支策略或安全红线。

存放路径

• 全局生效：~/.gemini/config/rules/*.md 或 ~/.gemini/config/GEMINI.md
• 项目独享：.agents/rules/*.md 或项目根目录下的 GEMINI.md / AGENTS.md

生产级 Rule 范例

# 项目工程规范约束
- 所有对外暴露的 API 函数必须显式标注 TypeScript 严格返回类型。
- 禁止直接使用 console.log，必须通过 src/logger.ts 统一记录。
- 严禁随意创建全局临时文件，测试代码统一放在 scratch/ 目录下。

---

2. Skills（按需唤起的技能体系）

Skills 是 Antigravity 最具威力的创新之一。它们是即插即用的领域工作流手册。 Agent 在初始阶段只了解所有 Skill 的名称与简要描述（不会将整个文件读入上下文），仅当用户的请求匹配到某个 Skill 的应用场景时，Agent 才会动态调用 view_file 阅读完整的 SKILL.md，执行内部包含的精细步骤。

标准 Skill 目录结构

skills/<skill_name>/
├── SKILL.md          # 核心指令（必须包含 YAML Frontmatter 元数据）
├── scripts/          # 专用可执行脚本（Bash, Python, Node 等）
├── examples/         # 输入/输出范例参考
└── references/       # 深度规范与架构手册

SKILL.md 规范说明

1. YAML Frontmatter：必须位于文件最上方，包含 name 与简明的 description。Agent 根据 description 判断是否要激活该技能。
2. 执行流程（Workflow）：分步骤清晰列举 Agent 的操作顺序、所调用的工具以及判定完成的基准条件。
3. 防护边界（Guardrails）：明确说明“禁止做什么”，防止智能体做出过度破坏性的重构。

---

3. Plugins（企业级插件打包方案）

当你需要将一组高度协作的 Skills、Subagents 以及专属的 Sidecar MCP 配置文件分发给团队其他成员时，可以使用 Plugins。

插件目录组织

plugins/<plugin_name>/
├── plugin.json       # 插件元信息（名称、版本、作者）
├── skills/           # 插件内包含的专属技能集合
│   └── custom-deploy/
│       └── SKILL.md
├── agents/           # 专属子代理定义
└── mcp_config.json   # 随插件一同启动的 Sidecar MCP 配置

通过将插件目录软链接至 ~/.gemini/config/plugins/，团队可以在数秒内同步一整套经过自动化验证的智能体开发套件。