| name | community-draft |
| description | Use when コミュニティ投稿の下書きを --type 別に生成するとき。「コミュニティ投稿作って」「day-of reminder」「weekly feedback」で発動 |
Overview
YouTube コミュニティ投稿の 下書き を生成するスキル。
YouTube Data API v3 は Community 投稿に未対応のため、生成した本文を pbcopy でクリップボードへ送り、YouTube Studio から人手で投稿する 半自動運用を前提とする。
設定は config/skills/community-draft.yaml（任意。未指定なら同梱 config.default.yaml）と config/channel/community-draft.json（チャンネル固有のテンプレ上書き）を併用する。
設定読み込みゲート
前提確認やテンプレート生成に入る前に、以下を必ず Read（Codex では同等のファイル閲覧）で開く。SKILL.md の説明や記憶から設定値を推測しない。
.claude/skills/community-draft/config.default.yamlconfig/skills/community-draft.yaml（存在する場合）
読み込み後は youtube_automation.utils.skill_config.load_skill_config("community-draft") と同じ deep-merge 前提で、チャンネル上書きを優先して扱う。存在しない override は未設定として扱い、勝手に作成しない。この skill-config とは別に、必要な config/channel/community-draft.json は既存手順どおり読む。
前提
config/channel/ が存在すること（load_config() でロード可能）- macOS 専用（
pbcopy / open を利用）
- Linux で動かす場合はクリップボード連携部分のみ無効化し、
30-promo/community-post-draft.md の保存だけ行う
- YouTube Studio で投稿する想定（API 連携・自動投稿は本スキルの対象外）
config/channel/ が存在しない場合、ユーザーに確認:
- 新規チャンネル →
/channel-new を案内
- 既存チャンネル（YouTube で既に運営中）→
/channel-new（既存チャンネル取り込みモード）を案内
When to Use
- 公開当日のリマインダー投稿を作りたいとき
- 週次フィードバック（Sunday Vote 系）の投票投稿を作りたいとき
- 次コレクションの予告投稿を作りたいとき
- 公開後の制作裏側を共有したいとき
--type フラグ
--type | 状態 | 用途 |
|---|
behind-the-scenes | フル仕様化済み | 公開当日 or 翌日の制作意図を 4 文構造で一人称共有 |
next-teaser | フル仕様化済み | 次コレクションの予告（次の workflow-state.json を参照） |
poll | DEPRECATED (#509) | 旧 4 択投票。weekly-feedback に正式 retire 済み |
day-of-reminder | 既存 | 公開当日（数時間前）の視聴予約 + 通知設定リマインダー |
weekly-feedback | 既存 | 週次 Sunday Vote。theme_axis_pool から N-1 軸を提示し翌週テーマを投票 |
issue #509 で behind-the-scenes / next-teaser は upstream 仕様化が完了した（後述の各セクション参照）。poll は DEPRECATED: utils.weekly_vote_log.warn_poll_deprecated() が logger.warning を吐く実装で正式 retire 済み。後方互換のため受理はするが新規利用は禁止し、weekly-feedback に移行すること。
poll から weekly-feedback への移行ガイド
旧 (poll) | 新 (weekly-feedback) |
|---|
| 4 択固定 (drink × animal_object) | theme_axis_pool 上の任意 N 軸 → rotation_rule.present_count (auto = N-1) で動的提示 |
| 投票結果の記録なし | data/community/weekly-vote-log.json に週次保存。yt-vote-log append で記録 |
/collection-ideate への反映なし | hook 経由で直近 N 週の top_axis を theme weight に取り込む |
config/channel/community-draft.json で templates.poll.enabled: true が残っている場合は templates.weekly_feedback.enabled: true + theme_axis_pool を移植してから poll を削除する。
新規 type の表記ルール（重要）
issue #309 で確定した 2 表記の分離ルール:
- 投稿本文の時刻表記: 24h 表記
- 例:
𝟏𝟖:𝟎𝟎 𝐄𝐃𝐓 / 𝟎𝟕:𝟎𝟎 𝐉𝐒𝐓
- 視聴者向け簡潔さ優先、jazzgak. 原典
𝟏𝟖:𝟎𝟎 (𝐊𝐒𝐓/𝐉𝐒𝐓) 形式を踏襲
- 変数名:
{publish_time_24h_primary} / {publish_time_24h_secondary}
- draft 内の運用メモ・予約時刻: AM/PM 表記
- 例:
投稿 8:00-10:00 AM EDT
- YouTube Studio の予約投稿 UI が AM/PM 表記のためコピペ運用しやすくする
- 変数名:
{schedule_window_local_ampm} / {schedule_time_ampm}
skill 実装側で 必ず 2 表記を別変数として扱い、生成時点で分離 すること。本文中に AM/PM が混ざる、運用メモに 24h が混ざるのは NG。
出力先
<collection_dir>/30-promo/community-post-draft.md # コレクション紐づき（day-of-reminder / behind-the-scenes / next-teaser）
branding/community-templates/<type>.md # コレクション非紐づき（weekly-feedback）
保存後、pbcopy < <出力ファイル> で本文をクリップボードに送り、open https://studio.youtube.com/channel/<channel_id>/community で Studio を開く誘導を出す。
behind-the-scenes の構造（#509 で upstream 化）
公開当日 or 翌日に投稿する、制作裏側を 一人称 4 文 で共有する短文投稿。
config.default.yaml::templates.behind_the_scenes の構造順:
- scene_hook — 1 文目: 制作中に見えていた / 聞こえていた具体的情景を 1 つ提示
- 例:
窓に当たる雨の音をずっと録ってました。
- 変数:
{scene_phrase} (コレクション workflow-state.json::planning.scene_phrase)
- mood_anchor — 2 文目: そのときの自分の mood (静か / 焦り / うとうと等を 1 表現)
- 例:
深夜 3 時、半分まどろみながら。
- 変数:
{personal_mood}
- signature_element — 3 文目: コレクション固有の small object / 音 / 飲み物に触れる
- 例:
カップは {drink_signature}、奥で揺れる {animal_object} が今回の主役。
- 変数:
{drink_signature} / {animal_object} (channel-config の objects.swappable から解決)
- listening_invitation — 4 文目: 「こう聴いてほしい」の柔らかい誘導 + Music style 言及
- 例:
{music_style} の質感を、夜だけのプレイリストに入れてもらえたら。
- 変数:
{music_style} (content.json::genre.label 由来)
末尾に通知 CTA (🔔 + 😘) と感謝 (🤍) を付与し、署名は signature_template に従う。
フォーマットルール:
- 4 文は段落区切り (1 行空け) 推奨
- 一人称固定（「私」「制作してて」等）。三人称・カタログ口調は禁止
- 絵文字は 1 文に最大 1 個
- 表記ルール (時刻 24h / 運用メモ AM/PM) は
day-of-reminder と共通
変数解決ロジック (behind-the-scenes / next-teaser 共通)
resolver は コレクション workflow-state.json + channel-config から段階的に解決:
planning.scene_phrase / planning.target_persona / planning.signature_objects を Read- 不足分は
config/channel/community-draft.json::shared_variables から
- それでも不足なら
config/channel/content.json::genre から派生 (music_style のみ)
- すべて欠落なら placeholder を残したまま draft 出力し、警告ログ
scene_phrase / animal_object / drink_signature / music_style の 4 変数は本 skill が公式に提供する render 変数（issue #509）。
next-teaser の構造（#509 で upstream 化）
次コレクションを「公開時期は曖昧に保ったまま」匂わせる短文投稿。
config.default.yaml::templates.next_teaser の構造順:
- continuity_bridge — 1 文: 直近公開コレクションへの感謝 or 余韻
- next_hook — 1 文: 次コレクションの
scene_phrase を 匂わせる 程度に提示
- 「来週公開」のような具体日付は出さない (Studio 予約が確定するまで曖昧表現)
- invite_to_vote — 1 文 (optional):
weekly-feedback がアクティブなら投票 CTA を絡める
次コレクション workflow-state.json 参照ロジック
next-teaser は 次に公開予定のコレクション の workflow-state を参照する:
collections/planning/ 配下から workflow-state.json::planning.publish_target_at を持つものを列挙- 未確定 (
publish_target_at == null) は除外
- 最も近い未来日 (
publish_target_at が今より後で最小) のコレクションを採用
- 候補ゼロのときは
content.json::genre.label から汎用 hook を生成 (Next is brewing —)
採用後、そのコレクションの planning.scene_phrase を next_hook の主軸に据える。
Publishing 確定前 (workflow-state.json::publish.scheduled_at が未設定) は
時刻表記（24h / AM/PM のいずれも）を出さない。「Coming soon」「Brewing now」など曖昧表現を使う。
day-of-reminder の構造
公開数時間前に投稿するリマインダー。config.default.yaml::templates.day_of_reminder.structure の順:
- headline — 装飾フォント or プレーン文字で「今日公開 + 24h 時刻」を告知
- 例（装飾）:
📢 𝐍𝐞𝐰 𝐝𝐫𝐨𝐩 𝐭𝐨𝐝𝐚𝐲 — 𝟏𝟖:𝟎𝟎 𝐄𝐃𝐓 / 𝟎𝟕:𝟎𝟎 𝐉𝐒𝐓
- 例（プレーン）:
📢 New drop today — 18:00 EDT / 07:00 JST
- personal_mood — 今日の天候・感覚的描写（1-2 行）
- creative_intent — このコレクションで目指した雰囲気・小物の組み合わせ
- listening_cta — 「今夜こんな風に聴いてほしい」の柔らかい誘導
- notification_cta — 通知設定（🔔 + 😘）
- gratitude — 感謝（🤍）
- signature — チャンネル署名（装飾フォント可）
末尾に Premiere URL を貼ると Studio が自動でカード化する（別途「動画を添付」操作不要）。
weekly-feedback の構造
毎週日曜に投稿する 4 択ポール。config.default.yaml::templates.weekly_feedback:
theme_axis_pool: チャンネルの主要 theme 軸を N 個定義（rjn は 5 軸、汎用では [] 空配列スタート）rotation_rule.present_count: 毎週提示する選択肢数（auto = axis_count - 1）rotation_rule.cycle_weeks: 1 周にかかる週数（auto = axis_count）schedule_window_local_ampm: Studio 予約時刻ガイド（AM/PM 表記）
本文構造:
- headline — 装飾フォント or プレーン（例:
📢 Sunday vote — what's next week?）
- opener — 週末オープナー 1 文 + theme emoji
- intent — 「あなたの mood を追いかけたい」型の制作意図
- poll — N-1 択（
theme_axis_pool から rotation_rule で選定）
- promise — 「投票結果が来週の制作に反映される」約束
- notification_cta — 通知設定（🔔 + 😘）
- gratitude — 感謝（🤍）
- signature — チャンネル署名
Studio 側で「アンケート付き投稿」を選択し、poll 段落の 4 択を 手動で ポール選択肢に入力する。本文には選択肢を含めない or 重複表示してもよい（運用判断）。
実行フロー（概要）
--type を判定（未指定なら interactive にユーザーに尋ねる）load_skill_config("community-draft") 相当の順序で .claude/skills/community-draft/config.default.yaml と任意の config/skills/community-draft.yaml を deep-merge し、該当 type の skill-config ブロックを基準にする
- その後、既存手順どおり
config/channel/community-draft.json を読み、チャンネル固有のテンプレ上書き・shared_variables・軸定義を適用する
- merge 優先順は
config.default.yaml < config/skills/community-draft.yaml < config/channel/community-draft.json
- テンプレ変数を解決
behind-the-scenes / next-teaser: コレクション workflow-state.json の planning.* + channel-config の shared_variables から scene_phrase / animal_object / drink_signature / music_style を resolveday-of-reminder: コレクション workflow-state.json から公開日時 / scene_phrase / drink 等を引くweekly-feedback: data/community/weekly-vote-log.json（存在すれば）の直近履歴 (utils.weekly_vote_log.load_weekly_vote_log() 経由) から提示 N-1 択を選定poll: 後方互換のみ受理し utils.weekly_vote_log.warn_poll_deprecated() で warning ログを残す
- 本文を生成し
30-promo/community-post-draft.md または branding/community-templates/<type>.md に保存
pbcopy でクリップボードへ送り、Studio を open で開く案内を出す
配布されるサンプル
examples/community-draft-rjn/ に rjn 実例を reference のみ として収録（デフォルト config には反映されない）:
rain-5-axis.yaml — rjn の 5 軸 axis_pool 構造day-of-reminder-cloudwalk.md — 当日リマインダー本文例
ダウンストリームが「真似て自分のチャンネル軸に書き換える」ためのテンプレ。
vote-log との連携（#509 で正式化）
weekly-feedback で集計した投票結果は data/community/weekly-vote-log.json に
週次で append する。スキーマは youtube_automation.utils.schemas.weekly_vote_log.schema.json 参照。
uv run yt-vote-log append \
--week-start 2026-05-04 \
--axis rain_window:Rain Window:124 \
--axis midnight_drive:Midnight Drive:98
uv run yt-vote-log weights --recent 4 --decay 0.7
uv run yt-vote-log validate
Python から append したい場合は youtube_automation.utils.weekly_vote_log.append_weekly_vote_entry() を直接呼び出す（loader / writer / validator はすべて同モジュールに集約）。
下流の /collection-ideate は compute_vote_log_weights(log, recent_weeks=4) を hook として呼び、
- 連続 2 週 1 位の軸 →
forced_axis として返り、theme weight を最大化（強制採用）
- それ以外 → 軸ごとの 重みづけ平均 (
decay^i を最新ほど高く) を weights で加点
する。詳細は /collection-ideate SKILL.md の「vote-log hook」セクションを参照。
スコープ外
- vote の自動集計（YouTube コミュニティ投稿の poll 結果は Studio から手動で
yt-vote-log append する運用）
- コミュニティ投稿の自動投稿（YouTube Data API v3 非対応のため Studio から手動）
参考
- issue #309（本スキル新設）
- issue #509（既存 type フル仕様化 + vote-log hook 正式化、本 PR）
- vote-log API:
youtube_automation.utils.weekly_vote_log
- JSON Schema:
youtube_automation.utils.schemas.weekly_vote_log.schema.json
- CLI:
yt-vote-log {append, show, weights, validate}
- rjn 実装:
config/channel/community-draft.json / branding/community-templates/weekly-feedback.md / collections/live/20260515-rjn-cloudwalk-collection/30-promo/community-post-draft.md
- 流派: jazzgak. TTP（韓国系 lo-fi jazz × 雨音、ER 平均 2.68%）
