用途
vue-fsd 是一个面向 Vue 3 应用的 Feature-Sliced Design（FSD）架构技能，定位为资深前端架构师，专注于用 FSD 方法论组织大型前端代码库，帮助团队建立清晰的边界、严格的导入规则与可维护的结构。它强调理解何时应用 FSD 模式，以及何时更简单的结构即可满足需求。
主要能力
该技能围绕 FSD 的分层架构提供指导，核心工作流包括：
- 评估项目范围，判断 FSD 是否适用（适合中大型项目）；
- 定义所需的 FSD 分层；
- 识别实体，映射业务领域模型；
- 识别功能，映射用户交互与动作；
- 组织页面，由功能与实体组合而成；
- 搭建共享层，创建可复用基础设施；
- 配置导入规则，强制层级的依赖规则。
技能提供按情境加载的参考文档，覆盖分层架构、实体与功能、共享层、页面与组件、公共 API、Vue 集成以及迁移指南等主题。
使用方式
资料说明该技能为代理技能（agent skill），通过按其工作流与约束指导 Vue 3 项目的 FSD 结构设计；在实施 FSD 结构时，输出的模板包括：带有清晰分层的文件夹结构、公共 API 导出（index.ts 文件）、示例切片实现、导入规则说明，以及架构决策的简要理由。具体安装命令或调用方式暂未提供。
适用场景
- 构建新的大型 Vue 3 项目；
- 将既有项目重构为 FSD 架构；
- 定义业务领域之间的清晰边界；
- 设置导入规则与层级依赖；
- 创建可复用的实体、功能与组件（widgets）；
- 组织共享工具与 UI 组件；
- 以清晰归属扩展前端团队。
关键约束
必须遵循：严格的层级顺序 app → pages → widgets → features → entities → shared；每个切片必须通过 index.ts 提供公共 API；使用具名导出，避免通配符再导出；实体为名词（数据），功能为动词（动作）；保持跨切片依赖最小；使用 TypeScript 保证类型安全；记录切片职责。
禁止：从更高层导入（违反 FSD 规则）；在同一层内横向导入（应使用共享层或更低层）；在切片之间创建循环依赖；混淆实体与功能职责；跳过公共 API 模式（直接导入）；用完整 FSD 对小项目过度设计。
相关技能与知识范围
相关知识包括 Feature-Sliced Design、Vue 3、Composition API、Pinia、Vue Router、TypeScript、领域驱动设计、整洁架构、SOLID 原则与模块化架构。相关技能包括 Vue Expert、TypeScript Pro 与 Frontend Architect。