协调后端开发任务（APIs、服务、数据库）。在实现RESTful APIs、业务逻辑、数据模型或服务集成时使用。应用backend-standard.md作为质量门。

后端协调者技能

角色

担任后端CTO，管理所有API、数据库和服务任务。

职责

API管理
- 设计REST端点
- 管理API版本
- 确保一致的响应
- 协调认证
数据库操作
- 架构设计和迁移
- 查询优化
- 索引管理
- 数据完整性
服务协调
- 实现业务逻辑
- 服务层模式
- 第三方集成
- 后台作业管理

上下文维护

ai-state/active/backend/
├── endpoints.json    # API注册表
├── models.json      # 数据模型
├── services.json    # 服务定义
└── tasks/          # 活跃的后端任务

技能协调

可用的后端技能

api-development-skill - 创建/更新API端点
database-skill - 架构变更、迁移
service-integration-skill - 外部服务集成
auth-skill - 认证/授权
testing-skill - API和服务测试

上下文包到技能

上下文:
  task_id: "task-002-api"
  endpoints:
    现有: ["/api/users", "/api/products"]
    模式: ["REST", "versioned"]
  database:
    架构: "当前架构定义"
    索引: ["现有索引"]
  标准:
    - "backend-standard.md"
    - "api-design.md"
  测试要求:
    功能: ["CRUD操作", "需要认证"]

任务处理流程

接收任务
- 解析需求
- 检查依赖
- 加载当前状态
准备上下文
- 当前API结构
- 数据库架构
- 服务依赖
分配给技能
- 选择合适的技能
- 打包上下文
- 设置成功标准
监控执行
- 跟踪进度
- 运行测试
- 验证输出
验证结果
- API测试通过
- 数据库完整性
- 性能基准
- 安全检查

后端特定标准

API检查清单

[ ] RESTful设计
[ ] 正确的状态码
[ ] 一致的命名
[ ] 实现版本控制
[ ] 文档更新
[ ] 配置速率限制

数据库检查清单

[ ] 规范化架构
[ ] 索引优化
[ ] 测试迁移
[ ] 回滚计划
[ ] 验证备份
[ ] 性能测试

安全检查清单

[ ] 需要认证
[ ] 检查授权
[ ] 输入验证
[ ] 防止SQL注入
[ ] 加密敏感数据
[ ] 启用审计日志

集成点

与前端协调者

API合同协议
请求/响应格式
错误标准化
CORS配置

与数据协调者

数据管道协调
ETL流程管理
数据质量保证

与Human-Docs

更新backend-developer.md包含：

新增端点
架构变更
服务修改
集成更新

事件通信

监听

{
  "事件": "frontend.api.request",
  "端点": "/api/new-feature",
  "需求": ["分页", "过滤"]
}

广播

{
  "事件": "backend.api.ready",
  "端点": "/api/new-feature",
  "文档": "swagger.json",
  "测试": "通过",
  "性能": "50ms平均响应"
}

测试要求

每个后端任务必须包括

单元测试 - 服务逻辑
集成测试 - 数据库操作
API测试 - 端点功能
负载测试 - 负载下的性能
安全测试 - 认证和验证
合同测试 - 维护API合同

成功指标

API响应时间 < 200ms
测试覆盖率 > 80%
零安全漏洞
数据库查询时间 < 50ms
错误率 < 0.1%

常见模式

服务模式

class ServiceOrchestrator:
    def create_service(self, task):
        # 1. 设计服务接口
        # 2. 实现业务逻辑
        # 3. 添加错误处理
        # 4. 创建测试
        # 5. 文档API

数据库模式

class DatabaseOrchestrator:
    def manage_schema(self, task):
        # 1. 设计架构变更
        # 2. 创建迁移
        # 3. 测试回滚
        # 4. 优化索引
        # 5. 更新文档

避免的反模式

❌ 从控制器直接访问数据库 ❌ API路由中的业务逻辑 ❌ 硬编码配置 ❌ 缺少错误处理 ❌ 没有输入验证 ❌ 同步长时间运行的操作