菜单
在 zerxLabKit 端到端新增一个管理模块的完整清单(proto→model→migrate→service→server→前端页→i18n→seed→routeTree→授权)。当用户要新增一个后台管理模块/资源/CRUD 页面(如商品、订单、配置项)时使用。Keywords: 新增模块, 管理模块, 后台模块, CRUD, 资源, 端到端, 完整流程, scaffold, 新建页面, add module, new module, 菜单, seed, 迁移, 全栈新增
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/zerx-lab/ZerxLabKit --skill zerx-add-module命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
zerxLabKit 编译期插件机制:以低侵入方式新增后台管理模块(后端 RPC + 表 + 前端动态页 + 菜单 + 授权),不破坏单二进制 / CGO-free / Casbin 唯一授权 / proto 唯一契约。当用户要用插件方式扩展、用 task new-plugin 脚手架、新增/启用/禁用/卸载插件、或排查插件注册/校验/动态前端页问题时使用。Keywords: plugin, 插件, plugin system, 插件机制, task new-plugin, task plugin-pack, 脚手架, scaffold, 上传插件, 安装插件, 卸载插件, install plugin, uninstall plugin, upload, zip, InstallPlugin, UninstallPlugin, internal/plugin, installer, all.go, ValidateAll, RegisterHandlers, 动态路由, import.meta.glob, p.$, pub.$, plugin-components, 编译期插件, compile-time plugin, 插件注册, 插件禁用, 插件卸载, teardown, PLUGIN_UPLOAD_ENABLED
zerxLabKit 接口授权与访问控制。当新增/修改 connectRPC handler、注册 service、配置 public/selfServe、调整 Casbin 策略、角色权限、菜单/按钮可见性时使用。Keywords: 授权, 鉴权, 权限, Casbin, RequireRole, public, selfServe, admin 绕过, procedure, RBAC, 角色, role, 三层访问控制, enforcer, SetRolePermissions, RoleMenu, RoleButton, Can, 菜单权限, 按钮权限, authorization, access control
zerxLabKit 后端开发规约(Go + connectRPC + GORM)。当新增/修改 RPC、实现 service handler、写数据访问、用 GORM 泛型 API、自定义 querier SQL、跑 codegen 时使用。Keywords: connectRPC, handler, service, GORM, gorm.G, 泛型, Count, FirstOrCreate, nilaway, getter, querier, 自定义 SQL, deleted_at, 软删, convert, proto, task gen, buf, 代码生成, JS 保留字, 后端, backend, Go
基于 SOC 职业分类
正在显示 SKILL.md
| name | zerx-add-module |
| description | 在 zerxLabKit 端到端新增一个管理模块的完整清单(proto→model→migrate→service→server→前端页→i18n→seed→routeTree→授权)。当用户要新增一个后台管理模块/资源/CRUD 页面(如商品、订单、配置项)时使用。Keywords: 新增模块, 管理模块, 后台模块, CRUD, 资源, 端到端, 完整流程, scaffold, 新建页面, add module, new module, 菜单, seed, 迁移, 全栈新增 |
编排清单;各步细节互链对应 skill,不复制其正文。
proto/zerx/v1/<mod>.proto 加 service + messages(方法名避开 JS 保留字;校验注解写字段上)→ task gen。细节 → skill://zerx-backend。internal/model/<mod>.go,标准字段块(ID/CreatedAt/UpdatedAt/DeletedAt)。在 internal/database/migrate.go 的 0001_baseline AutoMigrate 快照列表(现 21 个模型)对应位置注册 &model.<Mod>{};如需改列/回填另加 000N_* 迁移(HasColumn 守卫)。internal/service/<mod>_service.go,照抄 user_service.go 范式,无 RequireRole(授权交 Casbin)→ skill://zerx-authz、skill://zerx-backend;转换函数加进 convert.go。internal/server/server.go 用 reg(zerxv1connect.New<Mod>ServiceHandler(service.New<Mod>Service(...), opts)) 注册;按需把 procedure 加入 public / selfServe(assertServicesRegistered 会校验挂载)。web/src/routes/_authed/<mod>.tsx,复刻 users.tsx/params.tsx 范式;增删改按钮用 <Can code="<资源>:<动作>"> 包裹 → skill://zerx-frontend。web/src/lib/i18n.tsx 的 en 与 zh 同步加 key(结构锁,缺 key 编译失败)。internal/database/seed.go 的 seedMenuTree 加一节点;Title 存 i18n key,Icon 存 lucide 名,并在 web/src/lib/menu-icons.ts 的 iconByName 注册图标。task frontend:build(或 dev)让 Vite 插件重生成 web/src/routeTree.gen.ts 并提交。internal/database/seed.go)seedMenuNode{ node seedMenu, children []seedMenuNode };seedMenu{ menu model.Menu, buttons []model.MenuButton, userVisible bool }。Path 非空)或分组标题(Path == "",作 group heading,子项放 children)。{node: seedMenu{menu: model.Menu{Path: "/dashboard", Name: "dashboard", Title: "nav.dashboard", Icon: "LayoutDashboardIcon", Sort: 1}, userVisible: true}}
crudButtons("<资源>", "<中文标签>") → 生成 <资源>:create/update/delete;额外按钮直接 append。userVisible)、RoleButton(仅 admin)、syncAPIs() upsert 全量 procedure。syncMenus(按 menu.Name 匹配,仅插入不改不删)+ syncAPIs(按 procedure upsert,会 prune 过期行)。新菜单重启即生效,无需 DB reset。internal/apispec/apispec.go 的 Procedures() []Proc{Procedure, Service, Method} 遍历 protoregistry.GlobalFiles 筛 zerx.v1. 前缀;task gen 后新 service 的 procedure 自动入目录(syncAPIs 落库)。
internal/database/seed.go、internal/database/migrate.go、internal/apispec/apispec.go、web/src/routes/_authed/(范式页)、web/vite.config.ts。