Run any Skill in Manus with one click

zerx-add-module

Stars0

Forks0

UpdatedJune 24, 2026 at 07:38

在 zerxLabKit 端到端新增一个管理模块的完整清单(proto→model→migrate→service→server→前端页→i18n→seed→routeTree→授权)。当用户要新增一个后台管理模块/资源/CRUD 页面(如商品、订单、配置项)时使用。Keywords: 新增模块, 管理模块, 后台模块, CRUD, 资源, 端到端, 完整流程, scaffold, 新建页面, add module, new module, 菜单, seed, 迁移, 全栈新增

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

zerx-lab

zerx-lab/ZerxLabKit

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

SKILL.md

readonly

name

zerx-add-module

description

zerxLabKit 端到端新增管理模块

编排清单;各步细节互链对应 skill,不复制其正文。

有序清单(9 步)

proto:proto/zerx/v1/<mod>.proto 加 service + messages(方法名避开 JS 保留字;校验注解写字段上)→ task gen。细节 → skill://zerx-backend。
model:internal/model/<mod>.go,标准字段块(ID/CreatedAt/UpdatedAt/DeletedAt)。在 internal/database/migrate.go 的 0001_baseline AutoMigrate 快照列表(现 21 个模型)对应位置注册 &model.<Mod>{};如需改列/回填另加 000N_* 迁移(HasColumn 守卫)。
service:internal/service/<mod>_service.go,照抄 user_service.go 范式,无 RequireRole(授权交 Casbin)→ skill://zerx-authz、skill://zerx-backend;转换函数加进 convert.go。
server: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。
i18n:web/src/lib/i18n.tsx 的 en 与 zh 同步加 key(结构锁,缺 key 编译失败)。
seed:在 internal/database/seed.go 的 seedMenuTree 加一节点;Title 存 i18n key,Icon 存 lucide 名,并在 web/src/lib/menu-icons.ts 的 iconByName 注册图标。
routeTree:task frontend:build(或 dev)让 Vite 插件重生成 web/src/routeTree.gen.ts 并提交。
授权:如需授予非 admin,到「角色管理」页为角色分配菜单 / API procedure / 按钮。

seed 实测细节(`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}}

标准 CRUD 按钮用 helper:crudButtons("<资源>", "<中文标签>") → 生成 <资源>:create/update/delete;额外按钮直接 append。
幂等键 = Role 表为空:首次播种 admin/user 角色、DFS 插菜单树、RoleMenu(admin 全 / user 仅 userVisible)、RoleButton(仅 admin)、syncAPIs() upsert 全量 procedure。
已初始化库:每次启动增量reconcile——syncMenus(按 menu.Name 匹配,仅插入不改不删)+ syncAPIs(按 procedure upsert,会 prune 过期行)。新菜单重启即生效,无需 DB reset。

procedure 目录来源

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。

More from this repository

same repository

zerx-plugin

zerx-lab/ZerxLabKit

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

2026-06-250

zerx-authz

zerx-lab/ZerxLabKit

zerxLabKit 接口授权与访问控制。当新增/修改 connectRPC handler、注册 service、配置 public/selfServe、调整 Casbin 策略、角色权限、菜单/按钮可见性时使用。Keywords: 授权, 鉴权, 权限, Casbin, RequireRole, public, selfServe, admin 绕过, procedure, RBAC, 角色, role, 三层访问控制, enforcer, SetRolePermissions, RoleMenu, RoleButton, Can, 菜单权限, 按钮权限, authorization, access control

2026-06-240

zerx-backend

zerx-lab/ZerxLabKit

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

2026-06-240

zerx-security

zerx-lab/ZerxLabKit

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

2026-06-240

zerx-frontend

zerx-lab/ZerxLabKit

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

2026-06-240

zerx-skill-authoring

zerx-lab/ZerxLabKit

为 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

2026-06-240

name

zerx-add-module

description

zerxLabKit 端到端新增管理模块

编排清单;各步细节互链对应 skill,不复制其正文。

有序清单(9 步)

proto:proto/zerx/v1/<mod>.proto 加 service + messages(方法名避开 JS 保留字;校验注解写字段上)→ task gen。细节 → skill://zerx-backend。
model:internal/model/<mod>.go,标准字段块(ID/CreatedAt/UpdatedAt/DeletedAt)。在 internal/database/migrate.go 的 0001_baseline AutoMigrate 快照列表(现 21 个模型)对应位置注册 &model.<Mod>{};如需改列/回填另加 000N_* 迁移(HasColumn 守卫)。
service:internal/service/<mod>_service.go,照抄 user_service.go 范式,无 RequireRole(授权交 Casbin)→ skill://zerx-authz、skill://zerx-backend;转换函数加进 convert.go。
server: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。
i18n:web/src/lib/i18n.tsx 的 en 与 zh 同步加 key(结构锁,缺 key 编译失败)。
seed:在 internal/database/seed.go 的 seedMenuTree 加一节点;Title 存 i18n key,Icon 存 lucide 名,并在 web/src/lib/menu-icons.ts 的 iconByName 注册图标。
routeTree:task frontend:build(或 dev)让 Vite 插件重生成 web/src/routeTree.gen.ts 并提交。
授权:如需授予非 admin,到「角色管理」页为角色分配菜单 / API procedure / 按钮。

seed 实测细节(`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}}

标准 CRUD 按钮用 helper:crudButtons("<资源>", "<中文标签>") → 生成 <资源>:create/update/delete;额外按钮直接 append。
幂等键 = Role 表为空:首次播种 admin/user 角色、DFS 插菜单树、RoleMenu(admin 全 / user 仅 userVisible)、RoleButton(仅 admin)、syncAPIs() upsert 全量 procedure。
已初始化库:每次启动增量reconcile——syncMenus(按 menu.Name 匹配,仅插入不改不删)+ syncAPIs(按 procedure upsert,会 prune 过期行)。新菜单重启即生效,无需 DB reset。

procedure 目录来源

源码锚点

internal/database/seed.go、internal/database/migrate.go、internal/apispec/apispec.go、web/src/routes/_authed/(范式页)、web/vite.config.ts。

zerx-add-module

zerxLabKit 端到端新增管理模块

有序清单(9 步)

seed 实测细节(internal/database/seed.go)

procedure 目录来源

源码锚点

More from this repository

More from this repository

zerxLabKit 端到端新增管理模块

有序清单(9 步)

seed 实测细节(internal/database/seed.go)

procedure 目录来源

源码锚点

seed 实测细节(`internal/database/seed.go`)

seed 实测细节(`internal/database/seed.go`)