Google AntiGravity 的新功能“Agent Skills”能让智能体进化为自律的专家。然而，要发挥其真价值，必须为其准备一个合适的 “栖息地（Habitat）” 。

本文将为您带来基于 2026 年最佳实践的 “推荐文件夹结构” 和 “配置文件（Config）” 完全指南。

1. 目录结构定案 (Standard Structure)

2026 年的标准结构如下。维持这种结构能让智能体在获取上下文时不再迷路。

推荐目录结构

.
├── .antigravity/ # 智能体的“大脑”与“配置”
│ ├── skills/ # 独立的技能（按任务划分）
│ │ ├── create-article/
│ │ │ ├── SKILL.md # 操作指南 (详细 SOP)
│ │ │ └── scripts/ # 专用工具 (Python/TS)
│ │ └── deploy/
│ ├── rules/ # 全局行为准则
│ │ └── rules.md # 项目通用的约数
│ └── README.md # 面向智能体的项目概要
├── .agent/ # (Legacy) 旧版本的任务流
└── src/ # 源代码

为什么要采用这种结构？

• Self-Contained (自包含性) ：将脚本放置在 skills/ 内部，能确保只有在使用该技能时才会加载相关工具（即时上下文/Just-In-Time Context）。
• Clear separation (清晰的分离) ：将 rules/（应遵守的规则）与 skills/（应完成的任务）明确分开。

2. 配置文件：该写些什么？

① .antigravity/rules/rules.md

描述智能体在整个项目中“必须绝对遵守”的约束。

# Agent Rules

## Code Style

- **Framework** : Astro v5 + React
- **Language** : TypeScript (Strict mode)
- **Styling** : Tailwind CSS (Utility-first)

## Forbidden Actions

- ❌ 切勿修改 `legacy/` 目录。
- ❌ 切勿使用 `npm` 或 `yarn`。请始终使用 `pnpm`。

② .antigravity/skills/[skill-name]/SKILL.md

执行特定任务的详细操作指南。

---
name: create-feature
description: 实现新功能的标准流程。采用测试驱动开发 (TDD)。
---
# 步骤
1. **理解需求** ：分析用户需求，列出用例。
2. **编写测试** ：在 `src/tests/` 中编写失败的测试用例。
3. **实现功能** ：编写能使测试通过的最简代码。
4. **重构** ：整理代码，使其符合 `rules.md` 的规范。

3. 推荐的 VS Code 设置

为了与 AntiGravity 智能体愉快地协作而进行的设置。

.vscode/settings.json

{
 "antigravity.agent.mode": "auto, // 根据任务自动切换 Plan/Fast 模式
 "antigravity.security.sandbox": "strict", // 拦截具有破坏性的命令
 "files.exclude": {
 " **/.antigravity/cache": true // 隐藏智能体的思考日志
 }
}

4. 与智能体的“共存” Git 流程

为了防止智能体进行的更改与人工更改发生冲突而制定的运营法则。

1.** Agent Branch **：重大任务（如重构等）让智能体在专用的分支（如 agent/refactor-auth）中进行。

2.** Conventional Commits **：强制智能体遵循特定的提交信息格式。

• feat(auth): add login flow
• fix(ui): correct color contrast

3.** Review First**：智能体的产出必须始终作为 PR（Pull Request）处理，经人工审核后再合并。

总结：环境塑造智能

正如优秀的工程师会考究其桌面环境一样，优秀的智能体也需要“整洁的目录”和“明确的规则文件”。

建议将此结构保存为模板，在每个新项目中进行复制使用。这样，智能体从第一天起就能像“资深员工”一样高效工作。

同时也请参考智能体设置的实战演示视频。