开发第一个应用

从空目录创建一个 NocoBase 应用，再让 Agent 开发客户管理：记录客户、负责销售和下次跟进，并按角色限制查看与修改范围。完成后，你可以登录应用操作客户数据，继续提出需求迭代。

准备环境

以下使用 SQLite，无需单独安装数据库服务。使用其他数据库，请参阅使用不同数据库创建应用。

可以交给 Agent 创建，也可以自己执行命令，任选一种。

安装创建应用的 Skill，按提示选择你使用的 Agent：

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

如果 Agent 已经打开，要重新打开会话才能用上新安装的 Skill。然后在一个空目录（例如 my-app）打开 Agent，发送：

在当前空目录创建一个本地开发用的 NocoBase 3 应用，使用默认模板和 SQLite。
启动后告诉我访问地址和首次登录的账号。

Agent 会创建应用、生成配置并启动，完成后告诉你应用的地址和首次登录的账号。

在存放应用的目录执行下面的命令，创建工具会新建 my-app 目录并安装依赖：

PNPM_CONFIG_MINIMUM_RELEASE_AGE=0 pnpm create @nocobase/app@beta my-app --template-tag=beta

NocoBase 3 还在 beta 阶段。PNPM_CONFIG_MINIMUM_RELEASE_AGE=0 让 pnpm 可以安装刚发布的版本，只对这一次执行有效。

进入目录，生成配置，检查后启动：

cd my-app
pnpm nocobase config init --dialect sqlite
pnpm nocobase config check
pnpm dev

config init 生成本机配置 config.yml 和应用密钥。数据库用 SQLite，不用另外安装。config.yml 不提交到 Git。
config check 按启动时的方式加载配置，有问题时给出修复提示。
pnpm dev 启动开发服务器，启动后在终端输出 Local: 地址。保持这个终端运行，关掉它，应用就停止。

在刚创建的应用根目录打开 Agent，再提出业务需求。

把下面这段发给 Agent：

帮我做客户管理。客户有名称、联系方式、备注、负责销售、下次跟进日期，状态分潜在、跟进中、已成交。
可以新建、查看、编辑、删除客户，按名称搜索，按状态筛选。
销售主管管理全部客户；销售只能查看自己负责的客户，并更新它们的状态；只读用户可以查看全部客户，不能修改。

需求只写业务：要记录什么，能做哪些操作，谁能做什么。Agent 会按项目的 Skill 自己处理用户和权限管理、多语言文案、测试和汇报。

开发之前，Agent 会先给出设计，请你确认页面结构、主要交互，以及需要你决定的问题。回答这些问题，确认后它开始开发。

Agent 开发完会自己运行测试，在浏览器里逐项验收并截图，然后交给你一份报告，列出做了什么和没有验证的部分。验收需要登录时，它会请你自己登录。

打开 Agent 给出的地址，侧边栏出现 Customers。在这里可以新建客户、指定负责销售和下次跟进日期、更新状态，也可以搜索和筛选：

截图来自示例应用。同一段需求每次做出来的布局可能不同。

Agent 会一并启用用户管理和权限管理。按下面的步骤，看看销售能做什么：

在 System settings → Users 添加一个用户，在 Permission sets 中加上销售角色（示例应用里叫 Sales rep）。
新建一个客户，负责销售选这个用户。
换这个账号登录。客户列表里只有这个用户负责的客户；可以更新状态，不能编辑资料或删除。

再分别用销售主管和只读用户检查：主管应能管理全部客户；只读用户能查看全部客户，但不能新建、修改或删除。若报告中有未验证项，先完成对应检查，再继续增加功能。

如果结果不对，或者想换一种做法，告诉 Agent 你做了什么、看到了什么、期望什么：

我用只分配了销售角色的账号登录，仍能看到别人负责的客户。
销售应该只能看到自己负责的客户。

交互也可以直接提，例如“点击客户名称先打开详情，再决定是否编辑”。

接下来可以添加客户跟进记录。仍在应用根目录的 Agent 会话中提出需求：

给客户加上跟进记录。销售每次联系客户后记一条：日期、方式（电话、拜访或邮件）和内容。
客户详情里按时间倒序显示跟进记录。
销售只能给自己负责的客户记跟进；销售主管能看全部记录；只读用户只能查看。
已有的客户不用补历史记录。

先确认设计，再按销售、主管和只读用户分别检查结果。需求较大时，按可独立使用的业务功能拆分，例如跟进记录、销售机会、报价和销售报表；每完成一部分就验证一次。

长期适用的约定可以让 Agent 保存到项目规范，例如“以后所有日期都按公司所在的时区计算，保存到项目规范”。这些约定记录在 .agents/rules/，由 AGENTS.md 索引，供后续会话使用。

查看CRM 示例源码及其 README。理解文件分工可查阅项目结构，后续开发、部署和团队协作见学习路径。