Agent Skills
返回列表
巨能业务模块代码生成器

巨能业务模块代码生成器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_46f7b2f4/jnrs-skills-biz。

技能介绍

解决什么问题

JNRS Vue 脚手架项目里，新增一个业务模块意味着重复四件事：按 OpenAPI 文档抄 TypeScript 接口类型与请求函数、写 .vue 页面里的表格与表单逻辑、处理多栏布局联动、最后手动往 public/system/menu.json 里加菜单项。接口字段靠人眼对文档抄，视图层再从零搭一套 script setup 样板，菜单路由写错一个层级往往要等到刷新页面才被发现。

jnrs-skills-biz 把这套流程拆成四个可单独触发的子技能，让 AI Agent 按固定顺序产出代码，并强制在每一层生成后跑 pnpm run type-check 验证。

核心能力

  • service-generator：扫描项目根目录 OAS/ 下的 openapi.json / *.yaml / *.yml 文件（也支持 mock 模式按模块生成），产出接口服务层的 TS 类型与 API 函数。多文件时会先列出清单让你多选，不擅自合并。
  • views-generator：基于已生成的服务层产出 .vue 文件，自动检测多栏布局；非标准 CRUD 形态走 index-vue.md 的特例说明。
  • script-generator：不直接生成文件，而是给 views-generator 提供控制层 patterns 参考（表格数据获取、表单提交、两栏联动等）。
  • menu-generator：基于视图层生成 menu.json，检测全局布局模块，批量列出待生成菜单项等你确认。

关键步骤

  1. 先跑 service-generator，询问你走 OAS 扫描还是 mock 模式；OAS 模式下运行 parse-oas.mjs 生成 manifest 后再按规则生成。
  2. 再跑 views-generator，由服务层推导页面。
  3. 最后跑 menu-generator，派生并确认菜单配置。
  4. service 与 views 生成后必须执行 pnpm run type-check（vue-tsc --build）到零错误，按常见类型陷阱清单修复。

批量生成时，推荐先扫 OAS/ 列文件、多选确认、逐文件生成并合并 manifest，再一次性确认全部模块的目录名与实体名，然后按 service → views → menu 顺序批量产出。

适用边界

这套技能只面向由 create-jnrs-vue 脚手架生成的项目。脚手架自带 src/views/examples/、src/api/examples/、viteMockServe/ 和 public/system/menu.json，技能文档里的 examples/、viteMockServe/ 引用都指向这些可运行模板，它们同时也是生成结果的验收标准。用在非脚手架项目上，必须先补齐上述目录，否则 pattern 引用会落空。

项目是 monorepo，@jnrs/ 命名空间下的库文件使用细节要查对应库的 AGENTS.md；架构说明、命名规范与全局约束（禁止 any、禁止臆造 OAS、examples 保护）在 _common.md 里。首次调用任一子技能时，还要执行一次 _common.md 里的 auth.ts 模板 ID 检查。

使用场景

  • 项目已从 ApiFox 导出 OpenAPI 到 OAS/，需要生成接口服务层的 TS 类型和 API 函数。
  • 接口服务层已就位，需要根据服务层生成列表页、编辑弹窗等 .vue 视图文件。
  • 页面视图已生成，需要往 public/system/menu.json 批量添加目录和路由菜单项。
  • OAS/ 下有多个模块的 openapi 文件，需要批量生成多个模块的 service 和 views。

适合人员

  • 使用 create-jnrs-vue 脚手架的前端工程师，需要快速产出业务模块的接口层、页面和菜单配置。
  • 负责 JNRS Monorepo 维护的开发者，需要按统一规范批量生成多模块的前端代码。
  • 编写 AI Agent 技能的工程师，需要给 Agent 提供可触发的 service 到 views 生成流程。
  • 审查生成代码质量的技术负责人，需要在生成后跑 type-check 并按陷阱清单修复类型错误。