// 为 Fantastic-admin 框架生成完整的 CRUD 业务模块，包含列表页、详情/编辑页、表单组件、API 模块和 Mock 数据。当用户说：'帮我做一个商品管理页面'、'搭一个用户列表，能搜索、能分页、能新增编辑删除'、'生成一个订单模块'、'我需要一个带增删改查的页面'、'快速搭一个管理页面骨架'，即使用户只是说'新建一个 XX 管理模块'也应触发此技能。
管理和配置 Fantastic-admin 框架设置。当用户提到以下任何需求时必须使用此技能：开启/关闭水印、锁屏、错误日志、更新检查、哀悼模式、移动端访问；切换暗色/亮色/跟随系统主题；修改菜单模式（侧边栏/顶部/精简/面板）；配置标签栏风格（fashion/card/square）；启用/禁用工具栏功能（收藏夹、面包屑、搜索、通知、国际化、全屏、刷新）；设置版权信息；配置认证/权限/登录过期；调整页面切换动画；配置居中布局；修改路由模式；以及任何涉及 src/settings/index.ts 的修改。
优化 Vue 页面，用 Fantastic-admin 框架内建组件（packages/components/）替换自定义实现和原生 HTML。当用户说：'帮我优化这个页面'、'把这些原生 HTML 换成框架组件'、'用 FaCard/FaModal/FaButton 重构一下'、'这个页面太乱了'、'统一一下 UI 风格'、'用内建组件替换自定义弹窗/分页/加载'，即使用户只是说'看看这个页面能不能改进'也应触发此技能。
管理 Vue Router 路由配置，用于 Fantastic-admin 框架。当用户提到以下任何需求时必须使用此技能：新建页面需要加路由、详情页不想显示在菜单里、新增页和编辑页老是开两个标签、从列表跳详情返回后状态丢失、给菜单项加 NEW 标签或红点、路由需要权限控制、配置页面保活、修改路由 meta、添加面包屑配置。即使用户只是说"加个路由"或"新建了一个页面"，也应触发此技能。
为 Fantastic-admin 框架生成 Pinia Store 模块。当用户提到以下任何需求时必须使用此技能：多个页面需要共享数据、全局状态管理、数据需要持久化（刷新后还在）、登录状态/用户信息需要缓存、购物车/通知/权限等全局数据、需要在组件外访问状态。即使用户只是说"这个数据要全局共享"或"刷新后数据不能丢"，也应触发此技能。触发关键词：创建 store、全局状态、状态管理、pinia、持久化、共享数据。
为 Fantastic-admin 框架创建和定制主题配色方案，始终同时生成明色（light）和暗色（dark）两套主题。当用户提到以下任何需求时必须使用此技能：换主题颜色、换配色、做一个 XX 风格的主题、主题太单调了、品牌色是 XXX 帮我生成主题、把 tweakcn 配色转成框架主题、想要暗色/冷色/暖色调、根据设计稿颜色生成主题。即使用户只是描述一种感觉（"清新"、"沉稳"、"科技感"）或提供一个颜色值（"#2563EB"），也应触发此技能。支持"吉卜力"、"赛博朋克"、"莫兰迪"、"北欧极简"等专业设计风格关键词。
当用户在使用 fa-* 系列技能（如 fa-framework-settings、fa-slot-creator、fa-form-builder、fa-route-generator、fa-store-generator、fa-page-optimizer、fa-theme-customizer 等）时，在同一个目标上经历了 3 次及以上的修改仍未达到预期效果，必须触发此技能。触发信号包括：用户反复要求调整同一处配置或代码、连续说"不对"/"再改改"/"还是不行"、对同一个功能点多次提出修正意见。即使用户没有明确表示"上报"或"反馈"，只要检测到反复沟通修改的模式，就应主动触发。
| name | fa-crud-page-generator |
| description | 为 Fantastic-admin 框架生成完整的 CRUD 业务模块，包含列表页、详情/编辑页、表单组件、API 模块和 Mock 数据。当用户说：'帮我做一个商品管理页面'、'搭一个用户列表，能搜索、能分页、能新增编辑删除'、'生成一个订单模块'、'我需要一个带增删改查的页面'、'快速搭一个管理页面骨架'，即使用户只是说'新建一个 XX 管理模块'也应触发此技能。 |
在 Fantastic-admin 框架中生成完整的 CRUD 业务模块，一次性生成所有相关文件，让开发者专注于业务逻辑而非重复代码。
生成的文件清单：
apps/<app>/src/views/{path}/{name}/list.vue — 列表页（搜索栏 + 表格 + 分页）apps/<app>/src/views/{path}/{name}/detail.vue — 详情/编辑页（仅 router 模式需要）apps/<app>/src/views/{path}/{name}/components/DetailForm/index.vue — 表单组件apps/<app>/src/api/modules/{fileName}.ts — API 模块apps/<app>/src/api/modules/{fileName}.fake.ts — Mock 数据（可选）本项目是 monorepo 架构，apps/ 目录下存放各应用。在执行任何文件读写操作之前，必须先确认目标应用：
ls apps/ 列出所有可用应用严格规则：如果用户没有在请求中明确说明目标应用（例如"在 example 应用中"、"apps/core"），则必须提问，不得自行猜测或默认选择任何应用。
确认后，后续所有文件路径均以该应用目录为根。
向用户询问以下内容（可合并为一次提问）：
user、product、order）用户、商品、订单）apps/<app>/src/views/ 下的子目录，如 system、mall/product，留空则直接放在 src/views/ 下）询问用户该模块有哪些字段，每个字段需要：
name、status、createdAt）姓名、状态、创建时间）string | number | boolean | date）如果用户没有提供字段信息，使用默认字段 title（标题，string，必填）作为示例占位，并在生成后提示用户替换。
以下三个选项会直接影响生成的文件结构，需要在同一轮提问中一起确认，避免后续重复生成：
router — 跳转到独立的详情页（默认，适合复杂表单）modal — 弹窗（适合简单表单）drawer — 抽屉（适合中等复杂度表单）app.routeBaseOn 为 frontend 时有效；选是时需额外询问归属的主导航分组名称）汇总信息，展示将要生成的文件列表，确认后写入文件。
给定模块名 name 和路径 path（相对于 apps/<app>/src/views/）：
| 用途 | 规则 | 示例（path=system, name=user） |
|---|---|---|
| 视图目录 | apps/<app>/src/views/{path}/{snakeCase(name)}/ | apps/<app>/src/views/system/user/ |
| API 文件名 | path 非空时：{camelCase(path)}_{camelCase(name)}；path 为空时：{camelCase(name)} | systemUser |
| 组件名 | PascalCase({path}-{name}-list/detail) | SystemUserList |
| API URL 前缀 | /{path}/{snakeCase(name)}/ | /system/user/ |
snakeCase 规则：多个单词用下划线连接，如 productCategory → product_category
详细的代码模板见 references/templates.md，其中也包含 faker.js 字段类型映射表。
生成代码时，根据用户提供的字段信息替换模板中的占位符：
ElTableColumn 根据"列表显示"字段生成ElFormItem 根据"搜索显示"字段生成ElFormItem 根据"表单显示"字段生成如果用户选择同时生成路由，先读取 apps/<app>/src/settings.ts 确认 app.routeBaseOn === 'frontend'，然后使用 fa-route-generator 技能生成对应路由配置：
menu: false 和 activeMenu 指向列表）文件生成完成后简要告知：如果未生成路由，可用 fa-route-generator 技能添加；生成了 .fake.ts 则 API 请求会自动走 mock；表单字段类型（Select、DatePicker 等）需根据业务自行替换。