用途:在 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 开发、数据库资源、国际化、Registry、Plugin Skills、CLI 插件、测试与交付;并提供 Server Route、ServiceToken/Provider、Client、Repository 等示例。
使用方式:用 pnpm plugin:create 创建插件并显式声明能力(需要时含 cli),用 --dry-run --json 预览。声明保持静态、无启动副作用;页面组件、语言包、重型 SDK 按需懒加载。通过 useApiClient() 或 apiClientToken 复用宿主 API 客户端。Server 插件须声明绝对 baseDir;迁移需显式、自包含、合并后不可变并在真实数据库测试。Client、Server、CLI 导出需在对应 App 组合根显式注册。
限制:插件集成知识写在 <plugin>/skills/,目标 App 的 .agents/skills/ 为生成产物。不要因本技能适用就执行创建、注册、迁移等有状态命令。plugin inspect 仅为只读诊断,不是测试或完成门槛。资料未提供具体收费、价格与平台信息。