255 lines
6.5 KiB
Markdown
255 lines
6.5 KiB
Markdown
# 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
|