第5篇：实践篇——Antigravity从0到1完整配置workflow
手把手搭建三件套环境
5.1 环境准备
安装Antigravity
从Google官网下载最新版Antigravity（目前预览阶段）。
首次启动配置：
| 配置项 | 推荐选择 | 说明 |
|---|---|---|
| 开发模式 | Review-driven | 每步操作请求审批，可追溯 |
| Terminal policy | Auto | 安全命令自动执行 |
| Review policy | Request Review | 阶段性产物需人工批准 |
安装Node.js和OpenSpec
bash
# 检查Node版本（需要20.19+）
node --version
# 安装OpenSpec
npm install -g openspec-cn/openspec
# 验证安装
openspec --version
5.2 第一步：配置Karpathy Skills
创建全局规则文件
bash
# 在项目根目录创建.claude文件夹
mkdir -p .claude
# 创建规则文件
cat > .claude/rules.md << 'EOF'
# Karpathy Coding Principles - Global Rules
## Principle 1: Think Before Coding
Before writing any code, output:
- 【理解】What I need to do
- 【假设】My assumptions
- 【边界】Edge cases
- 【待确认】Questions
## Principle 2: Simplicity First
- Maximum 50 lines per function
- No abstract classes unless 3+ implementations exist
- No "future" features
## Principle 3: Surgical Changes
- Maximum 3 files modified per task
- Do not reformat unmodified code
## Principle 4: Goal-Driven
- Every "complete" claim requires test output as evidence
EOF
验证Karpathy生效
在Agent面板输入模糊需求，预期输出【理解】【假设】【边界】【待确认】格式。
5.3 第二步：安装Superpowers
全局安装Skills
bash
# 克隆到全局目录
git clone https://github.com/obra/superpowers.git ~/.gemini/antigravity/skills/superpowers
在项目中创建软链接
bash
# 创建skills目录
mkdir -p .agent/skills
# 创建软链接
ln -s ~/.gemini/antigravity/skills/superpowers .agent/skills/superpowers
# 验证
ls -la .agent/skills/
# 应该看到: superpowers -> /Users/.../.gemini/antigravity/skills/superpowers
5.4 第三步：安装OpenSpec
bash
# 在项目根目录初始化
openspec init
# 检查目录结构
ls -la openspec/
# 应该看到: changes/ specs/ config.yaml
创建第一个变更
bash
/opsx:new financial-event-analyst-agent
系统生成：
openspec/changes/financial-event-analyst-agent/proposal.mdopenspec/changes/financial-event-analyst-agent/tasks.mdopenspec/changes/financial-event-analyst-agent/design.mdopenspec/changes/financial-event-analyst-agent/specs/
5.5 第四步：改造OpenSpec Workflow
创建Workflow文件
bash
mkdir -p .agent/workflows
创建.agent/workflows/opsx-apply.md，内容见第6篇。
创建工作流入口
创建AGENTS.md：
markdown
# 项目AI规范
## 全局规则
严格遵守`.claude/rules.md`的Karpathy原则。
## 技能调用
- 编码前思考：由Karpathy自动生效
- TDD：`@superpowers/test-driven-development`
- 代码审查：`@superpowers/requesting-code-review`
## OpenSpec集成
执行`/opsx:apply`时，自动按5阶段流程执行。
5.6 完整测试
测试Karpathy
text
帮我实现一个获取股票新闻的函数
预期：输出【理解】【假设】【边界】【待确认】，而非直接写代码。
测试Superpowers
text
@superpowers/brainstorming
需求：做一个股票新闻检索系统，需要对比技术方案
预期：输出3个方案对比表格。
测试OpenSpec
bash
/opsx:apply financial-event-analyst-agent
预期：按5阶段流程执行第一个任务。
5.7 今天对话中的干货
软链接不存在的处理
如果ls -la .agent/skills/看不到链接，执行：
bash
# 查找全局skills实际位置
find ~ -type d -name "superpowers" 2>/dev/null
# 用实际路径创建链接
ln -s /实际/路径/superpowers .agent/skills/superpowers
Workflow不生效的处理
- 检查文件路径：
.agent/workflows/opsx-apply.md - 检查frontmatter格式：文件开头必须是
--- - 重启Antigravity：
Cmd+Shift+P→Reload Window
核心洞见
“Antigravity的.agent/目录是配置的核心——skills放这里，workflows放这里，rules也放这里。理解这个结构，就掌握了Antigravity的扩展机制。”
