frontend-review

用途：在前端实现完成后进行只读审查，对照契约与 LLD 检查 diff/分支，不修改代码。\n\n主要能力：按清单逐项检查——UI 状态完整性（loading、empty、success、校验错误、API 错误、权限拒绝、重试/失败）；无障碍（WCAG AA，键盘可操作、可见焦点、角色/标签、对比度、屏幕阅读器语义、焦点管理、无焦点陷阱）；安全（客户端无密钥/token、XSS 安全渲染/转义、CSRF 安全请求、重定向校验、日志/分析无 PII）；契约消费（按发布 API 调用、不臆造结构、处理全部文档化错误码）；韧性（慢/失败/过期 API 的重试退避与提示、乐观更新回滚、防重复提交）；表单与校验（镜像契约、字段级错误、提交中禁用）；性能（代码分割/懒加载、避免无谓重渲染、包体积、大列表虚拟化）；响应式与 i18n（断点、长文本/溢出、可本地化字符串、区域格式、RTL）；测试缺口（组件与 E2E 覆盖验收标准和 UI 状态、断言有意义）。\n\n使用方式：先界定 diff 范围（变更页面/组件、新 hook、受影响路由），再检查契约消费与所需 UI 状态，然后按清单做有证据的深度检查；在支持的 harness（如 Claude Code）中可通过 Task 工具派生只读子代理执行同一技能，否则内联执行，始终只读。随后按严重度合并并判定是否阻塞，写出报告并返回结论。\n\n外部技能：读取 skills.config.yaml 的 review.external（默认 requesting-code-review，来自 Superpowers 包，或 none）；若设置则先应用其纪律，但不得缩小上述清单。\n\n发现格式：summary（一段结论与主要风险）；findings 每项含 severity（blocker/major/minor/suggestion）、area、file（path:line）、evidence（引用代码或缺失状态/检查）、recommendation（最小安全改动）、safe_for_ai_fix；blocking（仍有 blocker/major 则为 true）。\n\n输出：按 blocker→major→minor→suggestion 排序，写入 .maestro/<slug>/frontend/reviews/summary.md，返回 review_path 与 blocking；工作流中阻塞结果会退回前端实现者（上限 3 次）。\n\n限制：只读，绝不编辑代码；需对照契约与 LLD；外部技能为可选；具体 harness 支持情况与配置默认值以资料为准。