coding-guidelines

用途：这是一套 React/Next.js 开发规范，聚焦可测试性、Server Components 与合理架构，每个规范文件包含原则、代码示例和应避免的反模式。主要能力与覆盖主题包括：Server Components 与数据获取（async/await、Suspense、Promise 处理、何时不用 use client）；可测试性（Props 控制所有 UI 状态、闭包变量依赖提取为纯函数、条件分支抽取）；useEffect 与依赖（何时不需要/需要 useEffect、事件处理器与 Effect 决策、数据获取与竞态条件、响应式与非响应式逻辑分离、依赖管理、不得压制 exhaustive-deps）；架构（目录结构与组件共置、entity/gateway 模式、函数抽取、Presenter 模式）；测试规范（Vitest/RTL、AAA 模式、覆盖率、快照）；Storybook 规范。核心原则：Server Component 优先；所有 UI 状态可通过 Props 控制；条件逻辑抽为纯函数；无闭包依赖；entity/gateway 分离数据类型与获取逻辑；函数与组件同层共置，不用 utils/ 目录。使用方式：按决策树选择——需要交互（onClick、useState、useEffect）则用 use client 并阅读 useeffect-guidelines.md 与 testability.md，否则默认 Server Component 阅读 server-components.md；获取数据读 server-components.md 与 architecture.md；组织文件读 architecture.md；写测试读 test-guidelines.md；写 Storybook 故事读 storybook-guidelines.md。限制：资料未提供具体版本要求、安装命令、平台与收费信息，暂未提供。