用途:按已批准的前端范围实现前端功能,严格消费已发布的契约,不臆造 API 形状、不只做 happy path、不忽略类型错误。若仅被要求规划,则产出任务/UI 状态清单后停止。
主要能力:先隔离工作区(如 git worktree add -b <branch> <new-dir> HEAD,并用 git rev-parse --show-toplevel 验证不在主检出);读取 CLAUDE.md、前端 LLD 与契约;将任务 DAG 拆分为切片,用 python3 engine/validate_tasks.py <tasks.json> 校验后,按切片并行(最多 3 个)或串行实现;每切片批量加载上下文、测试先行、按需人工门禁、限定写入范围。
使用方式:先完成技术栈设置清单(状态管理、数据获取与缓存、样式与设计令牌、测试基础设施、表单校验、API 客户端与类型、构建与环境、错误处理与日志、分析与事件),再按步骤实现类型/API 客户端、状态与数据获取、组件/页面、表单校验、错误处理、无障碍与 i18n、测试,最后运行 /verify,失败则 /fix-loop。
必需 UI 状态:loading、empty、success、validation error、API error、permission denied、retry/failed operation,均需构建并测试。
适用场景:需要按契约实现前端功能、多切片并行开发、要求 WCAG AA 无障碍与完整 UI 状态覆盖的工程流程。
限制:不得偏离 LLD 技术栈决策;不得运行破坏性命令或写入生产配置/密钥;认证/权限、生产配置或依赖变更前须询问人工;无 tasks.json 时需先以规划模式生成并校验。输出契约返回 branch、summary、tests_passed(必须为字面 JSON 布尔值)。