fa-form-builder

npx skills add fantastic-admin/basic --skill fa-form-builder --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# 表单页面生成器 在 Fantastic-admin 框架中生成独立的 Router 表单页面，使用 `FaForm/FaFormItem` 承接 vee-validate + zod 表单验证。 **生成的文件：** - `apps/<app>/src/views/{path}/{name}/index.vue` — 表单页面（含验证、提交骨架、固定操作栏） --- ## 第一步：确认工作区（必须阻塞等待用户回复） 本项目是 monorepo 架构，`apps/` 目录下存放各应用。**在执行任何文件读写操作之前**，必须先确认目标应用： 1. 执行 `ls apps/` 列出所有可用应用 2. **立即向用户提问**，明确询问要在哪个应用中生成表单页面，并**停止等待回复** 3. 收到用户明确回复后，才能继续后续步骤 > **严格规则**：如果用户没有在请求中明确说明目标应用（例如"在 example 应用中"、"apps/core"），则必须提问，不得自行猜测或默认选择任何应用。 确认后，后续所有文件路径均以该应用目录为根。 --- ## 工作流程 ### Step 1：收集基本信息 向用户询问（可合并为一次提问）： 1. **模块名**（英文，用于文件路径，如 `user`、`profile`、`setting`） 2. **模块中文名**（用于页面标题，如 `用户信息`、`个人资料`） 3. **存放路径**（在 `apps/<app>/src/views/` 下的子目录，如 `system`、`account`，留空则直接放在 `src/views/` 下） ### Step 2：收集字段信息 询问用户该表单有哪些字段，每个字段需要： - **字段名**（英文，如 `name`、`avatar`、`status`） - **中文标签**（如 `姓名`、`头像`、`状态`） - **字段类型**（见 references/templates.md 中的字段类型映射表） - **是否必填** 如果用户没有提供字段信息，使用默认字段 `title`（标题，string，必填）作为示例占位，并在生成后提示用户替换。 ### Step 3：判断布局 字段较多时单列会导致页面过长，双列更紧凑。根据字段数量和复杂度判断是否询问用户布局偏好： - **单列**：`max-w-600px`，`grid gap-6`（字段少、字段较长时适合） - **双列**：`max-w-1200px`，`grid grid-cols-1 gap-x-8 gap-y-6 items-start md:grid-cols-2`（字段多、字段较短时适合） ### Step 4：确认并生成 汇总信息，展示将要生成的文件，确认后写入。 生成完成后提示：如需配置路由，请使用 `fa-r