القائمة
YouTube Data API v3 發片完整規則 — description 不能含 < > 字元(`>>` `&&` 會被退稿)、Shorts 自動歸類條件、quota 1600/upload、refresh_token 7 天過期沒辦法 cron 自動 refresh、視覺與標題長度限制。任何要寫 YT 自動發片或改 metadata 的 AI 應該先讀。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Best practices for Remotion - Video creation in React
9:16 Reel 影片兩大渲染問題的根因與修法：(1) justifyContent:center 造成 sub-pixel 文字跳動、(2) 字幕 CC 風格切句規則（、，。？！；斷行，移除 ，。，保留 ？！：...、）。每次動 StepScene / SubtitleOverlay / 任何 block 動畫時必讀。
Tutorial 影片寫 voiceover 的工作順序(先鎖圖再寫配音、先預覽再 render)、內容規範、ElevenLabs 模型 / 速度設定。任何要動 intro / step.voiceovers / outro 字串、或要跑 generate-tutorial-voiceover.ts / render:tutorial 的 AI 都應該先讀。
教學影片 render + publish 跨平台 pipeline 共用規則 — 5 階段管線(工作目錄→對話⇆預覽→後製→發佈,對話⇆預覽 內部 iterative)/ 雙 mp4(16:9 + 9:16)/ 字幕用 Remotion 元件 / BGM/縮圖/配音 全 Remotion 自動 / YT 章節 / 全平台 public 預設 / 文案全形指令半形。任何要 render 教學影片或 publish 到 YT/IG/脆 的 AI 動工前先讀。
Threads (Meta) 演算法紅線 R1–R12 + 信號 S1–S14 + 發文後策略 P1–P4 + 帳號層級 A1–A2 — 任何要寫脆貼文 / 改脆草稿 / 跑 daily-threads-post / 跑 publish-threads.mjs 的 AI,動工前先讀一遍做演算法對齊 self-check。內容改自 AK-Threads-Booster 的 knowledge/algorithm.md (MIT, 2026-03-31 版本)。
⚠️ DEFERRED 2026-04-27 — 本 channel 暫不發 X。Skill 內容保留(規則參考),但動工前先跟使用者確認真的要做 X 才執行,別自動把 X 列進跨平台發片清單。X (Twitter) 發 thread / single post 完整規則 — 2026-Q1 起 Grok 演算法接管、hashtag 上限 1–2 個、外連結 -30~50% 觸及、Thread 比單推 +63% 曝光。
| name | youtube-publishing-rules |
| description | YouTube Data API v3 發片完整規則 — description 不能含 < > 字元(`>>` `&&` 會被退稿)、Shorts 自動歸類條件、quota 1600/upload、refresh_token 7 天過期沒辦法 cron 自動 refresh、視覺與標題長度限制。任何要寫 YT 自動發片或改 metadata 的 AI 應該先讀。 |
YT API 會 reject 含特定 ASCII 字元的 description,回傳 invalidDescription:
< 跟 >(出於 XSS 防護,connector 字元)>>(redirect)、<file>(stdin)、HTML-like syntax≫ U+226B 看起來像 >> 但合法)──)/ 中文標點都 OK| 欄位 | 上限 | 備註 |
|---|---|---|
| Title | 100 字元 | 過長 API 退稿 |
| Description | 5000 字元 | 見上 |
| Tags(個別) | 30 字元 | API 不擋,但 YT UI 會截 |
| Tags(總長度) | 500 字元(所有 tag 加逗號) | 超過 API 退稿 |
YT 沒有 isShort API flag。Shorts 是自動判定:
符合三條件 → 自動進 Shorts feed:
#Shorts實作上直接用 videos.insert 上傳垂直短 mp4 就好,跟一般 video API 路徑完全相同。可加 --shorts flag 自動把 #Shorts 塞 description 開頭(YT 演算法看 description 前 100 字)。
youtube.upload scope 是 restricted scope,Testing mode 下 refresh_token 只活 7 天node scripts/youtube-oauth.mjs(30 秒)videos.insert(上傳新影片):1,600 點/支 → 一天最多 6 支videos.update(改 metadata):50 點/次thumbnails.set:50 點/次改 metadata 不算重發 — title / description / tags / category / 縮圖都可透過 videos.update + thumbnails.set 更新,只有影片 binary 不能換(要刪重發)。
28 = Science & Technology(本專案 default)27 = Education22 = People & Blogs實作走 scripts/publish-youtube.mjs(已存在)。跟 IG/Threads 不同 — YT 直接 binary 上傳,不用先 host。
--visibility 不帶就是 private,確認 metadata 都對才改 public。改 visibility 用 videos.update 50 quota 點,很便宜。
refresh_token → access_token(換一小時臨時 token)POST videos.insert?uploadType=multipart&part=snippet,status(JSON metadata + 影片 binary)POST thumbnails.set 上自訂縮圖| 錯誤 | 解法 |
|---|---|
invalidDescription | 找 < > 字元 / 超 5000 字 / 內容違規(政治 / 暴力 / 兒少不宜),最常見 >> < 在貼 shell 指令時 |
invalid_grant 換 access_token 時 | refresh_token 過期 → 重跑 youtube-oauth.mjs |
accessNotConfigured | YouTube Data API v3 沒在 Google Cloud project 啟用 → 去 Cloud Console enable |
quotaExceeded | 今天 quota 用完(發 6 支或大量 update),等 24h 或申請增加 |
selfDeclaredMadeForKids 必填 | metadata 一定要含 status.selfDeclaredMadeForKids: false(本專案已固定 false) |
>>)都塞 description| 沒問題(脆要 ｜)