用官方 Agent Skill 搭建 NocoBase 3 应用

每一个 AI 搭出来的业务应用都在重复造同样的地基：权限、工作流引擎、审批——边界情况极多，而且每个会话的实现方式可能都不一样。NocoBase 是用 AI 持续开发和运行业务系统的开源平台，现在它发布了官方 agent skill，让 Coding Agent 面对的是现成的地基，而不是一个空目录。

为什么这个 Skill 重要

NocoBase 的 README 直接点出了这些问题：每个项目都在从零重建权限和工作流引擎，架构随会话漂移，并行的工作量超出人工评审的能力，经验心得散落在各个聊天会话里。平台提供了这块地基，官方 skill 则教会你的 agent 如何在上面构建——创建应用、安装成果，并在 NocoBase 3 源码工作区里开发插件。

发行仓库 nocobase/skills-v3 是主仓库 nocobase/nocobase 中维护的 skill 的轻量镜像，目前包含三个 skill：

安装

在空目录中开启支持 Skills 的 Coding Agent，安装创建应用的 Skill：

npx skills@latest add nocobase/skills-v3 --skill nocobase-create-app -g

安装时选择当前使用的 Agent；若未识别到新 Skill，重新开启会话。

想一次装齐三个 skill，把 skill 名换成 '*'：

npx skills@latest add nocobase/skills-v3 --skill '*' -g

之后可用 npx skills@latest update 检查已跟踪 skill 的更新。NocoBase 2 用户应改用独立的 nocobase/skills 仓库——skills-v3 只面向 NocoBase 3。

实战：从空目录创建一个 NocoBase 3 应用

主仓库 README 的快速开始要求 Node.js 24+ 和 pnpm 11；Windows 用户请使用 WSL。示例使用 SQLite，无需单独安装数据库服务。

1. 在空目录中打开装好 skill 的 Coding Agent。
2. 发送 README 记载的提示词：

Follow the nocobase-create-app Skill to create and start a NocoBase 3 application in the current empty directory, using the default template and SQLite.

3. 跟随 skill 在该目录中完成脚手架搭建并启动应用。

如果偏好终端操作，README 也记载了无 agent 的路径：先在存放项目的父目录执行 PNPM_CONFIG_MINIMUM_RELEASE_AGE=0 pnpm create @nocobase/app@beta my-app --template-tag=beta，进入应用目录后再依次执行 pnpm nocobase config init --dialect sqlite、pnpm nocobase config check 和 pnpm dev。

技巧

• 按发行仓库 README 的 skill 表，插件开发 skill 面向 NocoBase 3 的源码工作区。
• 旧的全局安装不会被自动清除。发行仓库 README 提到：从更早的 nocobase-v3-plugin-development 发行名迁移需要重新安装，删除安装前应先确认它属于哪个版本。
• Skill 内容在主仓库 nocobase/nocobase 中维护并同步到 skills-v3——想改 skill 行为，去源仓库改并提 PR，不要改发行仓库。
• 应用侧的 skill（如主仓库 app-skills 包下的应用开发与部署 skill）随各自的 npm 包发布，不走 skills-v3。

何时不用这个 Skill

如果你在维护 NocoBase 2 应用，skills-v3 不是正确目标——NocoBase 2 的 skill 在另一个仓库里。如果你只想要一个用完即弃的原型，不需要权限、工作流和审批，那一个带治理的平台对这种项目来说超出了实际需要。

查看 排行榜 了解更多 skill。