关于 publish-app
用于整理并发布现有 Twenty 应用的技能,涵盖市场页面文案、品牌素材、元数据和 npm 发布。它引导应用维护者在发布前检查软件包信息与市场页面字段。
主要功能
- 01检查市场页面字段
- 02准备 README 和页面文案
- 03检查徽标与图库素材
- 04验证软件包版本和关键词
- 05构建并发布应用
适用场景
- 01准备应用的市场上架材料
- 02上线前检查应用元数据
- 03更新已发布应用的素材
- 04向 npm 发布应用新版本
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ twentyhq/ twenty --skill publish-app安装后在 Claude Code 中输入/publish-app确认已加载。
附带文件agents/openai.yaml
详细介绍
适用场景
当用户想让现有 Twenty 应用_做好展示准备_时,选择此技能——包括应用介绍文案、品牌形象、公开资源和发布。典型触发请求:
- “为我的 Twenty 应用做好在市场上架的准备”
- “为我的 Twenty 应用编写 README”
- “将我的应用发布到 npm”
- “添加徽标/截图/市场元数据”
- “设置
defineApplication市场字段” - “在上线前审核我的应用介绍”
- “发布已上架应用的新版本”
不要将此技能用于搭建应用脚手架(使用 create-app)、更改应用实体(使用 develop-app)、将私有构建版本部署到指定的 Twenty 服务(使用 manage-app),或查询工作区记录(使用 use-twenty-mcp)。
发布检查清单
如需了解 Twenty 应用的工作方式——SDK 包、远程服务、同步生命周期和渲染模型——请阅读 ../../references/concepts/how-apps-work.md。适用于所有 Twenty 应用任务的跨技能操作规则位于 ../../references/concepts/operating-rules.md;这些规则具有权威性,不会在各技能中重复说明。
详细了解 README、市场文案、徽标、截图和公开资源,请参阅 ../../references/publish-app/prepare-for-app-store.md。
保持技能工作流简洁:
- 检查
package.json、README.md、src/application-config.ts和public/。 - 发布到 npm 市场时,确保
package.json包含有效且已递增的version,以及twenty-app关键词。 - 在
defineApplication()中,检查面向市场的字段,例如displayName、description、author、category、logo、galleryImages、aboutDescription、websiteUrl、termsUrl、emailSupport和issueReportUrl。 - 确保
logo和galleryImages指向public/中的文件。公开资源不得包含机密、私有数据、客户记录、真实令牌或尚未发布的机密材料。 - 请注意,如果省略
aboutDescription,市场会使用 npm 中的包README.md作为“关于”内容。“关于”选项卡仅渲染 Markdown 文本,不会渲染图片和原始 HTML。 - 使用
twenty app build验证;使用twenty app publish或twenty app publish --tag <tag>发布。
使用边界
远程服务、部署到特定服务器、日志、故障排查和 CI/CD 操作,请使用 $manage-app。
如果应用实体本身需要更改,才能确保介绍内容准确,请使用 $develop-app。
文档
如果不清楚所需的发布细节,请先搜索 Twenty 官方文档 https://docs.twenty.com,不要凭猜测作答。如果已配置 Twenty 文档 MCP 服务(https://docs.twenty.com/mcp),优先通过该服务搜索。该服务是可选增强功能,并非此技能的必需条件。