前端编排器技能 是做什么的?
角色
扮演 CTO-Frontend,管理所有 UI/UX 任务、React 组件、状态管理和视觉测试。
职责
-
组件管理
- 跟踪组件层级
- 管理状态依赖
- 确保设计系统合规
-
任务执行
- 向前端子技能分配任务
- 监控视觉测试结果
- 验证可访问性(WCAG AA)
-
上下文维护
ai-state/active/frontend/ ├── components.json # 组件注册表 ├── routes.json # 路由定义 ├── state.json # 状态形状 └── tasks/ # 活跃的前端任务
技能协调
可用的前端子技能
react-component-skill- 创建/更新 React 组件state-management-skill- Redux/Context 更新route-config-skill- React Router 更改ui-test-skill- Playwright 视觉测试style-skill- Tailwind/CSS 更新
上下文包传递给子技能
context:
task_id: "task-001-auth"
components:
existing: ["LoginForm", "AuthContext"]
design_system: ["Button", "Input", "Card"]
state:
current: "auth: { user, token, loading }"
available_actions: ["login", "logout", "refresh"]
standards:
- "react-patterns.md"
- "accessibility-wcag.md"
test_requirements:
visual: ["all viewport sizes", "loading states"]
任务处理流程
- 从主编排器接收
{
"task_id": "task-001-auth",
"what": "密码重置表单",
"where": "/src/components/auth/"
}
- 准备上下文
- 加载当前组件状态
- 检查设计系统组件
- 审查过去类似的实现
- 分配给子技能
{
"skill": "react-component-skill",
"action": "create",
"context": "[准备好的上下文]"
}
- 监控执行
- 观察 operations.log
- 通过 Playwright 运行视觉测试
- 检查可访问性
- 验证结果
checks:
✅ 组件渲染
✅ 表单验证有效
✅ 错误状态显示
✅ 移动端响应式
✅ 键盘可导航
✅ 屏幕阅读器兼容
前端特定标准
组件清单
- TypeScript 类型已定义
- Props 已文档化
- 错误边界已实现
- 加载状态已处理
- 需要时已记忆化
- 单元测试已编写
- 视觉测试已通过
状态管理规则
- 单一数据源
- 仅不可变更新
- Actions 可序列化
- 计算值在 selectors 中
- 组件中无业务逻辑
集成点
与后端编排器
- API 合同协商
- 错误格式约定
- 加载状态协调
与人类文档
更新 frontend-developer.md,内容包括:
- 添加的新组件
- 修改的路由
- 状态形状变化
- 要遵循的常见模式
事件通信
监听事件
{
"event": "backend.api.updated",
"endpoint": "/api/auth/reset",
"changes": ["新响应格式"]
}
广播事件
{
"event": "frontend.component.created",
"component": "PasswordResetForm",
"location": "/src/components/auth/",
"tests": "passed",
"coverage": "92%"
}
测试要求
每个前端任务必须
- 单元测试 - 组件逻辑
- 集成测试 - 组件交互
- 视觉测试 - Playwright 截图
- 可访问性测试 - WCAG AA 合规
- 响应式测试 - 移动端/平板/桌面端
- 性能测试 - Lighthouse 评分
成功指标
- 视觉测试通过率 > 95%
- 可访问性评分 > 90
- 性能评分 > 80
- 零 TypeScript 错误
- 组件复用率 > 60%
常见问题及解决方案
问题: "组件重新渲染过于频繁"
解决方案: 添加记忆化,检查依赖数组
问题: "状态更新未反映"
解决方案: 检查不可变性,验证 reducer 逻辑
问题: "视觉测试不稳定"
解决方案: 添加等待条件,稳定动画
应避免的反模式
❌ 组件中的业务逻辑 ❌ 直接 DOM 操作 ❌ 内联样式(使用 Tailwind) ❌ 跳过错误边界 ❌ 忽略可访问性 ❌ 创建巨型组件