team-info-setup

name	team-info-setup
description	team-info の初回セットアップや再セットアップを始めるための起点スキル。既知マシン判定、入口マニュアル確認、core setup の実行、TEAM_INFO_ROOT の再登録、lazy bootstrap 方針の案内まで扱う。

team-info セットアップスキル

絶対パスルール（必須）

• ユーザーにコマンドを渡すときは、固定の /Users/... を使わず、必ず絶対パスで案内する。
• TEAM_INFO_ROOT が使えるときは、macOS では "$TEAM_INFO_ROOT/..."、Windows では "$env:TEAM_INFO_ROOT\\..." の形を優先する。
• 初回セットアップ前で TEAM_INFO_ROOT がまだない場合は、"[team-info を置いた絶対パス]/..." の形で案内する。
• cd と相対パスだけで済ませない。

目的

• /setup から team-info の初回セットアップややり直しを始める。
• 新しいパソコンか、過去に一度使ったパソコンかを見分ける。
• setup/setup_all.cmd を入口にして、必要なら setup-local-machine までつなぐ。
• setup 本体を最小構成に保ち、重い依存は skill ごとの初回利用に寄せる。

参照ファイル

• setup/README.md
• マニュアル/まずはこちらをお読みください.md
• .agent/skills/common/scripts/team_info_runtime.py

必須フロー

1. まず python3 .agent/skills/common/scripts/team_info_runtime.py worked-before-status 相当で状態を確認する。
2. 結果が new のときは、最初に マニュアル/まずはこちらをお読みください.md を読み、その流れに沿って案内する。
3. 結果が known のときは、そのパソコンは既に一度 team-info を触った前提で扱う。ユーザーがやり直しを望むなら、そのまま setup を進めてよい。
4. フルセットアップの入口は常に setup/setup_all.cmd とする。
   • 途中で GitHub 招待の承認確認 と GitHub CLI (gh) の認証 が行われる。
   • この入口は OS 別 setup の最後に setup/verify_setup.py まで走らせる前提で扱う。
   • setup の最後に 検証結果: 成功 と出て、終了コード 0 のときだけ「core setup がそろった」と判断する。
   • setup 本体では Git / Python 3.11 / uv / Node 22 / Codex CLI / TEAM_INFO_ROOT までを基本対象とし、Remotion / Agent Reach / Claudian / clone-website などの重い依存はここで全部入れない。
5. setup 完了後は、ターミナルを開き直して TEAM_INFO_ROOT を確認するよう案内する。
   • macOS は ~/.config/team-info/env.sh と launchctl に保存される前提で扱う。
6. TEAM_INFO_ROOT が空なら、setup-local-machine で作業場所だけを登録し直す。
7. 新しいパソコンで setup が終わったら、もう一度 マニュアル/まずはこちらをお読みください.md を読むよう促す。
8. それでも止まる場合は、止まった画面のスクリーンショットを添えて Discord https://discord.com/channels/1478351976168165511/1479287635535990794 へ相談するよう案内する。

lazy bootstrap の扱い

• Remotion / VOICEVOX 系は team_info_runtime.py 経由で必要時に Docker runtime を準備する。
• Remotion の字幕・フック・見出しの粗編集は my-video/src/textLayout.ts に寄せる。BudouX ベースの自然な改行は my-video の通常の npm install に含めて扱う。
• Agent Reach は team_info_agent_reach.py が依存不足を検出したら初回 bootstrap を走らせる。
• Obsidian / Claudian は /claudian の初回実行時に active vault 向け install を行う。
• clone-website は template 初期化後、その workspace で Node 24 依存を入れる。
• shared-agent-assets は同期が必要になったタイミングでだけ実行する。

ユーザー向けコマンド

初回セットアップの入口

macOS:

bash ./setup/setup_all.cmd

Windows:

.\setup\setup_all.cmd

• この最初のコマンドだけは、team-info のリポジトリルートをカレントディレクトリにした状態で案内してよい。
• setup 側はカレントディレクトリが repo root なら、その値を TEAM_INFO_ROOT として保存する。

setup の説明を確認する

sed -n '1,220p' "$TEAM_INFO_ROOT/setup/README.md"

TEAM_INFO_ROOT が設定済みのときの再セットアップ

macOS:

bash "$TEAM_INFO_ROOT/setup/setup_all.cmd"

Windows:

& "$env:TEAM_INFO_ROOT\setup\setup_all.cmd"

TEAM_INFO_ROOT の確認

macOS:

echo "$TEAM_INFO_ROOT"

Windows:

echo $env:TEAM_INFO_ROOT

作業場所だけを登録し直す

macOS:

python3 "$TEAM_INFO_ROOT/.agent/skills/common/scripts/team_info_runtime.py" setup-local-machine --repo-root "$TEAM_INFO_ROOT"

Windows:

py -3 "$env:TEAM_INFO_ROOT\.agent\skills\common\scripts\team_info_runtime.py" setup-local-machine --repo-root "$env:TEAM_INFO_ROOT" --shell powershell

• このパソコンをオーナー機として使うときだけ、最後に --owner を付ける。

Docker サービスを起動する

セットアップ後に Dify や n8n を起動するときは、素の docker compose up ではなく共通ランチャーを使う。

macOS:

bash "$TEAM_INFO_ROOT/run.sh" --project dify -d

Windows:

& "$env:TEAM_INFO_ROOT\run.ps1" -Project dify -d

• n8n を起動したいときは dify を n8n に置き換える。
• このランチャーが Docker CLI / Engine / Compose v2 の確認と Engine 待機まで面倒を見る。
• Docker Desktop は必須ではない。macOS は Colima / OrbStack など、Windows は WSL2 Docker Engine でもよい。

GitHub 認証のやり直し

セットアップ後に GitHub 認証だけをやり直したい場合：

gh auth login --web

承認ルール

• worked-before-status の確認やマニュアルの読み込みは、そのまま実行してよい。
• setup/setup_all.cmd の実行は、道具の追加、外部取得、環境変更を含むため、必ず日本語で承認を取り、リスクを数値で示してから進める。
• ユーザーが自分で実行したい場合は、上のコマンドをそのまま渡す。