一份日文的 React 19.3 写法规范:代理写、改、审组件和服务器处理时,按表决定状态放哪(界面状态用 Effect Atom、服务器数据用 TanStack Query)、怎么消除异步瀑布、什么时候用并发 API,是为作者的 masseater/typescript-template 模板改写的。
安全审计:已审计(未发现风险)
安装:npx skills add https://github.com/masseater/skills --skill how-to-use-react
理由
- “置き分け”表逐项写明用什么、不用什么:不用 useState / useContext(由 no-restricted-imports 拦截),乐观更新用 useOptimistic,不急的更新用 useTransition 代替定时防抖,隐藏但保留状态用 <Activity>
- 有 React Compiler 的仓库不写 useMemo / useCallback / memo;没有时只在 react-perf 规则指出的地方加
- 互不依赖的异步用 Effect.all 加 concurrency: "unbounded" 并发,顺序有要求就写明 concurrency: 1;作者注明改编自 vercel-labs 的 react-best-practices 等资料,不采用其中的 Next.js、SWR、Redux
- skills.sh 24 小时安装 2801(只代表关注度)
用法
- npx skills add https://github.com/masseater/skills --skill how-to-use-react
- 写、改、审 React 组件、loader、服务器处理时触发;SKILL.md 要求同时读 references/ 下 8 份文档(async、effects-and-data、component-apis 等)
风险
- 审计结果为通过;SKILL.md 是纯文字规范,没有脚本和网络请求,与内容相符;references/ 下的文档没有扫描
- 规则绑定作者模板的技术栈(Effect、TanStack Start、FSD 目录),普通 Next.js / Redux 项目照用会和现有代码冲突
- 全文日文;skills.sh 页面显示仓库只有 2 星、10 月 12 日才首次收录,单日安装量和仓库规模不相称