メインコンテンツへスキップ
見出し画像

daily_limit=2 が、全Shortsを翌日送りにしていた

    ある日、Shorts のアップロードが「全部翌日に予約されている」現象に気づいた。

    朝のアップロードキューを見ると、Shorts ジョブが 6 件、すべて翌日の 8:00 / 20:00 スロットに予約されていた。当日のスロットには本編 2 件だけ。

    「あれ、Shorts どこ行った?」と思って `upload_queue.py` のロジックを追った。

    原因は、「同チャンネルのアップロード本数が 2 件に達したら、それ以上のジョブは翌日に送る」というルールが、本編 + Shorts を区別せずに数えていたことだった。

    これは、`DAILY_PROJECT_LIMIT=2` という設定値が、想定外の解釈で全 Shorts を翌日送りにしていた話だ。

    画像
    DAILY_LIMIT=2 が本編+Shortsを区別せず、全Shorts翌日送り

    DAILY_PROJECT_LIMIT=2 の意図

    最初、`DAILY_PROJECT_LIMIT=2` を導入した目的は、「同じチャンネルが 1 日に 2 つ以上の『プロジェクト』(企画)を投稿しないようにする」だった。

    YouTube アルゴリズム的に、同 ch から短時間で連続投稿すると、視聴者の通知疲労を招くリスクがある。1 日 2 企画までに抑える運用方針。

    ところが、コードの実装が:

    def can_submit_today(channel: str) -> bool:
        today_count = count_uploads_today(channel)
        return today_count < DAILY_PROJECT_LIMIT  # 2

    `count_uploads_today` が「本編+Shorts の合計」を数えていた。

    1 企画 = 本編 1 本 + Shorts 1 本 = 2 アップロード。これで「2 件達成」になり、次のジョブはすべて翌日送り。

    「2 企画」のつもりで「2 アップロード」になっていた。

    画像
    意図2企画/実装2アップロード、ズレが生んだ事故

    当日 2 slug 到達で全 Shorts 翌日送り

    具体的な進行:

    1. 朝 8:00、企画 A の本編アップロード(1 件目)

    2. 朝 8:30、企画 A の Shorts アップロード(2 件目)

    3. ここで「today_count = 2」になり、DAILY_PROJECT_LIMIT に到達

    4. 夜 20:00 のスロット用にキューされた企画 B の本編 → 翌日送り

    5. それ以降の Shorts ジョブもすべて翌日送り

    結果として、当日に「企画 A の本編 + Shorts」だけ出る。企画 B 以降は完全に翌日。

    8 ch 並列運用で、この罠が複数 ch で同時に発動。1 日のアップロード予定本数の半分以上が、翌日にスライドしていた。

    「設定値の意味は同じ、解釈が違う」が、運用の累積で大きな事故になった。

    画像
     1企画2アップロードでLIMIT到達、翌日送り連鎖

    1 日かけて気づかなかった理由

    なぜ気づかなかったか?

    ひとつ。個々の動画は予定通り公開されていた。当日朝 8:00 / 8:30 のスロットには、企画 A が出ている。「公開ゼロ」ではなかった。

    ふたつ。翌日も同じ時刻にスロットがある。翌日 8:00 / 20:00 で別の企画が公開される。一見「順調」に見えた。

    みっつ。「予約タイムライン」を俯瞰する仕組みがなかった。日次レポート(post-034)は当日のアップロードしか集計していなかった。「翌日まで含めて何本予約されているか」を見る目がなかった。

    要するに、各動画の挙動は問題なし。でも「全体としてアップロード本数が想定の半分」という事実は、俯瞰しないと見えなかった。

    事故が「目立たない」が、「累積する」タイプ。

    画像
    個別正常/累積で半分、俯瞰の必要性

    upload-queue daily_limit を撤廃

    修正の判断は、シンプルに「DAILY_PROJECT_LIMIT を撤廃する」だった。

    代替案として「LIMIT を 4(本編 2 + Shorts 2)に上げる」も検討したが、

    ひとつ。「企画」と「アップロード」の概念が混じる時点で、ロジックが脆い。
    ふたつ。Shorts の量を増やしたい(post-027 で 10 倍に)時に、再び引っかかる。
    みっつ。同 ch 短時間連投リスクは、別の仕組み(cooldown 30 分)で十分対応できている。

    完全撤廃の方が、ロジックがシンプルで、想定外の挙動を生まない。

    def can_submit_today(channel: str) -> bool:
        return True  # daily_limit 撤廃

    `memory/incidents/feedback_upload_queue_daily_limit_bug.md` に「撤廃済み」と記録して、`incidents/archive/` に移動。

    「中途半端な制限」より「制限なし + 別の安全弁」のほうが、運用が安定する。

    画像
    DAILY_LIMIT撤廃、cooldown30分で別途担保

    翌日にスライドした分の対応

    撤廃時、すでに翌日に予約されていた分の対応も決めた。

    ひとつ。翌日予約のままにする。順次公開させる。
    ふたつ。翌々日以降の自然順位を維持。当日に巻き戻すと、視聴者の通知が短時間に集中する。
    みっつ。publishAt を維持(post-021 の publishAt 戦略)。

    「過去の事故は、自然消化させる」のが現実的。慌てて取り戻そうとすると、別の混乱を生む。

    事故を発見した瞬間、「過去分をどう扱うか」も決めるのが、運用の落とし所。

    画像
    過去予約は自然消化、慌てない

    数字の刷新

    | 項目 | Before(LIMIT=2 誤動作) | After(撤廃) |
    |---|---|---|
    | 1 企画 = 何アップロード | 2(本編+Shorts) | 同じ |
    | LIMIT 解釈 | アップロード件数 | 撤廃済み |
    | 当日Shorts翌日送り | 半数以上発生 | ゼロ |
    | 想定アップロード本数達成率 | 約45% | 100% |
    | 同ch短時間連投の安全弁 | DAILY_LIMIT | cooldown 30分 + publishAt スロット |

    学んだこと

    ふたつだけ書く。

    ひとつ。設定値の「意図」と「実装」のズレは、コメントを書いても防げない。
    `DAILY_PROJECT_LIMIT` は「企画数」のつもりだったが、実装は「アップロード数」だった。コメントに「2 企画まで」と書いてあっても、コードを書くときに勘違いすれば事故になる。設定値の名前そのものが意図を表すように設計する(`DAILY_PROJECT_COUNT_LIMIT` のように具体的に)。コメントより命名で意図を伝える。

    ふたつ。「俯瞰する仕組み」がないと、累積する事故は気づけない。
    個々の動画は問題なく公開されていた。「全体の本数が半分」という事実は、俯瞰しないと見えない。日次レポートに「予約タイムライン」を載せる、ダッシュボードに「翌日以降の予約数」を表示する、こういう俯瞰の仕組みが事故検知に必要。「個別チェック」と「俯瞰チェック」の両方を持つ設計。

    副次効果もあった。この事故をきっかけに、`upload_queue.py` の他のロジックも見直した。同じように「意図と実装が微妙にズレている」箇所が 2 つ見つかった。1 つの事故を起点に、関連コードのリファクタが進む。事故は痛いが、痛い瞬間しかコードを真剣に読み返さない、という現実もある。

    次回予告

    次回は、Phase 5 最終回。立ち上げ初月のメタ振り返り、何が効いて何が無駄だったかを書きます。

    設計テンプレをプレゼントします

    20体のAIエージェントを組むときに、どう役割分担を設計したか。それをテンプレ化したPDFを用意しています。実際に自分が使っている定義の抜粋とフォーマットが入っているので、そのまま明日から自分のプロジェクトに使えます。

    画像
    設計テンプレを受け取る リンク先: https://note.com/claudecodevideo

    公式LINEに登録してくれた方にお送りします。

    公式LINEに登録する

    法人のご相談はこちら

    自社のYouTubeチャンネルを自動化したい、AIで動画運用代行を頼みたい、というご相談は、別途お受けしています。

    画像
    法人のお問い合わせはこちら
    リンク先: https://forms.gle/SkDkkZi7hMFJUF9w7

    あなたへのおすすめ