iamaanahmad/everything-antigravity

Everything Antigravity

Google Antigravity 生态系统的权威配置集合。

使用生产就绪的代理、技能、钩子、命令、规则和 MCP 配置，释放你的 Antigravity 助手的全部潜力。针对 Antigravity 2.0 的动态子代理、异步自动化和企业集成进行了全面优化。经过实战检验的模式源自真实世界的开发实践。

支持的生态系统

这些配置与整个 Antigravity 套件 100% 兼容：
- Antigravity 2.0： 驱动并行子代理和自动化的核心代理平台。
- Antigravity IDE： 用于可视化开发和代码管理的独立桌面应用。
- Antigravity CLI： 用于本地编排的快速、终端优先界面。
- Antigravity SDK： 用于构建自定义编程代理的开发者工具包。

内容概览

此仓库提供了一套全面的工具，旨在增强你使用 Antigravity 的工作流：

everything-antigravity/
├── agents/           # 用于委派的专用子代理
│   ├── planner.md           # 功能实现规划
│   ├── architect.md         # 系统设计决策
│   ├── code-reviewer.md     # 质量与安全审查
│   ├── tdd-guide.md         # 测试驱动开发
│   ├── security-reviewer.md # 漏洞分析
│   ├── build-error-resolver.md # TypeScript/构建错误修复
│   ├── e2e-runner.md        # Playwright E2E 测试
│   ├── refactor-cleaner.md  # 死代码清理
│   └── doc-updater.md       # 文档同步
│
├── skills/           # 工作流定义和领域知识
│   └── coding-standards/    # 语言最佳实践
│
├── commands/         # 用于快速执行的斜杠命令
│   ├── tdd.md               # 测试驱动开发工作流
│   ├── plan.md              # 实现规划
│   ├── code-review.md       # 代码审查
│   ├── build-fix.md         # 增量构建错误修复
│   ├── checkpoint.md        # 工作流检查点
│   ├── e2e.md               # E2E 测试生成与执行
│   ├── eval.md              # 评估驱动开发
│   ├── learn.md             # 提取可复用模式
│   ├── orchestrate.md       # 多代理工作流编排
│   ├── refactor-clean.md    # 安全移除死代码
│   ├── test-coverage.md     # 覆盖率分析与测试生成
│   ├── update-codemaps.md   # 架构文档
│   ├── update-docs.md       # 文档同步
│   └── verify.md            # 全面验证
│
├── rules/            # 始终遵循的准则
│   ├── security.md          # 强制性安全检查
│   ├── coding-style.md      # 代码风格与约定
│   ├── git-workflow.md      # Git 工作流准则
│   ├── testing.md           # 测试要求
│   ├── patterns.md          # 常见模式
│   ├── performance.md       # 性能准则
│   └── agents.md            # Agent 编排指南
│
├── contexts/         # 特定模式的上下文
│   ├── dev.md               # 开发模式
│   ├── research.md          # 研究模式
│   └── review.md            # 代码审查模式
│
└── skills/           # 工作流定义和领域知识
├── coding-standards.md  # 语言最佳实践
├── backend-patterns/    # 后端架构模式
├── frontend-patterns/   # React/Next.js 模式
├── tdd-workflow/        # TDD 工作流模式
├── security-review/     # 安全检查清单和模式
└── verification-loop/   # 验证系统

快速开始

1. 安装

将此仓库克隆到你的项目中，或将特定组件集成到你的 Antigravity 配置中。

git clone https://github.com/iamaanahmad/everything-antigravity.git
cd everything-antigravity

2. 配置 Agents

将所需的 agents 从 agents/ 复制到你的 .agents/agents/ 目录（用于项目范围）或 ~/.gemini/config/agents/（用于全局范围）。

Copy all agents
cp agents/.md .agents/agents/

Or copy specific agents
cp agents/planner.md .agents/agents/
cp agents/code-reviewer.md .agents/agents/

3. 设置规则

通过将 AGENTS.md 复制到你的 .agents/ 自定义根目录来建立项目范围的规则。

cp AGENTS.md .agents/AGENTS.md

4. 添加 Skills

复制 skills 以增强 Antigravity 的领域知识：

cp -r skills/ .agents/skills/

5. 配置 MCP 服务器

复制 MCP 服务器配置，并将占位符替换为你的实际 API 密钥：

cp mcp-configs/mcp-servers.json .agents/mcp-servers.json
Edit the file and replace YOUR_*_HERE with actual values

核心概念

Agents

将特定任务委托给专门的子代理。利用 Antigravity 2.0 的 Dynamic Subagents 能力，允许生成这些专门的代理以并行执行任务，而不会使你的主上下文变得杂乱。例如，code-reviewer 代理仅专注于代码质量和安全性。

可用的 Agents：

| Agent | 用途 | 使用时机 |
|-------|---------|-------------|
| planner | 创建实现计划 | 在开始新功能之前 |
| architect | 系统设计决策 | 架构变更、可扩展性 |
| code-reviewer | 质量与安全审查 | 编写/修改代码之后 |
| tdd-guide | 测试驱动开发 | 编写新功能、修复 bug |
| security-reviewer | 漏洞检测 | 处理用户输入、认证、敏感数据 |
| build-error-resolver | 修复 TypeScript/构建错误 | 当构建失败时 |
| e2e-runner | Playwright E2E 测试 | 测试关键用户旅程 |
| refactor-cleaner | 死代码清理 | 移除未使用的代码、重构 |
| doc-updater | 文档同步 | 更新文档、生成代码地图 |

Skills
定义可复用的工作流和领域知识。coding-standards 技能提供特定语言的最佳实践。

可用技能：
- coding-standards - 命名约定、代码结构、文档标准
- backend-patterns - 后端架构、API 设计、数据库模式
- frontend-patterns - React/Next.js、状态管理、性能模式
- tdd-workflow - 包含单元、集成和 E2E 模式的完整 TDD 工作流
- security-review - 全面的安全检查清单和模式
- verification-loop - 质量门禁的验证系统

命令

使用简单的斜杠命令执行复杂任务。

原生 Antigravity 2.0 命令（内置）：
- /goal - 自主运行长时间任务，直到目标达成为止，中途不停。
- /schedule - 为异步自动化设置周期性 cron 或一次性定时器。
- /grill-me - 通过交互式访谈就计划达成一致。
- /browser - 启动浏览器子代理与网页交互。
- /learn - 自动提取模式并持久化行为。

自定义工作流命令（包含在此仓库中）：
- /tdd - 测试驱动开发
- /plan - 实现规划
- /code-review - 代码审查
- /build-fix - 增量式构建错误修复
- /checkpoint - 工作流检查点
- /e2e - E2E 测试生成与执行
- /eval - 评估驱动开发
- /learn - 将可复用模式提取为技能
- /orchestrate - 多代理工作流编排
- /refactor-clean - 安全移除死代码
- /test-coverage - 覆盖率分析与测试生成
- /update-codemaps - 架构文档
- /update-docs - 文档同步
- /verify - 全面的代码库验证

规则

适用于所有代码的始终遵循的准则。规则由 Antigravity 自动强制执行。

可用规则：
- security.md - 强制性安全检查（密钥、输入验证、认证）
- coding-style.md - 代码风格和命名约定
- git-workflow.md - Git 工作流和提交准则
- testing.md - 测试要求和 TDD 工作流
- patterns.md - 常见可复用模式
- performance.md - 性能优化准则
- agents.md - 代理编排和模型选择

上下文

针对特定模式（开发、研究、审查）的动态系统提示注入。

可用上下文：
- dev.md - 活跃开发模式
- research.md - 研究与探索模式
- review.md - 代码审查模式

MCP 服务器

模型上下文协议服务器提供外部集成（GitHub、数据库、API）。

已配置的服务器：
- github - GitHub 操作（PR、issue、仓库）
- firecrawl - 网页抓取和爬取
- supabase - PostgreSQL 数据库操作
- memory - 跨会话的持久化记忆
- sequential-thinking - 思维链推理
- vercel - Vercel 部署和项目
- filesystem - 文件系统操作

使用示例

规划新功能

用户：我需要添加市场结算时的实时通知

Antigravity：让我为你创建一个实现计划。
[调用 planner agent]

Planner Agent：
实现计划：实时市场结算通知

需求
- 当用户关注的市场结算时向其发送通知
- 支持多种渠道（应用内、电子邮件、webhook）
- 确保可靠投递

实现阶段

阶段 1：数据库架构
- 添加 notifications 表
- 添加 user_notification_preferences 表
- 创建索引

阶段 2：通知服务
- 创建通知服务
- 使用 Redis 实现队列
- 添加重试逻辑

阶段 3：集成点
- 接入市场结算逻辑
- 查询持有仓位的用户
- 将通知加入队列

阶段 4：前端组件
- 创建 NotificationBell 组件
- 添加 NotificationList 模态框
- 实现实时更新

风险
- 高：电子邮件送达率
- 中：每个市场 1000+ 用户时的性能

等待确认：是否继续？（yes/no/modify）

代码审查

用户：审查我的更改

Antigravity：正在运行代码审查...
[调用 code-reviewer agent]

Code Reviewer：
代码审查报告

严重问题（必须修复）

1. 硬编码 API 密钥
文件： src/api/client.ts:42
问题： API 密钥暴露在源代码中
typescript
// ❌ 错误
const apiKey = "sk-abc123"

// ✅ 正确
const apiKey = process.env.API_KEY

高优先级问题（应当修复）

2. 缺少输入验证
文件： src/api/markets.ts:15
问题： 在数据库查询前未验证用户输入

建议： ❌ 阻止 - 在合并前修复严重问题

测试驱动开发

用户：/tdd 实现市场搜索功能

Antigravity：正在启动 TDD 工作流...
[调用 tdd-guide agent]

TDD Guide：
步骤 1：编写失败的测试（RED）
typescript
describe('searchMarkets', () => {
it('returns markets matching query', async () => {
const results = await searchMarkets('election')
expect(results).toHaveLength(5)
})
})

正在运行测试... ❌ 失败（预期如此 - 尚无实现）

步骤 2：编写最小实现（GREEN）
typescript
export async function searchMarkets(query: string) {
// 最小实现
return await db.markets.search(query).limit(5)
}

正在运行测试... ✅ 通过

步骤 3：重构（IMPROVE）

[在保持测试通过的同时提出改进建议]

最佳实践

Agent 使用

1. 编码前使用 planner - 在实现前规划复杂功能
2. 更改后使用 code-reviewer - 在提交前审查所有代码
3. 新功能使用 tdd-guide - 先编写测试，再实现
4. 敏感代码使用 security-reviewer - 审查认证、支付、用户输入
5. 遇到困难时使用 build-error-resolver - 高效修复 TypeScript 错误

技能开发
1. 保持技能专注 - 每个领域一个技能（后端、前端、安全）
2. 定期更新 - 随着模式的出现演进技能
3. 记录示例 - 在技能中包含代码示例
4. 版本控制 - 在 git 中跟踪技能变更

规则管理

1. 保持规则精简 - 只强制执行关键准则
2. 使规则具体明确 - 模糊的规则难以遵循
3. 提供示例 - 展示好的和坏的模式
4. 定期审查 - 移除过时的规则

MCP 配置

1. 不要启用所有 MCP - 每个项目启用的数量保持在 10 个以下
2. 使用项目特定的配置 - 不同项目需要不同的工具
3. 保护你的密钥 - 永远不要将 API 密钥提交到 git
4. 监控上下文使用情况 - 过多的 MCP 会减少可用的上下文

自定义

这些配置只是起点。根据你的技术栈进行自定义：

针对你的语言/框架

创建语言特定的技能：
skills/
├── python-conventions/
├── react-patterns/
├── go-best-practices/
└── rust-patterns/

针对你的领域

创建领域特定的代理：
agents/
├── ml-engineer.md        # 机器学习专家
├── devops-specialist.md  # 基础设施和部署
├── data-engineer.md      # 数据管道和 ETL
└── mobile-developer.md   # iOS/Android 开发

针对你的团队

将团队特定的规则添加到你的 AGENTS.md 文件中：
AGENTS.md
- 团队编码风格
- 团队 Git 工作流
- 团队审查流程
- 团队部署

贡献

欢迎贡献！ 如果你有适用于 Antigravity 的有用代理、技能或配置，请提交 pull request。

贡献的想法

- 语言特定的技能（Python、Go、Rust 模式）
- 框架特定的配置（Django、Rails、Laravel）
- DevOps 代理（Kubernetes、Terraform、AWS）
- 测试策略（不同的框架）
- 领域特定的知识（ML、数据工程、移动端）

有关指南，请参阅 CONTRIBUTING.md。

重要说明

上下文窗口管理

关键： 不要一次性启用所有 MCP。启用过多工具会显著缩小你的上下文窗口。

经验法则：
- 配置 20-30 个 MCP
- 每个项目启用的数量保持在 10 个以下
- 监控上下文使用情况

安全

永远不要提交机密信息：
- 使用环境变量存储 API 密钥
- 将 .env 添加到 .gitignore
- 使用 .env.example 进行文档说明
- 如果意外提交，请轮换密钥

性能

为速度进行优化：
- 为特定任务使用特定代理
- 保持技能专注且简洁
- 禁用未使用的 MCP 服务器
- 监控 token 使用情况

与 Claude Code 的比较

本仓库受 everything-claude-code 启发，但专门针对 Google 的 Antigravity IDE 进行了调整。

主要区别：
- Antigravity 特定的代理配置
- Gemini 模型引用（gemini-2.0-pro-exp）
- Antigravity 工作流模式
- Antigravity 的上下文管理

共享概念：
- 基于代理的委托
- 用于领域知识的技能
- 始终遵循的规则指南
- MCP 服务器集成

资源

- Antigravity 文档： [Antigravity 文档链接]
- MCP 协议： https://modelcontextprotocol.io
- 灵感来源： everything-claude-code

许可证

MIT - 自由使用，按需修改，如果可以，请回馈贡献。

为使用 Google Deepmind 的 Antigravity 进行编码的未来而构建。

如果这个仓库对你有帮助，请给它加星。根据你的需求进行定制。构建一些伟大的东西。