메뉴
在 zerxLabKit 端到端新增一个管理模块的完整清单(proto→model→migrate→service→server→前端页→i18n→seed→routeTree→授权)。当用户要新增一个后台管理模块/资源/CRUD 页面(如商品、订单、配置项)时使用。Keywords: 新增模块, 管理模块, 后台模块, CRUD, 资源, 端到端, 完整流程, scaffold, 新建页面, add module, new module, 菜单, seed, 迁移, 全栈新增
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
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
zerxLabKit 认证与安全机制(JWT/会话/刷新/验证码/防爆破/审计日志/文件上传/对象存储)。当处理登录注册、token 刷新、会话管理、登录限流、操作日志、上传、存储 driver 时使用。Keywords: JWT, access token, refresh token, 会话, session, jti, 单点登录, AUTH_SINGLE_SESSION, 验证码, captcha, 防爆破, ratelimit, 锁定, 审计, 操作日志, OperationLog, login_logs, 上传, upload, 对象存储, storage, local, s3, minio, password policy, password reset, SMTP, mailer, TOTP, 2FA, MFA, export, import, xlsx, OpenAPI, docs, cron, job, scheduler, readyz, 安全, security, 认证, auth
zerxLabKit 前端开发规约(React 19 + TanStack + connect-query + Zod4 + Tailwind v4)。当新增/修改路由页、CRUD 列表/表单、调用 connect-query hooks、做缓存失效、i18n、主题时使用。Keywords: React, TanStack Router, react-query, useQuery, useMutation, connect-query, createConnectQueryKey, invalidateQueries, react-form, Zod, Tailwind v4, bigint, uint64, table v8, i18n, 主题, theme, 语义 token, Can, permissions, gcTime, placeholderData, 前端, frontend
为 zerxLabKit 编写/维护/更新 .agents/skills 下 AI skill 的元规约:token 高效、陈述事实而非教学、进步式披露、frontmatter 与描述关键词写法、何时该新增 skill、代码变更后如何定位并同步对应 skill。当用户要新增/修改/审查/更新本仓库的 skill 或 AI 指令文件、或某子系统代码变更需同步 skill 时使用。Keywords: skill, SKILL.md, .agents/skills, 编写规约, 元技能, frontmatter, description, 关键词, 进步式披露, progressive disclosure, token 高效, 上下文, AGENTS.md, prompt, 提示词, 编写技巧, 更新 skill, 维护 skill, 同步, 变更, 调研源码, 代码变更, 漂移, sync, update, maintain
| 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。