用途:按参数化模板生成 React 19 / 19.2 的 TypeScript 代码文件,包括组件、Server Component 页面、客户端孤岛、带 useActionState 的表单动作、Context 提供器、自定义 Hook、类型化 reducer,以及文档元数据与资源提示文件。生成代码遵循同级 react 技能中固化的约定,例如 ref 作为普通 prop(不使用 forwardRef)、Context 直接作为提供器渲染(不使用 .Provider)、表单 action 配合 useActionState + useFormStatus、内联文档元数据、用 useSyncExternalStore 处理外部订阅,以及符合 YMNNAE 的 Hook 主体。
主要能力:提供 8 个模板——function-component(可复用组件,含可选测试文件)、server-component-page(带服务端数据获取、Suspense 与元数据的路由页)、client-island('use client' 交互层)、form-action(useActionState + Zod schema + 服务端 action)、context-provider(state/dispatch 拆分与访问 Hook)、custom-hook、reducer(可辨识联合动作加穷尽 switch)、head-and-hints(元数据与资源提示)。模板强制拒绝生成 forwardRef 包装、<Context.Provider>、useFormState、onSubmit 变更处理、无参 useRef<T>()、用于派生状态的 useEffect、react-dom/test-utils、手写 preload JSX 及 react-helmet 等写法。
使用方式:先识别匹配模板(不明确时询问,未限定则默认 function-component),读取 assets/templates/{name}.template 与 references/conventions.md,收集参数(name 必填;module_path、props、with_test、with_ref 等可选),替换 {花括号} 占位符后用 Write 工具按 config.json 中的 module_path、route_path 等路径写出文件。首次使用需配置 module_path、route_path、hooks_path、test_runner(vitest 默认或 jest)。对既有代码做多文件约定改造时改用 references/_conform-algorithm.md,采用约定优先而非按文件逐个处理。
适用场景与限制:适合新建 React 19 组件、路由页、表单、Context、Hook、reducer 与元数据文件,以及跨文件约定对齐。限制:仅面向该技能约定的 React 19 写法;资料未提供安装命令、收费、平台与效果信息;gotchas.md 首次发布为空,随使用积累。