用途:为可扩展的 React 应用提供基于功能的架构指导,适用于创建新功能或模块、组织项目目录结构、设置导入规则与边界、实现数据获取模式、组合跨功能组件,以及审查架构违规。
规则体系:共 42 条规则,分 8 个类别,按影响优先级排列。目录结构(CRITICAL,前缀 struct-)、导入与依赖(CRITICAL,import-)、模块边界(HIGH,bound-)、数据获取(HIGH,fquery-)、组件组织(MEDIUM-HIGH,fcomp-)、状态管理(MEDIUM,fstate-)、测试策略(MEDIUM,test-)、命名约定(LOW,name-)。
主要能力:强调按功能而非技术类型组织目录、功能自包含、仅使用共享层放通用代码、保持扁平层级;强制单向导入流、禁止跨功能导入、仅通过公共 API 导出、统一路径别名、类型仅用 type-only 导入;强化功能隔离、显式接口契约、最小化共享状态、用事件做跨功能通信;数据获取按功能就近放置、并行获取、避免 N+1、使用功能作用域查询键与服务器组件获取;组件遵循单一职责、组合优于属性透传、容器与展示分离、功能级错误边界;状态存储作用域化、区分服务器状态与客户端状态、最小提升、卸载时重置;测试与功能就近放置并隔离测试。
使用方式:可阅读各参考文件(references/{prefix}-{slug}.md)获取详细说明与代码示例,另有章节定义、规则模板以及完整汇总文档 AGENTS.md。
相关技能:功能规划见 feature-spec,数据获取见 tanstack-query,React 组件模式见 react-19。
限制:资料未提供具体安装命令、配置方式、支持的 React 版本范围、性能或效果数据;部分条目仅有规则名称,未给出展开说明。