CMM Publishing
cmm-publishing は、CMMコンテンツファクトリーにおける公開・ドラフトラウティングレイヤーです。
content_package、オプションの visual_package、およびオプションの video_package を消費し、プラットフォームサポート、メタデータ、アセットマッピング、承認ゲート、実行ルートを含む publish_package を生成します。明示的な確認後、承認されたバックエンドはドラフトまたはブラウザレビュー状態を作成できます。
境界
このスキルは以下の用途に使用します:
publish_packageのアセンブル。- ターゲットを
draft_box、browser_review、schedule_plan、manual_upload、unsupportedのいずれにするかの決定。 - プラットフォームメタデータ、アセットマッピング、チェックリスト出力の準備。
- プラットフォーム実行前のバックエンドプリフライトの実行。
- 優先バックエンドが利用できない場合の安全なフォールバックの選択。
- 承認された実行バックエンドとしてのみ、WeChat、X、Weibo、Xiaohongshu、またはソーシャルスケジューリングワークフローの選択。
- まだサポートされていないプラットフォームの公開ギャップの記録。
このスキルは以下の用途に使用しないでください:
- コンテンツドラフトの作成。
- 画像の生成や動画のレンダリング。
- デフォルトでの
Publish、Post、发布、または外部から見える送信アクションのクリック。
公開境界
このスキルは publish_package をアセンブルし、ドラフト/手動アップロード手順を準備します。組み込み公開パス: WeChatドラフトボックスAPI (scripts/wechat_draft.py)、WeChatブラウザドラフトフォールバック (scripts/wechat_browser_draft.mjs)、X (scripts/x_publish.mjs)、Weibo (scripts/weibo_publish.mjs)、Douyin (scripts/douyin_publish.py)。ブラウザパスはデフォルトで フィルオンリー です。アシスタントはコンテンツを入力して最終公開前で停止し、ユーザー自身がブラウザで公開をクリックします(確認時でも、アシスタントは自動クリックしません — 確認ルールを参照)。
まだ組み込まれていないプラットフォーム(例: Xiaohongshuライブフィル)へのライブ自動公開は、オプションプラグイン のままであり、デフォルトではルーティングされません。プラットフォーム固有のギャップが発生した場合は、platform_gaps に記録し、CMMコントラクトまたはドキュメントを更新します。
入力
推奨入力:
content_package:
platform: ""
format: ""
title: ""
body_markdown: ""
summary: ""
sources_used: []
publish_notes: ""
status: draft
visual_package:
asset_paths: []
status: draft
video_package:
render_path: ""
cover_path: ""
publish_copy: ""
status: draft
正確な出力フィールドについては references/publish-package-contract.md を参照してください。サポートマトリックス、メタデータ、承認ルール、バックエンドプリフライト、フォールバック動作については references/publishing-method.md を参照してください。WeChatドラフト作成前には references/wechat-quality-gate.md を参照し、WeChatレイアウトハンドオフには templates/wechat-layout-package-template.md を使用します。
ワークフロー
- 利用可能なパッケージを検証。
- ターゲットプラットフォームを特定。
- ターゲットモードを選択:
draft_box: サポートされている場合のAPIまたはプラットフォームドラフト。browser_review: ブラウザが開き、コンテンツが入力され、ユーザーが手動でレビュー。schedule_plan: 計画/カレンダー出力のみ。unsupported: プラットフォームギャップを記録。
publish_packageを構築。- メタデータ、チェックリスト、プラットフォームギャップ、承認要件を追加。
- 選択したバックエンドに対して、プラットフォーム実行前にプリフライトを実行:
- ランタイム依存関係
- 認証情報またはログイン状態
- 検出可能なAPI/IP許可リスト制約
- 必要なカバー/画像/動画アセット
- バックエンド機能のギャップ
- プリフライトが失敗した場合、文書化されたフォールバックを選択するか、具体的な
platform_gapsアイテムを指定してpublish_status: blockedを設定します。「優先バックエンドの修復」と「フォールバックバックエンド」の両方が実行可能な場合、自動的に切り替えないでください。理由、作成されたドラフト/アセットの有無を報告し、決定オプションを提示し、ユーザーが選択するのを待ちます。 - ユーザーが同じターンですでにドラフト/ブラウザ/手動準備を要求していない限り、プラットフォームスキルを呼び出す前に明示的な確認を求めます。CMMコンテンツファクトリーからのWeChat長文出力の場合、ローカルプレビューゲートは同じターンのドラフト意図よりも優先されます。ユーザーがレンダリングされたプレビューを確認し、ドラフトボックス作成を確認するまで、WeChatドラフトボックスバックエンドを呼び出さないでください。
- 確認後、またはより厳格なプレビューゲートが適用されない同じターンのドラフト意図がある場合にのみ、承認されたバックエンドにルーティング。
- ユーザーが同じターンで最終公開アクションを明示的に確認しない限り、最終公開前で停止。
ルーティング
デフォルトの出力は、公開パッケージ+ドラフト/手動アップロード手順です。 X、Weibo、Douyin、WeChatドラフトは 組み込み(デフォルトで公開前レビュー)です。右側の列は、ライブ公開にまだ オプションのライブ公開プラグイン が必要なプラットフォームを示します。関連するランタイムがない場合は、手動アップロードパスに従います。
| プラットフォーム | CMMターゲット(デフォルト) | ライブ公開(組み込み / オプションプラグイン) |
|---|---|---|
| WeChat公式アカウント | draft_box 組み込み scripts/wechat_draft.py 経由。API/IP許可リストでブロックされた場合のブラウザフォールバックは scripts/wechat_browser_draft.mjs 経由。 | —(ドラフト/フィルパスは組み込み) |
| X / Twitter | 組み込み ブラウザ公開 scripts/x_publish.mjs 経由(生CDP、ネイティブChrome起動、永続ログイン、デフォルトで公開前レビュー)。詳細は references/x-publish.md を参照。手動アップロードにフォールバック。 | —(組み込み) |
組み込み ブラウザ公開 scripts/weibo_publish.mjs 経由(生CDP、ネイティブChrome起動、永続ログイン、デフォルトで公開前レビュー)。詳細は references/weibo-publish.md を参照。手動アップロードにフォールバック。 | —(組み込み) | |
| Xiaohongshu / Rednote 画像ノート | 公開パッケージ + 手動アップロード | オプションのブラウザ公開プラグイン |
| Xiaohongshu / Rednote 動画ノート | 公開パッケージ + 手動アップロード | オプションのブラウザ公開プラグイン |
| クロスプラットフォームカレンダー | schedule_plan(計画のみ) | オプションのスケジューラープラグイン |
| Douyin | 組み込み ブラウザ公開 sau (scripts/douyin_publish.py、デフォルト --review-before-publish) 経由。詳細は references/douyin-publish.md を参照。sau が利用できない場合は manual_upload にフォールバック。 | —(組み込み) |
| Bilibili | manual_upload または unsupported | 確認されるまでなし |
publish_package
publish_package:
platform: ""
target: draft_box
title: ""
body_ref: ""
body_markdown: ""
asset_refs: []
video_ref: ""
metadata: {}
approval_status: pending
publish_status: not_started
route: ""
approval_gate:
draft_creation: pending
final_publish: required_same_turn
backend_preflight: []
fallback_history: []
readiness_gate: {}
checklist: []
platform_gaps: []
external_result: {}
確認ルール
publish_packageの構築は確認を必要としません。- ユーザーが同じターンでプラットフォームドラフト、ドラフトボックス、ブラウザレビュー、または手動アップロードパッケージを明示的に要求した場合、より厳格な上流プレビューゲートが満たされるまで
approval_status: target_intent_recordedを設定します。プレビュー確認と明示的なドラフトボックス/ブラウザ確認後、approval_status: approved_for_draftを設定し、ドラフト準備を許可します。 - ブラウザ/API/プラットフォームスキルの呼び出しには、現在のユーザーリクエストがすでにドラフト/ブラウザ/手動準備を明確に要求しており、より厳格なプレビューゲートが適用されない場合を除き、明示的な確認が必要です。
- デフォルトではフィルオンリー — ユーザー自身が最終公開ボタンをクリックします。 すべてのブラウザ駆動プラットフォームにおいて、アシスタントはドラフト/コンポーザー/クリエーターバックエンドに入力し、公開ボタンで停止し、開いているブラウザをユーザーに渡して公開します。アシスタントはデフォルトで最終公開ボタンをクリック しません。ユーザーが確認した場合でも同様です — 公開クリックはブラウザでのユーザーの操作です。(理由: 公開時の非同期送信/再レンダリングにより以前に投稿が破損したことがあります。例: クリック時に本文が削除される。)アシスタントは入力し、スクリーンショットを撮るか状態を報告して、ユーザーがレビューして公開できるようにします。
--auto-publish/--submitおよび自動クリックスイッチは、ユーザーが同じターンで明示的に自動公開を要求した場合に のみ 使用します。それ以外の場合は常に公開ボタンで停止します。- デフォルトで
--submitを使用したり、最終公開ボタンをクリックしたりしないでください。 - ルーティングされたレガシースキルにより厳格な確認ルールがある場合は、その厳格なルールに従います。
準備ゲート
| ゲート | 要件 |
|---|---|
content_ready | ドラフトが存在し、ブロックされていない。 |
asset_ready | 必要なカバー/画像/動画が存在するか、ギャップが明示されている。 |
metadata_ready | タイトル、概要、タグ、カバー、アカウント/プラットフォームノートが関連する場合に準備されている。 |
approval_ready | ドラフト作成と最終公開の承認が分離されている。 |
platform_supported | プラットフォームルートがサポートされているか、手動であるか、明示的にサポートされていない。 |
プラットフォームノート
- ドラフトボックス動作を優先。
- 多くの記事フローではカバー画像が必要。
- API/IP許可リストまたはブラウザログインが必要な場合がある。
- 可能な場合は、完全なAPIドラフト作業を行う前に、API認証情報とIP許可リストをプリフライト。
- APIがIP許可リストまたはトークン権限エラーで失敗した場合、Chrome/ログイン要件が満たされていれば、組み込みブラウザルート (
scripts/wechat_browser_draft.mjs) にフォールバック。 - ブラウザドラフト作成では、すべてのバックエンドでカバー画像が設定されない場合がある。選択したバックエンドがカバー挿入を確認できない場合は、
asset_gapを記録し、checklistにカバーパスを含めます。
X
- 組み込み 公開
scripts/x_publish.mjs経由(CMMネイティブ、生CDP、npm依存関係ゼロ — Node ≥21組み込みWebSocketを使用)。永続プロファイル(~/.cmm/chrome-x)でネイティブChromeを起動。初回実行時は一度だけx.comログインを促します(通常のブラウザのため、Google/X SSOはブロックされません)。以降は再利用。保存された認証情報はありません。--cdp URLで既に実行中のデバッグポートChromeにアタッチできます。 - テキストはCDP
Input.insertText経由で注入されます(実際のキーボード入力: XのDraft.js EditorStateに書き込むため、再レンダリング後も存続します。execCommand('insertText')はDOMにのみ触れ、公開時に消去されました —references/x-publish.mdを参照)。タブが前面にあることと、実際のクリックでフォーカスが必要です。メディアはCDPDOM.setFileInputFiles経由。 - フィルオンリー: コンポーザーに入力し、投稿ボタンで停止。ユーザー自身がブラウザで投稿をクリックします(
--auto-publishは明示的な同じターンの要求がある場合のみ)。 references/x-publish.mdを参照。Chrome/デバッグポート/ログインが利用できない場合はmanual_uploadにフォールバック。
- 組み込み 公開
scripts/weibo_publish.mjs経由(CMMネイティブ、生CDP、npm依存関係ゼロ)。永続プロファイル(~/.cmm/chrome-weibo)でネイティブChromeを起動。初回実行時は一度だけweibo.comログインを促します。保存された認証情報はありません。 - ホームコンポーザーの
<textarea>にCDPInput.insertTextで入力。画像/動画(合計≤18)はCDPDOM.setFileInputFiles経由。 - フィルオンリー: コンポーザーに入力し、送信ボタンで停止。ユーザー自身がブラウザで送信をクリックします(
--auto-publishは明示的な同じターンの要求がある場合のみ)。 references/weibo-publish.mdを参照。Chrome/デバッグポート/ログインが利用できない場合はmanual_uploadにフォールバック。
Xiaohongshu / Rednote
プリフライトチェック(公開前必須)
| 項目 | 制限 |
|---|---|
| タイトル | ≤ 20 文字 |
| 本文(末尾のハッシュタグ行を除く) | ≤ 950 文字(プラットフォーム上限1000、安全マージン確保) |
| 画像数 | 1–9 枚 |
| 画像フォーマット | jpg / png / webp、1枚 ≤ 32MB |
公開フロー(画像ノート、確認済み)
Step 1 — 画像アップロードページに直接移動
https://creator.xiaohongshu.com/publish/publish?from=menu&target=image
「ノートを公開」ドロップダウンメニューからクリックせず、URLで直接ジャンプ。
Step 2 — アカウント確認
get_page_text または javascript_tool を使用してページ右上のアカウント名を読み取り、目的のアカウントであることを確認してから続行。アカウントが異なる場合はユーザーに切り替えを依頼し、内容の入力を続行しない。
Step 3 — 画像アップロード
現在の制限: Chrome拡張機能 file_upload ツールは、セッションで既に共有されているパスのみアップロードを許可します。ローカルのDocumentsディレクトリは範囲外。
現在の操作: Finderから(事前に open で画像ディレクトリを開く)ユーザーに画像をアップロード領域に順番に(カバーを先頭に)手動でドラッグするよう通知。
解決予定の方法: Claudeデスクトップアプリの設定で ~/.cmm/uploads/ を接続フォルダに追加し、画像生成パイプラインが自動的に cp でそのディレクトリにコピーすることで、完全自動アップロードが可能になります。
Step 4 — タイトル入力
find を使用してタイトル入力欄(placeholder: "填写标题会有更多赞哦")を特定し、computer.type または form_input を使用して入力。
Step 5 — 本文入力
本文領域は contenteditable div。javascript_tool を使用して注入:
const div = document.querySelectorAll('[contenteditable="true"]')[0];
div.focus();
document.execCommand('selectAll');
document.execCommand('insertText', false, bodyText);
ハッシュタグは本文末尾に直接記述(#話題 形式)。Xiaohongshuが自動解析します。
注入後、javascript_tool を使用してページの文字カウンター(X/1000)を読み取り、文字数が正しいことを確認。
Step 6 — 公開ボタン前で停止
すべての内容入力後、停止し、「公開」をクリックしない。ユーザーに内容が準備完了であることを伝え、ユーザー自身が確認して公開ボタンをクリックするように促します。
プラットフォーム制限の記録
- 組み込み公開スクリプトなし、APIドラフトボックスはサポート外。
- 画像アップロードパス制限(Step 3参照)は現在既知のギャップであり、
platform_gapsに記録。 - 最終公開はユーザーの明示的な確認が必須であり、代わりにクリックしてはならない。
Douyin(組み込み)および Bilibili
- 確認なしに最終公開が完了したふりをしない。
- Douyin: 組み込みブラウザ公開
sau経由(references/douyin-publish.md、scripts/douyin_publish.pyを参照)。プリフライトゲート: アカウント選択、ログイン/クッキー有効、動画/画像+タイトル/タグ準備。デフォルト--review-before-publish(入力後、公開ボタンで停止。ユーザー自身が開いたブラウザで公開をクリック — 確認時でも自動クリックしない)。sauが利用できない場合は、完全なパッケージを添えてmanual_uploadにフォールバック。 - ログイン準備ができていない場合でも、生成されたコンテンツ/アセットを手動アップロード用に保持。
- Bilibiliの場合、完全な手動パッケージを準備できるときは
target: manual_uploadを出力。そうでない場合はtarget: unsupportedを出力。 - ログイン不足、アカウント不足、サポートされていないバックエンド、手動アップロード要件を説明する
platform_gapsアイテムを含める。
停止条件
以下の前に停止して確認:
- プラットフォームAPIの呼び出し。
- ログインが必要なプラットフォームのブラウザ自動化の開始。
- 画像や動画のアップロード。
- 最終公開/投稿ボタンのクリック。
- 外部投稿のスケジュール。