Use when working on React / Next.js pages, components, forms, tables, dashboards, layouts, interactions, state flow, rendering behavior, accessibility, responsive polish, hydration / re-render issues, or frontend review / refactor / debugging / performance / architecture tasks, including requests about 页面、组件、表单、交互、状态流、前端评审、界面打磨 or 页面太普通 / 太乱 / 太卡 / 状态不同步 / effect 太多.
前端任务的默认作战手册。
目标只有一个:更稳定地把前端任务做对。用最纯粹、最简单、最直接、最容易理解的方式完成任务。先抓结构、事实源、用户状态和验证,再谈技巧、抽象和装饰。
不要满足于“能用”“差不多”“先做完再说”。不能靠补丁叠补丁、包装套包装、抽象压抽象去堆出屎山代码;如果结构已经开始变糟,先停下来收复杂度,再继续推进。
不要用于纯后端、纯基础设施、纯发布流程、纯包管理,或与前端结构无关的任务。
references/00-core-principles.md、references/01-quality-gates.md、references/03-simplification-discipline.md;这三份是必读入口,不随主模式省略。00 校准优先级,用 03 控制复杂度,用 01 约束“能不能宣称做好了”。references/02-task-routing.md。references/30-react-next-adapter.md。references/01-quality-gates.md 和 references/15-testing-verification-rollbacks.md,确认结论和证据匹配。下表中的“默认读取”建立在已经读过 00 01 03 这三个必读入口的前提上,表示当前主模式需要额外补读的专题。
| 主模式 | 交付物 | 默认读取 |
|---|---|---|
| 实现 | 新增页面、组件、交互或数据流 | 10 11 13 14 15 |
| 重构 | 降复杂度、理顺边界、删冗余 | 16 10 11 15 |
| 评审 | 发现问题、列风险、做质量判断 | 16 10 11 12 13 14 15 |
| 调试 | 缩小范围、定位根因、给修复路径 | 16 11 12 13 15 |
| 性能优化 | 卡顿、重渲染、交互延迟、列表性能 | 12 11 10 15 |
| UI / 交互打磨 | 视觉层级、响应式、交互质感、可信感 | 14 13 15 |
| 架构 / 方案 | 边界设计、状态模型、实现取舍 | 10 11 13 14 15 |
实现
重构
评审
findings-first,按严重度给问题、依据、验证缺口和不确定点。调试
性能优化
UI / 交互打磨
架构 / 方案
memo、虚拟化或缓存;先判断状态影响范围、重复转换、async waterfall 和客户端边界。