Agent Skills: scaffold-module-gen

scaffold-module-gen

生成期代码脚手架 skill。脚手架无关：它本身不懂任何具体框架，全部框架知识来自 目标脚手架发布的 Convention Pack（约定包）。换一个脚手架 = 换一份 Convention Pack，本 skill 不改。

何时使用

• "给我在 quantum-backend 生成一个 XX 业务模块（含列表/详情/增删改查/权限点）"
• "在 quantum-front 加一个 XX 管理页面"
• 任何"按需求 + 依赖某个框架约定，快速产出可编译模块骨架"的场景

何时不使用

• 需要读取正在运行的系统里的真实数据 → 用 project-data-reader
• 自由发挥、不依赖任何既有框架约定的一次性脚本

输入

1. scaffold_id：目标脚手架标识（如 quantum-backend / quantum-front / <client>）
2. 需求描述：实体字段、需要的操作、权限点、菜单归属等

工作流（模板定骨架 · AI 填语义 · 编译器兜底）

1. 定位并加载 scaffold_id 对应的 Convention Pack：
   • conventions.md（分层 / 命名 / 权限 / 数据权限约定）
   • templates/（各层骨架模板）
   • validate.md（校验命令与自修流程）
2. 依需求把模板实例化成各层文件（后端：entity/mapper/serviceImpl/controller/DTO/convert/权限点/菜单 SQL； 前端：page/api/route/组件）。结构照模板，业务语义由你填。
3. 运行 Convention Pack 声明的校验命令（如 mvn -q -pl <module> -am compile / pnpm build）。
4. 校验失败 → 读编译/构建错误 → 定点修复 → 回到 3，直到通过。
5. 产出可编译的模块骨架 + 菜单/权限落库 SQL，并列出新增/修改的文件清单。

铁律

• 绝不从零凭记忆写整模块——必用 Convention Pack 的模板，避免偏离既有约定。
• 绝不在生成代码里自建认证/权限——沿用目标框架的权限注解与数据权限约定。
• 生成后必须跑一遍校验命令，未通过不算完成。

与 aether/pace 集成

本目录即一个标准 Agent Skill，直接放进 aether/pace 的 skills 目录、与 vm 叠加即可。 各脚手架的 Convention Pack 由各脚手架仓库自带（quantum-backend 见 docs/ai/convention-pack/）。