225 lines
5.7 KiB
Markdown
225 lines
5.7 KiB
Markdown
# OpenCode Agent 配置完成总结
|
||
|
||
## ✅ 迁移完成
|
||
|
||
已成功将 Antigravity 的 Agent 配置完整迁移到 OpenCode 格式，并根据 OpenCode 规范进行了优化。
|
||
|
||
**完成时间**: 2026-02-14
|
||
**配置版本**: v1.0
|
||
|
||
---
|
||
|
||
## 📦 交付清单
|
||
|
||
### 配置文件（7 个）
|
||
|
||
1. ✅ `.opencode/agents/team.md` - 主 Agent（项目经理）
|
||
2. ✅ `.opencode/agents/planning.md` - 规划架构师（子 Agent）
|
||
3. ✅ `.opencode/agents/frontend.md` - 前端专家（子 Agent）
|
||
4. ✅ `.opencode/agents/umi-pro.md` - UmiJS 专家（子 Agent）
|
||
5. ✅ `.opencode/agents/code-spec.md` - 代码规范专家（子 Agent）
|
||
6. ✅ `.opencode/agents/qa-tester.md` - QA 测试专家（子 Agent）
|
||
7. ✅ `opencode.json` - 统一配置文件
|
||
|
||
### 文档文件（3 个）
|
||
|
||
1. ✅ `.opencode/README.md` - 使用指南
|
||
2. ✅ `.opencode/MIGRATION.md` - 迁移文档
|
||
3. ✅ 本文件 - 完成总结
|
||
|
||
---
|
||
|
||
## 🎯 核心特性
|
||
|
||
### 1. 主-子 Agent 架构
|
||
|
||
```
|
||
Team (主 Agent)
|
||
├── @planning (规划)
|
||
├── @frontend (前端)
|
||
├── @umi-pro (UmiJS)
|
||
├── @code-spec (审查)
|
||
└── @qa-tester (测试)
|
||
```
|
||
|
||
### 2. 统一输出格式
|
||
|
||
所有子 Agent 完成任务后都输出标准格式的结果摘要：
|
||
|
||
- 任务描述和状态
|
||
- 完成内容清单
|
||
- 待主 Agent 确认事项
|
||
- 明确的结束标记
|
||
|
||
### 3. 严格会话控制
|
||
|
||
- ✅ 只有主 Agent (team) 可以开始和结束会话
|
||
- ✅ 子 Agent 必须将结果交回主 Agent
|
||
- ❌ 子 Agent 禁止自行结束会话
|
||
- ❌ 子 Agent 禁止直接调用其他 Agent
|
||
|
||
### 4. 移除 Model 配置
|
||
|
||
所有 Agent 不再指定 model，由 OpenCode 统一管理模型选择，更加灵活。
|
||
|
||
### 5. Chrome DevTools MCP 集成
|
||
|
||
QA Tester 配置了 Chrome DevTools MCP 支持，用于自动化浏览器测试。
|
||
|
||
---
|
||
|
||
## 🚀 使用方式
|
||
|
||
### 直接对话（主 Agent）
|
||
|
||
```
|
||
用户：创建一个产品管理页面
|
||
Team Agent：理解需求 → 调用 @planning → 等待批准 → 实施 → 审查 → 测试 → 交付
|
||
```
|
||
|
||
### 手动调用子 Agent
|
||
|
||
```
|
||
@planning 分析这个需求并给出实施计划
|
||
@frontend 实现这个 UI 界面
|
||
@umi-pro 创建服务层和 Mock 数据
|
||
@code-spec 审查代码是否符合规范
|
||
@qa-tester 测试所有功能
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 工作流程
|
||
|
||
### 标准开发流程
|
||
|
||
1. **需求理解**: Team 与用户沟通，clarify 需求
|
||
2. **架构规划**: Team 调用 @planning 生成详细计划
|
||
3. **🛑 用户确认**: Team 暂停，等待用户批准计划
|
||
4. **服务开发**: Team 调用 @umi-pro 创建服务和 Mock
|
||
5. **UI 实施**: Team 调用 @frontend 或 @umi-pro 实现界面
|
||
6. **代码审查**: Team 调用 @code-spec 审查代码
|
||
7. **质量测试**: Team 调用 @qa-tester 进行测试
|
||
8. **任务交付**: Team 整合所有结果，交付给用户
|
||
|
||
---
|
||
|
||
## 🎨 设计规范（所有 Agent 强制遵守）
|
||
|
||
### "Separated Card" 模式
|
||
|
||
- **< 4 搜索字段**: 使用 `ProTable` 内置 `search`
|
||
- **>= 4 搜索字段**: 独立 `QueryFilter` 组件
|
||
|
||
### 强制样式 Tokens
|
||
|
||
```typescript
|
||
{
|
||
background: token.colorBgContainer, // 白色
|
||
padding: token.paddingLG, // 24px
|
||
borderRadius: token.borderRadius, // 6px
|
||
marginBottom: token.marginLG, // 24px
|
||
// 无 boxShadow - 扁平化设计
|
||
}
|
||
```
|
||
|
||
### 零 CSS 文件政策
|
||
|
||
所有样式必须通过 Ant Design Design Tokens 内联实现。
|
||
|
||
---
|
||
|
||
## 🔧 技术规范
|
||
|
||
### 架构层
|
||
|
||
- ✅ 真实服务层（`src/services/`）
|
||
- ✅ 统一 Mock（`mock/` 目录）
|
||
- ✅ TypeScript 严格（无 `any`）
|
||
|
||
### UI 层
|
||
|
||
- ✅ ProComponents 优先
|
||
- ✅ 垂直表单布局 (`layout="vertical"`)
|
||
- ✅ Design Tokens 样式化
|
||
|
||
### 数据层
|
||
|
||
- ✅ `useRequest` 统一数据请求
|
||
- ✅ 加载状态显示
|
||
- ✅ 防重复点击
|
||
|
||
### 国际化
|
||
|
||
- ✅ 所有字符串使用 `intl.formatMessage`
|
||
- ✅ 包含 `defaultMessage`
|
||
|
||
---
|
||
|
||
## 📊 配置对比
|
||
|
||
### Antigravity vs OpenCode
|
||
|
||
| 特性 | Antigravity | OpenCode |
|
||
| ---------- | ----------------------- | ------------------------ |
|
||
| 调用方式 | `/plan`, `/fe`, `/umi` | `@planning`, `@frontend` |
|
||
| 主协调器 | Team Coordinator Prompt | Team 主 Agent |
|
||
| Agent 类型 | 平级 Agent | 主-子 Agent 架构 |
|
||
| 会话控制 | 各 Agent 自行控制 | 主 Agent 统一控制 |
|
||
| 输出格式 | 自由格式 | 统一标准格式 |
|
||
| Model 配置 | 每个 Agent 指定 | 统一管理 |
|
||
|
||
---
|
||
|
||
## ⚙️ 配置细节
|
||
|
||
### 权限矩阵
|
||
|
||
| Agent | Mode | Write | Edit | Bash | Temperature |
|
||
| --------- | -------- | ----- | ---- | ---- | ----------- |
|
||
| team | primary | ✅ | ✅ | ✅ | 0.3 |
|
||
| planning | subagent | ❌ | ❌ | ❌ | 0.2 |
|
||
| frontend | subagent | ✅ | ✅ | ✅ | 0.3 |
|
||
| umi-pro | subagent | ✅ | ✅ | ✅ | 0.3 |
|
||
| code-spec | subagent | ✅ | ✅ | ❌ | 0.1 |
|
||
| qa-tester | subagent | ❌ | ❌ | ✅ | 0.2 |
|
||
|
||
---
|
||
|
||
## 📚 相关文档
|
||
|
||
- [README.md](./.opencode/README.md) - 详细使用指南
|
||
- [MIGRATION.md](./.opencode/MIGRATION.md) - 完整迁移说明
|
||
- [OpenCode 官方文档](https://opencode.ai/docs/zh-cn/agents/)
|
||
- [Antigravity 配置](./.agent/)
|
||
|
||
---
|
||
|
||
## ✨ 下一步建议
|
||
|
||
### 1. 测试配置
|
||
|
||
```bash
|
||
# 使用 OpenCode 加载此项目
|
||
# 测试主 Agent 是否正常工作
|
||
# 测试子 Agent 调用是否正常
|
||
```
|
||
|
||
### 2. 团队培训
|
||
|
||
- 向团队成员介绍新的 Agent 架构
|
||
- 说明主-子 Agent 的协作方式
|
||
- 演示标准工作流程
|
||
|
||
### 3. 持续优化
|
||
|
||
- 根据实际使用反馈调整 Agent 配置
|
||
- 优化输出格式和提示词
|
||
- 补充更多使用示例
|
||
|
||
---
|
||
|
||
**配置状态**: ✅ 已完成，可投入使用
|
||
**维护者**: Antigravity Team
|
||
**更新日期**: 2026-02-14
|