224 lines
6.9 KiB
Plaintext
224 lines
6.9 KiB
Plaintext
---
|
||
description:
|
||
globs:
|
||
alwaysApply: true
|
||
---
|
||
# 前后端多智能体协调机制
|
||
|
||
## 协调原则
|
||
|
||
### 1. 同步开发原则
|
||
- **并行开发**: 前后端智能体并行工作，通过契约接口协调
|
||
- **契约优先**: 优先定义 API 契约，确保前后端接口一致
|
||
- **质量对等**: 前后端质量要求保持一致，测试覆盖率对等
|
||
|
||
### 2. 规范对齐原则
|
||
- **命名对齐**: 前后端命名规范保持一致，优先使用业务术语
|
||
- **结构对齐**: 前后端数据结构保持一致，DTO 与前端类型对应
|
||
- **错误对齐**: 前后端错误处理机制保持一致，错误码统一
|
||
|
||
### 3. 工具协调原则
|
||
- **版本控制**: 使用 Git 进行版本控制，前后端代码分离管理
|
||
- **CI/CD 协调**: 前后端构建流程协调，确保部署一致性
|
||
- **文档同步**: API 文档与前端类型定义同步更新
|
||
|
||
## 智能体映射关系
|
||
|
||
| 前端智能体 | 后端智能体 | 协调阶段 | 主要职责 |
|
||
|-----------|-----------|----------|----------|
|
||
| F1 FrontendAnalyzer | S1 Analyzer | 需求分析 | 页面设计与接口设计协调 |
|
||
| F2 FrontendArchitect | S2 Architect | 架构设计 | 整体架构与目录结构协调 |
|
||
| F3 FrontendInfraOperator | S3 InfraOperator | 基建接入 | 开发环境与工具链协调 |
|
||
| F4 FrontendDeveloper | S4 Developer | 功能开发 | 接口实现与页面开发协调 |
|
||
| F5 FrontendSecurityGuard | S5 SecurityGuard | 安全检查 | 前后端安全策略协调 |
|
||
| F6 FrontendQualityGate | S6 QualityGate | 质量门禁 | 代码质量与测试协调 |
|
||
| F7 FrontendAuditor | S7 Auditor | 规范审计 | 代码规范与标准协调 |
|
||
| F8 FrontendRelease | S8 Release | 发布部署 | 构建部署与版本协调 |
|
||
| F9 FrontendPerfTuner | S9 PerfTuner | 性能优化 | 性能指标与优化协调 |
|
||
|
||
## 协调检查点
|
||
|
||
### 1. 项目启动阶段
|
||
**参与智能体**: F1 + S1
|
||
**协调内容**:
|
||
- 业务需求分析与技术方案设计
|
||
- 页面功能划分与 API 接口设计
|
||
- 开发计划制定与里程碑设定
|
||
|
||
**输出产物**:
|
||
- 需求分析文档
|
||
- API 接口设计文档
|
||
- 开发计划与时间安排
|
||
|
||
### 2. 架构设计阶段
|
||
**参与智能体**: F2 + S2
|
||
**协调内容**:
|
||
- 整体架构设计与技术选型
|
||
- 目录结构设计与模块划分
|
||
- 数据流设计与状态管理方案
|
||
|
||
**输出产物**:
|
||
- 架构设计文档
|
||
- 目录结构规范
|
||
- 数据流设计文档
|
||
|
||
### 3. 基建接入阶段
|
||
**参与智能体**: F3 + S3
|
||
**协调内容**:
|
||
- 开发环境配置与工具链搭建
|
||
- 依赖管理策略与版本控制
|
||
- 构建流程设计与自动化配置
|
||
|
||
**输出产物**:
|
||
- 开发环境配置文档
|
||
- 工具链使用指南
|
||
- 构建流程文档
|
||
|
||
### 4. 功能开发阶段
|
||
**参与智能体**: F4 + S4
|
||
**协调内容**:
|
||
- API 接口实现与前端页面开发
|
||
- 数据交互逻辑与状态管理
|
||
- 业务逻辑实现与用户体验
|
||
|
||
**输出产物**:
|
||
- 功能模块代码
|
||
- API 接口文档
|
||
- 测试用例与测试报告
|
||
|
||
### 5. 质量保证阶段
|
||
**参与智能体**: F5 + S5, F6 + S6
|
||
**协调内容**:
|
||
- 安全策略实施与漏洞修复
|
||
- 代码质量检查与测试覆盖
|
||
- 性能指标监控与优化
|
||
|
||
**输出产物**:
|
||
- 安全评估报告
|
||
- 质量检查报告
|
||
- 性能测试报告
|
||
|
||
### 6. 规范审计阶段
|
||
**参与智能体**: F7 + S7
|
||
**协调内容**:
|
||
- 代码规范检查与标准对齐
|
||
- 最佳实践实施与文档完善
|
||
- 技术债务识别与重构计划
|
||
|
||
**输出产物**:
|
||
- 规范检查报告
|
||
- 最佳实践文档
|
||
- 重构计划与建议
|
||
|
||
### 7. 发布部署阶段
|
||
**参与智能体**: F8 + S8
|
||
**协调内容**:
|
||
- 构建流程协调与版本管理
|
||
- 部署策略制定与环境配置
|
||
- 发布计划执行与回滚预案
|
||
|
||
**输出产物**:
|
||
- 构建产物与部署包
|
||
- 部署配置文档
|
||
- 发布计划与回滚预案
|
||
|
||
## 协调工具
|
||
|
||
### 1. API 契约管理
|
||
- **OpenAPI/Swagger**: API 接口文档与类型定义
|
||
- **TypeScript 类型生成**: 前端类型定义自动生成
|
||
- **API 测试工具**: 接口测试与验证
|
||
|
||
### 2. 版本控制
|
||
- **Git**: 代码版本控制与分支管理
|
||
- **GitHub/GitLab**: 代码托管与协作平台
|
||
- **Git Flow**: 分支策略与发布流程
|
||
|
||
### 3. CI/CD 协调
|
||
- **GitHub Actions/GitLab CI**: 自动化构建与测试
|
||
- **Docker**: 容器化部署与环境一致性
|
||
- **Kubernetes**: 容器编排与服务管理
|
||
|
||
### 4. 项目管理
|
||
- **Jira/ZenTao**: 需求管理与任务跟踪
|
||
- **Confluence/Notion**: 文档管理与知识共享
|
||
- **Slack/钉钉**: 即时沟通与通知
|
||
|
||
### 5. 监控与反馈
|
||
- **Sentry**: 错误监控与性能追踪
|
||
- **Prometheus**: 指标监控与告警
|
||
- **Grafana**: 数据可视化与报表
|
||
|
||
## 协调流程
|
||
|
||
### 1. 日常开发协调
|
||
```
|
||
每日站会 → 任务分配 → 并行开发 → 代码审查 → 集成测试 → 部署验证
|
||
```
|
||
|
||
### 2. 版本发布协调
|
||
```
|
||
需求冻结 → 功能开发 → 集成测试 → 预发布验证 → 正式发布 → 监控反馈
|
||
```
|
||
|
||
### 3. 问题处理协调
|
||
```
|
||
问题发现 → 影响评估 → 方案制定 → 并行修复 → 验证测试 → 部署上线
|
||
```
|
||
|
||
## 协调规范
|
||
|
||
### 1. 沟通规范
|
||
- **定期同步**: 每日站会、周例会、里程碑评审
|
||
- **异步沟通**: 使用文档、评论、邮件进行异步沟通
|
||
- **紧急沟通**: 使用即时通讯工具进行紧急问题处理
|
||
|
||
### 2. 文档规范
|
||
- **API 文档**: 使用 OpenAPI 规范，及时更新
|
||
- **技术文档**: 使用 Markdown 格式，结构清晰
|
||
- **变更日志**: 记录所有重要变更，便于追溯
|
||
|
||
### 3. 代码规范
|
||
- **命名规范**: 前后端命名保持一致，使用业务术语
|
||
- **注释规范**: 关键逻辑必须有注释，便于理解
|
||
- **提交规范**: 使用规范的提交信息，便于版本管理
|
||
|
||
### 4. 测试规范
|
||
- **单元测试**: 前后端都要有充分的单元测试
|
||
- **集成测试**: 前后端集成测试，确保接口正确
|
||
- **端到端测试**: 完整的用户流程测试
|
||
|
||
## 效果评估
|
||
|
||
### 1. 开发效率指标
|
||
- **开发周期**: 从需求到上线的完整周期
|
||
- **代码质量**: 缺陷密度、技术债务比例
|
||
- **团队协作**: 沟通效率、冲突解决时间
|
||
|
||
### 2. 产品质量指标
|
||
- **功能完整性**: 需求实现程度、功能覆盖率
|
||
- **性能指标**: 响应时间、吞吐量、资源使用
|
||
- **用户体验**: 用户满意度、易用性评分
|
||
|
||
### 3. 运维指标
|
||
- **部署频率**: 发布频率、部署成功率
|
||
- **系统稳定性**: 可用性、故障恢复时间
|
||
- **监控覆盖**: 监控覆盖率、告警准确性
|
||
|
||
## 持续改进
|
||
|
||
### 1. 定期回顾
|
||
- **周回顾**: 每周进行开发回顾，识别改进点
|
||
- **月回顾**: 每月进行项目回顾，评估整体效果
|
||
- **季度回顾**: 每季度进行战略回顾，调整方向
|
||
|
||
### 2. 改进措施
|
||
- **流程优化**: 根据回顾结果优化协调流程
|
||
- **工具升级**: 引入新的工具提升协作效率
|
||
- **技能提升**: 团队技能培训与知识分享
|
||
|
||
### 3. 最佳实践
|
||
- **经验总结**: 总结成功经验，形成最佳实践
|
||
- **案例分享**: 分享典型案例，促进团队学习
|
||
|
||
- **标准制定**: 制定团队标准，确保一致性 |