用途:适用于任何前端改动。先查看最接近的可比路由、功能、组件与测试,复制其归属与命名形态,再创建新结构。该技能负责可移植的通用行为规范,React、TanStack Router/Query、TRPC、表单与测试机制交由专项技能处理。
按改动加载:每次前端改动读 references/coding-conventions.md,确保本地约定与公共边界成立;涉及路由、功能、页面、弹窗、表单或共享组件时读 references/module-composition.md,明确归属、就近放置与接缝;涉及 UI、布局、反馈、无障碍与响应式行为时读 references/interaction-and-accessibility.md,保证所有用户状态可用;涉及查询、变更、缓存、失效或 API 错误时读 references/data-boundaries.md,保持服务端状态与错误一致;涉及用户可见文本或区域敏感行为时读 references/localization.md,确保文本与格式可本地化。
专项路由:视觉设计系统与样式交给 frontend-design;React/TanStack Router、表单、加载器、查询状态、预取交给 tanstack-frontend;TRPC 契约、过程错误、中间件交给 trpc-patterns;测试与故事交给 testing-patterns;渲染、加载或打包体积问题交给 performance-optimization。只加载相关技能。路由或组件包装层保持轻薄,在其中组合功能行为,不要为方便把领域状态、数据编排或可复用 UI 内部实现移入其中。
完成标准:逐一处理受影响的参考文件,运行最小相关检查,并指出 API 契约或用户可见行为的变化。当加载、空、错误、权限、变更待定或成功反馈行为未明确时,不得宣称工作完成。