publish-app

使用するタイミング

ユーザーが既存の 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 が「About」のコンテンツとして使用されます。「About」タブでレンダリングされるのは 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）が設定されている場合は、そちらから検索することを優先してください。このサーバーは任意の拡張機能であり、このスキルの必須要件ではありません。