wenjunduan scaffold-page-gen
前端页面生成 skill。职责是把需求清单和冻结的 API 契约落成可运行页面、mock 数据、路由和本地 demo。
本 skill 系统无关：页面结构、组件库、路由、权限、mock 方式、校验命令全部来自目标项目的
Convention Pack；运行命令只从 runtime-env 读取。
何时使用
- 需要按既有前端脚手架生成业务页面、列表、详情、表单或工作台视图。
- 需要在真实后端完成前，用冻结契约生成 mock 数据并启动本地 demo。
- 需要把页面生成证据纳入
runtime-verify或业务交付报告。
何时不使用
- 需求还没有页面验收标准、API 契约或 Convention Pack。
- 需要读取运行期真实数据；使用
project-data-reader。 - 需要自由设计品牌站、一次性静态页或不受脚手架约束的原型。
输入
- 需求条目与页面验收标准。
- 冻结的 API 契约或 mock schema。
- 目标前端 Convention Pack：路由、目录、组件、状态、权限、i18n、样式、校验命令。
runtime-env：FE 启动命令、端口、探活 URL、teardown。
工作流
- 定位 Convention Pack。通用约定读
references/frontend-convention-pack.md；若scaffold_id=quantum-front或目标 pack 路径匹配quantum-front/docs/ai/convention-pack，再读references/quantum-front-adapter.md。 - 运行
python3 scripts/check_frontend_pack.py <convention-pack-dir>，缺必需文件/模板先停机补约定。 - 读取 API 契约，生成类型、mock 数据、API client 或适配层；不得凭记忆补接口字段。
- 生成页面、路由/注册、查询条件、表单校验、空态、错误态和权限态。
- 运行 Convention Pack 声明的 lint/typecheck/build/unit 命令。
- 从
runtime-env启动 FE demo，访问探活 URL；失败则读错误、修复、重跑。 - 记录页面路径、命令、探活结果、截图或日志摘要，交给
runtime-verify。
输出
- 新增或修改的前端页面、路由、API、模型、mock、测试文件。
- 校验命令结果、demo 探活证据、关键页面截图路径。
- 需求条目到页面能力的映射，供
biz-delivery-loop汇总。
铁律
- 不猜脚手架；Convention Pack 没声明的结构先停机补约定。
- 不猜环境；端口、命令、URL、teardown 只读
runtime-env。 - 不绕过权限、数据域、表单校验和错误态；缺规则时标记 blocked。
- 不把 mock 当真实对接完成；mock 到真实接口必须进入后续集成验证。
PACE 集成
- design stage：消费页面验收标准、效果图和冻结 API 契约。
- impl stage：生成页面与 mock demo。
- runtime-verify stage：实跑 FE demo、保存截图和探活证据。
- review stage：由 spec-compliance 核对需求、契约和生成文件是否一致。
References
references/frontend-convention-pack.md: 所有前端脚手架必须提供的 pack contract。references/quantum-front-adapter.md: quantum-front 的首个具体适配器。scripts/check_frontend_pack.py: pack 结构和模板完整性校验脚本。