scaffold-page-gen

name

scaffold-page-gen

description

Use when the user wants to generate a frontend business page, route, API client, view model, mock data, or local demo inside an existing frontend scaffold. Reads the target frontend Convention Pack and runtime-env declaration, follows its routing/component/data-access conventions, runs the declared validation and demo commands, and records evidence for PACE runtime-verify. It does not invent framework rules or read live business data.

scaffold-page-gen

前端页面生成 skill。职责是把需求清单和冻结的 API 契约落成可运行页面、mock 数据、路由和本地 demo。 本 skill 系统无关：页面结构、组件库、路由、权限、mock 方式、校验命令全部来自目标项目的 Convention Pack；运行命令只从 runtime-env 读取。

何时使用

• 需要按既有前端脚手架生成业务页面、列表、详情、表单或工作台视图。
• 需要在真实后端完成前，用冻结契约生成 mock 数据并启动本地 demo。
• 需要把页面生成证据纳入 runtime-verify 或业务交付报告。

何时不使用

• 需求还没有页面验收标准、API 契约或 Convention Pack。
• 需要读取运行期真实数据；使用 project-data-reader。
• 需要自由设计品牌站、一次性静态页或不受脚手架约束的原型。

输入

1. 需求条目与页面验收标准。
2. 冻结的 API 契约或 mock schema。
3. 目标前端 Convention Pack：路由、目录、组件、状态、权限、i18n、样式、校验命令。
4. runtime-env：FE 启动命令、端口、探活 URL、teardown。

工作流

1. 定位 Convention Pack。通用约定读 references/frontend-convention-pack.md；若 scaffold_id=quantum-front 或目标 pack 路径匹配 quantum-front/docs/ai/convention-pack，再读 references/quantum-front-adapter.md。
2. 运行 python3 scripts/check_frontend_pack.py <convention-pack-dir>，缺必需文件/模板先停机补约定。
3. 读取 API 契约，生成类型、mock 数据、API client 或适配层；不得凭记忆补接口字段。
4. 生成页面、路由/注册、查询条件、表单校验、空态、错误态和权限态。
5. 运行 Convention Pack 声明的 lint/typecheck/build/unit 命令。
6. 从 runtime-env 启动 FE demo，访问探活 URL；失败则读错误、修复、重跑。