| name | setup |
| purpose | 準備する |
| description | Use when ツール導入と GCP / OAuth の設定、新規 YouTube チャンネル開設、既存チャンネル取り込み、config 再生成、または YouTube 側設定同期を行うとき。「セットアップして」「環境構築」「新チャンネル」「既存チャンネル」「チャンネル取り込み」「config 再生成」「設定反映」「チャンネル設定更新」「branding push」「ローカライゼーション同期」「meta.json を YouTube に反映」「/setup」「旧 /onboard」で発動。排他的な --tool / --channel / --import / --regenerate / --push mode を使える |
前後工程
前工程: なし後工程: *（共通基盤としてほぼ全スキル）委譲先: /channel-research --benchmark, /channel-research --discover, /channel-research --voice, /channel-strategy --persona, /channel-strategy --scene
成果物
書き込む: auth/client_secrets.json, auth/token.json, config/channel/*.json, config/localizations.json, docs/channel/*.md読み込む: pyproject.toml, config/channel/*.json
モード判定
$ARGUMENTS から mode flag（--tool / --channel / --import / --regenerate / --push）の出現数を、reference の Read や成果物確認・変更より先に次の read-only guard で数える。
uv run python .claude/skills/setup/references/setup-mode-guard.py $ARGUMENTS
guard が exit 2 を返したら、その出力だけを提示して即時停止する。
- 2 個以上なら、同じ flag の重複を含めて排他違反として停止し、1 つだけ指定するよう促す。この拒否経路では reference を Read せず、ファイル作成・更新、repo 初期化、API call、stage / commit を一切行わない
- 1 個なら対応する reference を読み、その一段だけを実行する。残りの引数はその mode の引数として扱う
- 0 個なら chain manifest に従い
tool → channel を状態判定付きで進める
| mode | 読む reference |
|---|
--tool | references/tool.md |
--channel | references/channel-mode.md |
--import | references/import-mode.md |
--regenerate | references/regeneration-mode.md |
--push | references/push-mode.md |
--tool は uv run yt-setup-dirs を含む現行 doctor wizard をそのまま実行し、GCP / OAuth / ADC bootstrap の唯一の正規入口とする。Google Auth Platform の Branding / Audience / Clients 設定と client_secrets.json の既存契約も references/tool.md で維持する。手動 script / Terraform を明示的に選ぶ上級者向け資産は同じ owner の references/gcp-bootstrap.md に置く。--tool では config/channel/*.json を生成しない。運用設定の workflow.post_publish.skip_approvals も references/tool.md の既存インタビューで扱う。
--channel は references/channel-mode.md を唯一の正として読み、移設前の新規開設 Step 1〜10 と同じ契約を実行する。TTP hearing、seed confirmation、config、duration、persona、branding、readiness、initial save の順序、success / failure / blocked / resume / idempotency、不可逆操作前の承認 gate と成果物契約を変えない。
--import / --regenerate / --push はそれぞれ対応 reference を唯一の正として読み、移設前の取り込み Step 1 前段〜Step 8、Step R1〜R8、設定同期の dry-run・承認・反映・失敗停止契約を変えずに実行する。市場・収集済みデータ分析は /channel-research --market、方向性検討は /channel-strategy --direction が所有し、ここへ吸収しない。
一括実行
references/setup-chain-state.py は references/setup-chain-manifest.json を実行前に strict 検証する。chainId、tool → channel の順序、未知・重複 step、prerequisite / output artifact、approval gate、状態判定 script のいずれかが不正なら error で停止する。旧 enabled だけの gate は skip = not enabled として解決し、skip と enabled の同時指定は拒否する。
最初の bootstrap で uv、pyproject.toml、automation package のいずれかが無く状態判定 script を起動できない場合は、tool だけを run として references/tool.md を実行する。script が起動可能になったら先頭から状態判定を再開する。起動可能ならチャンネルルートで manifest 順に各 step を判定する。
uv run python .claude/skills/setup/references/setup-chain-state.py \
--channel-dir . --step <tool|channel>
| exit | decision | 処理 |
|---|
| 0 | skip | 完了済みとして次の step へ進む。最終 step なら終了する |
| 10 | run | tool は references/tool.md、channel は references/channel-mode.md を読み、その一段だけ実行する |
| 20 | blocked | prerequisite 未完了として停止し、後段を実行しない |
| 2 | error | manifest / doctor / script のエラーとして停止し、後段を実行しない |
各 step の実行後は同じ状態判定を再実行し、exit 0 にならなければ停止する。tool 完了済みなら channel から再開し、channel 完了済みならどの副作用も再実行しない。既存の stale analytics 完了例外も tool の exit 0 とする。途中失敗時はその段で止め、後段を実行せず、再発動時は状態判定から再開する。
明示 mode はこの一括実行へ入らない。選択した reference の完了条件だけを実行・判定し、もう一段を暗黙実行しない。各 reference 内の不可逆操作・外部反映の承認 gate は chain の approvalGate.skip では省略されない。
想定 API call 数
| API | call 数 / 実行 | 変動要因 |
|---|
| YouTube Data API（oauth_token 手順の接続テスト） | 約 1 call | OAuth 認証の実行有無 |
| YouTube Reporting API | 数 call（quota 課金なし） | Reporting job の作成有無 |
| Vertex AI（Gemini / Veo / Lyria） | 0 | API 有効化のみで生成呼び出しなし |
- 上限 / 承認:
--tool とフラグなし chain は、references/tool.md の既存の変更 plan・承認 gate・API 上限をそのまま適用する
完了条件
- フラグなし:
tool と channel が manifest 順にどちらも skip になっている
--tool: references/tool.md の完了条件だけを満たしている--channel: references/channel-mode.md の Step 1〜10 と完了条件をすべて満たしている--import: references/import-mode.md の取り込み Step 1 前段〜Step 8 を満たしている--regenerate: references/regeneration-mode.md の Step R1〜R8 を満たしている--push: references/push-mode.md の dry-run、承認、反映後確認を満たしている
実行または skip と、状態判定の reason を短く報告する。
