用途:feature-arch 是 pproenca/dot-skills 下的技能,为可扩展的 React 应用提供基于功能的架构准则,适用于编写、审查或重构 React 代码时保证架构一致性。
主要能力:包含 43 条规则,分为 8 类并按影响优先级排序——目录结构(struct-,关键)、导入与依赖(import-,关键)、模块边界(bound-,高)、数据获取(fquery-,高)、组件组织(fcomp-,中高)、状态管理(fstate-,中)、测试策略(test-,中)、命名规范(name-,低)。在真实项目中调用时,产出单份 Markdown 蓝图,保存于 docs/architecture/FEATURE-ARCH-TARGET.md(或仓库既有文档位置),内容涵盖项目上下文、已确认功能清单、目标目录树、各功能公共 API、导入边界矩阵、状态与数据归属、跨功能通信策略、编号迁移计划、人工一致性检查表和待决问题。
使用方式:遵循 references/_blueprint-process.md 的流程——收集上下文(package.json、src/ 目录树、README、CLAUDE.md、openspec/),从路由、文档与代码聚类中识别候选功能,通过 AskUserQuestion 与用户确认功能列表,记录层模型与通信机制等决策,填写 assets/templates/feature-arch-target.md.template 中的占位符,最后交接并输出路径、摘要与前三项风险,不在同一轮执行迁移。小型项目(约 10 个源文件以下)改为生成一页种子结构。各规则详见 references/{prefix}-{slug}.md。
适用场景:新建功能或模块、组织目录结构、设定导入规则与边界、实现数据获取、跨功能组合组件、审查架构违规。
限制:规则聚焦架构约定,不提供具体业务实现;相关技能有 feature-spec、tanstack-query、react-19。