关于 create-app
create-app 使用独立 CLI 搭建新的 Twenty 应用,涵盖命名、初始化、依赖安装,以及可选的连接和同步步骤。
主要功能
- 01通过 CLI 初始化新应用
- 02设置应用名称和元数据
- 03单独安装依赖
- 04连接并同步工作区
- 05附带页面和健康检查
适用场景
- 01搭建新的 Twenty 应用
- 02指定自定义应用目录
- 03为同步到工作区做准备
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ twentyhq/ twenty --skill create-app安装后在 Claude Code 中输入/create-app确认已加载。
附带文件agents/openai.yaml
详细介绍
适用场景
适用于“创建一个 Twenty 应用”或“搭建一个新应用”等请求。
创建应用
新建应用时使用此技能。对于现有应用,请使用 develop-app 或 manage-app。
请先阅读 ../../references/concepts/how-apps-work.md 和 ../../references/concepts/operating-rules.md。
确认应用的名称和用途。使用独立 CLI:
npm install -g twenty
twenty app init <app-name>
cd <app-name>
yarn install
app init 只会写入文件。它不会安装依赖、初始化 Git、启动 Docker、进行身份验证或执行初始同步。
如需使用其他目标目录,请使用 --path <directory>;如需设置元数据,请使用 --display-name 或 --description。位置参数名称是软件包名称。
支持 Twenty Cloud 和自托管实例。需要连接时,询问现有 Twenty 工作区 URL。如果用户需要本地服务,请使用文档中介绍的 Docker 或仓库开发环境。
twenty auth login --url <twenty-instance-url> --name dev
twenty app apply --create --remote dev
只有在 apply 成功后,才能声称应用已安装。如果请求仅为搭建脚手架,则在创建文件和依赖项后停止。除非用户要求,否则不要运行大范围验证。集成测试请使用 ../../references/develop-app/tests.md 中介绍的隔离测试实例。
模板包含一个主页面、其布局和导航项,以及一个健康检查函数。如果应用不需要 UI,请移除占位页面及其布局和导航。请扩展现有健康检查,而不是另行声明一个。
创建完成后,实体和 UI 使用 develop-app,通过 twenty app apply 进行有限范围的同步使用 manage-app,发布工作使用 publish-app。