6.5 KiB
6.5 KiB
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：
---
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 中使用
-
自动加载:
# OpenCode 会自动检测 .opencode/agents/ 目录 # 所有 Agent 将自动可用 -
调用 Agent:
@planning 分析这个需求 @frontend 实现 UI 界面 @umi-pro 创建服务层 @code-spec 审查代码 @qa-tester 测试功能 -
切换 Agent:
# 使用 Tab 键或配置的快捷键切换主代理 # 子代理通过 @提及 调用
🔗 两套配置的关系
Antigravity (.agent/)
- 保持原样，供 Antigravity 平台使用
- 包含 Team Coordinator 协调逻辑
- 使用
/plan、/fe、/umi等斜杠命令
OpenCode (.opencode/)
- 符合 OpenCode 标准格式
- 使用
@planning、@frontend等 @ 提及 - 自动协调机制（无需 Coordinator）
两套配置功能等价，只是格式和调用方式不同。
✅ 验证清单
- 所有 6 个 Agent 配置文件已创建（1 主 Agent + 5 子 Agent）
- JSON 配置文件已创建
- README 文档已创建
- MIGRATION 文档已创建
- YAML frontmatter 格式正确
- 移除所有 model 配置
- 权限配置合理
- 温度参数优化
- 核心能力完整保留
- "Separated Card" 规范统一
- Design Tokens 强制执行
- 统一输出格式已添加
- 会话控制规则已明确
- Chrome DevTools MCP 集成说明已添加
- Team 主 Agent 已创建
- 文档完整详细
📖 参考资料
迁移完成时间: 2026-02-14
迁移执行者: Antigravity Team
配置版本: 1.0