# Agent 配置迁移总结

## 📋 迁移概览

已成功将 Antigravity Agent 配置迁移到 OpenCode 格式。

**迁移日期**: 2026-02-14  
**源格式**: Antigravity `.agent/` Markdown prompts  
**目标格式**: OpenCode `.opencode/agents/` Markdown + JSON

---

## 📁 文件映射

| 原始文件 (Antigravity) | OpenCode 文件 | 状态 |
| --- | --- | --- |
| `.agent/agent_team_coordinator_prompt.md` | `.opencode/agents/team.md` | ✅ 已迁移（主 Agent） |
| `.agent/planning_agent_prompt.md` | `.opencode/agents/planning.md` | ✅ 已迁移 |
| `.agent/frontend_expert_agent_prompt.md` | `.opencode/agents/frontend.md` | ✅ 已迁移 |
| `.agent/umi_pro_agent_prompt.md` | `.opencode/agents/umi-pro.md` | ✅ 已迁移 |
| `.agent/code_spec_expert_prompt.md` | `.opencode/agents/code-spec.md` | ✅ 已迁移 |
| `.agent/qa_tester_agent_prompt.md` | `.opencode/agents/qa-tester.md` | ✅ 已迁移（添加 MCP） |
| N/A | `opencode.json` | ✅ 新建（配置文件） |
| N/A | `.opencode/README.md` | ✅ 新建（文档） |

**重要变更**:

- **Team Coordinator**: 从协调提示转换为主 Agent (`mode: primary`)
- **Model 配置**: 所有 Agent 移除 model 配置，由 OpenCode 统一管理
- **QA Tester**: 添加 Chrome DevTools MCP 集成说明

---

## 🔄 格式转换详情

### OpenCode 特有的 YAML Frontmatter

每个 Agent 文件添加了标准的 frontmatter：

```yaml
---
description: 代理的简要描述
mode: subagent
model: anthropic/claude-sonnet-4-20250514
temperature: 0.1-0.3
tools:
  write: true/false
  edit: true/false
  bash: true/false
---
```

### 权限配置

| Agent     | Write | Edit | Bash | 说明                     |
| --------- | ----- | ---- | ---- | ------------------------ |
| Planning  | ❌    | ❌   | ❌   | 只读，仅规划             |
| Frontend  | ✅    | ✅   | ✅   | 完全访问，可实施         |
| Umi Pro   | ✅    | ✅   | ✅   | 完全访问，可实施         |
| Code Spec | ✅    | ✅   | ❌   | 可编辑代码，无系统命令   |
| QA Tester | ❌    | ❌   | ✅   | 可运行测试，不可编辑代码 |

### 温度设置

| Agent     | Temperature | 原因                   |
| --------- | ----------- | ---------------------- |
| Planning  | 0.2         | 需要稳定、确定性的规划 |
| Frontend  | 0.3         | 平衡创造力与稳定性     |
| Umi Pro   | 0.3         | 平衡创造力与稳定性     |
| Code Spec | 0.1         | 需要高度一致的代码审查 |
| QA Tester | 0.2         | 需要系统化的测试方法   |

---

## 🎯 核心能力保留

所有原始 Agent 的核心能力都已完整保留并转换为 OpenCode 格式：

### 1. Planning Agent

- ✅ 深度代码库分析
- ✅ "Separated Card" 设计模式规划
- ✅ API 契约驱动开发
- ✅ Context7 MCP 集成
- ✅ 只读限制

### 2. Frontend Expert

- ✅ ProComponents 严格使用
- ✅ Design Tokens 样式化
- ✅ Skills 集成（Ant Design Skill）
- ✅ MCP 工具使用

### 3. Umi Pro Agent

- ✅ "配置优于代码"理念
- ✅ Mock 与服务驱动开发
- ✅ i18n 强制国际化
- ✅ Context7 文档研究

### 4. Code Spec Expert

- ✅ 代码审计清单
- ✅ 安全检查（XSS、财务、认证）
- ✅ "Separated Card" 样式验证
- ✅ 零 Lint 策略

### 5. QA Tester

- ✅ 功能完整性验证
- ✅ i18n 审计
- ✅ "Separated Card" 合规性检查
- ✅ 浏览器测试

---

## 📚 新增功能

### 1. JSON 配置文件

创建了 `opencode.json`，允许在项目根目录统一配置所有 Agent。

### 2. 详细文档

创建了 `.opencode/README.md`，包含：

- 所有 Agent 的详细说明
- 调用方式示例
- 核心设计理念
- 使用示例和工作流程

### 3. OpenCode 标准化

- 统一的 frontmatter 格式
- 标准的权限控制
- 温度参数优化
- **移除 model 配置**：由 OpenCode 统一管理模型选择

### 4. 统一输出格式

所有子 Agent 现在都有明确的结果交付格式：

- **Planning**: 📋 规划结果摘要
- **Frontend**: 🎨 前端实施结果摘要
- **Umi Pro**: 🚀 UmiJS 实施结果摘要
- **Code Spec**: ✅ 代码审查结果摘要
- **QA Tester**: 🧪 QA 测试结果摘要

每个输出都包含：

- 任务描述和状态
- 完成内容清单
- 待主 Agent 确认事项
- 明确的结束标记

### 5. 会话控制规则

强化了会话管理规范：

- ✅ 子 Agent 完成任务后必须输出结果摘要
- ❌ 子 Agent 禁止自行结束会话
- ❌ 子 Agent 禁止直接调用其他 Agent
- ✅ 只有主 Agent (team) 有权决定任务流程和结束会话

### 6. Chrome DevTools MCP 集成

为 QA Tester 添加了 Chrome DevTools MCP 支持：

- 浏览器自动化测试
- 截图和 DOM 检查
- JavaScript 执行
- 控制台错误监控

---

## 🚀 使用方式

### 在 OpenCode 中使用

1. **自动加载**:

   ```bash
   # OpenCode 会自动检测 .opencode/agents/ 目录
   # 所有 Agent 将自动可用
   ```

2. **调用 Agent**:

   ```
   @planning 分析这个需求
   @frontend 实现 UI 界面
   @umi-pro 创建服务层
   @code-spec 审查代码
   @qa-tester 测试功能
   ```

3. **切换 Agent**:
   ```
   # 使用 Tab 键或配置的快捷键切换主代理
   # 子代理通过 @提及 调用
   ```

---

## 🔗 两套配置的关系

### Antigravity (`.agent/`)

- 保持原样，供 Antigravity 平台使用
- 包含 Team Coordinator 协调逻辑
- 使用 `/plan`、`/fe`、`/umi` 等斜杠命令

### OpenCode (`.opencode/`)

- 符合 OpenCode 标准格式
- 使用 `@planning`、`@frontend` 等 @ 提及
- 自动协调机制（无需 Coordinator）

两套配置**功能等价**，只是格式和调用方式不同。

---

## ✅ 验证清单

- [x] 所有 6 个 Agent 配置文件已创建（1 主 Agent + 5 子 Agent）
- [x] JSON 配置文件已创建
- [x] README 文档已创建
- [x] MIGRATION 文档已创建
- [x] YAML frontmatter 格式正确
- [x] 移除所有 model 配置
- [x] 权限配置合理
- [x] 温度参数优化
- [x] 核心能力完整保留
- [x] "Separated Card" 规范统一
- [x] Design Tokens 强制执行
- [x] 统一输出格式已添加
- [x] 会话控制规则已明确
- [x] Chrome DevTools MCP 集成说明已添加
- [x] Team 主 Agent 已创建
- [x] 文档完整详细

---

## 📖 参考资料

- [OpenCode Agent 文档](https://opencode.ai/docs/zh-cn/agents/)
- [Antigravity Agent 配置](./.agent/)
- [开发总结文档](./.agent/DEVELOPMENT_SUMMARY.md)

---

**迁移完成时间**: 2026-02-14  
**迁移执行者**: Antigravity Team  
**配置版本**: 1.0
