用途:这是发布在 pproenca/dot-skills 的可安装技能,面向 AI 代理,提供按功能(feature-based)组织 React 应用的架构最佳实践指南,便于在多团队独立开发的场景下实现可扩展开发。
主要能力:包含跨 8 个类别的 42 条规则,按影响优先级划分:目录结构(struct-,严重)、导入与依赖(import-,严重)、模块边界(bound-,高)、数据获取(fquery-,高)、组件组织(fcomp-,中高)、状态管理(fstate-,中)、测试策略(test-,中)、命名约定(name-,低)。规则涵盖按功能而非技术类型组织目录、单向导入流、禁止跨功能导入、仅通过公共 API 导出、路径别名、类型导入、功能隔离与接口契约、功能范围路由与查询键、并行获取、避免 N+1、容器与展示分离、功能级错误边界、功能范围状态存储、服务端状态与客户端状态分离、测试与功能同置,以及领域驱动命名等。
适用场景:创建新功能或模块、组织项目目录结构、设置导入规则与边界、实现数据获取模式、组合来自多个功能的组件、审查代码中的架构违规时参考。
使用方式:资料说明可读取各单独参考文件获取详细说明与代码示例,包括章节定义、规则模板,以及 references/{prefix}-{slug}.md 形式的单条规则;完整合辑见 AGENTS.md。相关技能包括 feature-spec、tanstack-query、react-19。安装命令与许可、费用等信息暂未提供。
限制:资料未说明具体版本兼容范围、依赖要求与运行成本;实际效果需以项目情况为准。