用途:在 NocoBase 3 仓库中进行插件源码开发。使用前需阅读适用的 AGENTS.md,并检查目标插件与 App;确认工作区包含 packages/tools/create-plugin/、packages/app/app-client/、packages/app/app-server/ 和 pnpm-workspace.yaml。仅有 packages/plugins/ 目录不能判定为 v3,不要套用旧版 Plugin 类、src/client-v2/ 或 nb scaffold plugin 协议。
主要能力:按任务选择参考文档,覆盖脚手架与包契约、注册与生命周期、Client 架构、shadcn 组件与样式、Client 路由、系统设置、Services 与 Providers、Server 开发、HTTP API 规则、数据库资源、国际化、Registry、Plugin Skills、CLI 插件、测试与交付。
使用方式:用 pnpm plugin:create 创建插件并显式声明能力(需要时含 cli),用 --dry-run --json 预览。保持声明静态、无启动副作用;页面组件、语言包、重型 SDK 在叶子边界懒加载。通过 useApiClient() 或 apiClientToken 复用宿主 API 客户端。每个 /api 路由遵循 HTTP API 规则:插件命名空间下 camelCase 路径、标准方法、{ data } 响应、失败用 ApiError、zod 经 apiValidator() 校验、每个路由用 describeRoute() 声明。Server 插件声明绝对 baseDir,迁移显式、自包含、合并后不可变。Client、Server、CLI 导出需在对应 App 组合根显式注册。
适用场景:插件脚手架与包契约、UI 与路由、服务契约与依赖注入、HTTP 端点与后台任务、迁移与种子、国际化、CLI 命令、测试与交付等。
限制:不要默认加载全部参考文档;不要因本技能适用就运行创建、注册、迁移等有状态命令;plugin inspect 仅为只读诊断,不是测试或完成门槛。资料未提供具体版本号、收费与平台信息。