SCALE Claude共通コマンド配布の座組

全メンバーのClaude Codeの「スキル/コマンド」を統一し、誰かが更新したら自動で全員に反映される仕組み。 2026-06-25にこのノートへ言語化（それまでVaultに未記載で、実体は ~/.claude/commands のgit＋launchd＋hookに散在していた）。

何ができるか

• 全員が同じスキルセット（/hp-flow /system-flow /agenda /handoff /x-flow 等 全22個）になる＝性能が揃う
• 誰かがコマンドを改善して push すると、15分以内に全員へ自動反映
• 各メンバーが自分で追加したコマンドも、自動で全員へ共有（双方向）

アーキテクチャ

→ 「誰かが更新→push → 全員が自動pull → 全員同じ」が成立。

共有範囲の注記

• 共有対象は commands/ のみ。skills/ ディレクトリと グローバル ~/.claude/CLAUDE.md は含まれない。
• 性能の核は commands 共有で揃う。共通の指示書(CLAUDE.md)まで配りたい場合は別リポジトリ化が必要（将来課題）。
• plist / hook のパスは各自のMacの $HOME に合わせる（下記手順で吸収済み）。

新メンバー設定手順

A. 管理者(大串)が先にやる — GitHub側

1. GitHub org scale-group-jp にメンバーを招待
2. scale-claude-commands に Write権限を付与
   bash gh api -X PUT orgs/scale-group-jp/teams/<チーム名>/repos/scale-group-jp/scale-claude-commands -f permission=push # チーム未使用なら リポジトリ Settings → Collaborators から個別追加でもOK

B. メンバーのMacで実行（コピペ可）

前提：そのMacに Claude Code インストール済み ＋ GitHub認証済み（gh auth login か SSHキー）。

# 0. 既存 commands を退避（あれば）
[ -d ~/.claude/commands ] && mv ~/.claude/commands ~/.claude/commands.bak.$(date +%Y%m%d%H%M)

# 1. 共有リポジトリを clone
git clone https://github.com/scale-group-jp/scale-claude-commands.git ~/.claude/commands
# SSH派: git clone git@github.com:scale-group-jp/scale-claude-commands.git ~/.claude/commands

# 2. 自動同期スクリプト配置
mkdir -p ~/scale-claude
cat > ~/scale-claude/auto_update_commands.sh <<'EOF'
#!/bin/bash
set -euo pipefail
REPO_DIR="$HOME/.claude/commands"
LOG="$HOME/scale-claude/auto_update_commands.log"
mkdir -p "$(dirname "$LOG")"
cd "$REPO_DIR" || exit 0
git remote get-url origin &>/dev/null || { echo "$(date) no remote" >>"$LOG"; exit 0; }
git fetch origin main 2>>"$LOG"
if ! git diff --quiet || ! git diff --cached --quiet; then
  git add -A
  git commit -m "auto: local changes $(date '+%Y-%m-%d %H:%M')" >>"$LOG" 2>&1 || true
fi
git pull --no-edit origin main >>"$LOG" 2>&1 || true
git push origin main >>"$LOG" 2>&1 || true
echo "$(date) synced" >>"$LOG"
EOF
chmod +x ~/scale-claude/auto_update_commands.sh

# 3. launchd 登録（15分おき・$HOME 実値展開）
cat > ~/Library/LaunchAgents/com.scale.auto-update-commands.plist <<EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>com.scale.auto-update-commands</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/bash</string>
    <string>$HOME/scale-claude/auto_update_commands.sh</string>
  </array>
  <key>StartInterval</key><integer>900</integer>
  <key>RunAtLoad</key><true/>
</dict>
</plist>
EOF
launchctl unload ~/Library/LaunchAgents/com.scale.auto-update-commands.plist 2>/dev/null
launchctl load ~/Library/LaunchAgents/com.scale.auto-update-commands.plist

# 4. 起動時pull hook（任意・「開いた瞬間最新」にしたい場合）
cat > ~/scale-claude/claude_pull.sh <<'EOF'
#!/bin/bash
cd "$HOME/.claude/commands" 2>/dev/null && timeout 10 git pull --no-edit origin main &>/dev/null || true
EOF
chmod +x ~/scale-claude/claude_pull.sh
# → ~/.claude/settings.json の "hooks".SessionStart に "$HOME/scale-claude/claude_pull.sh" を追加

# 5. 動作確認
ls ~/.claude/commands/*.md | head
bash ~/scale-claude/auto_update_commands.sh && tail -1 ~/scale-claude/auto_update_commands.log

→ メンバーのClaudeで /system-flow /hp-flow が候補に出れば成功。

メンバーに送る依頼文面（コピペ用）

【SCALEチーム共通Claude設定のお願い】

SCALEで使っているClaude Codeのスキル/コマンド（/hp-flow, /system-flow など）を
あなたのClaudeにも入れて、今後のアップデートも自動で反映されるようにしたいです。
所要5分、下記のとおりお願いします。

■ 事前
1. GitHubの招待メール（scale-group-jp）が届くので承認してください
2. Macで `gh auth login` 済み（or SSHキー登録済み）であること

■ 手順
大串から送る「セットアップ手順」のコマンドを、ターミナルに上から順に貼り付けて実行するだけ。
（既存の ~/.claude/commands は自動でバックアップされるので消えません）

■ 完了確認
Claude Code を開いて「/」を打ったとき、候補に /system-flow や /hp-flow が出ればOK。
出たら「入りました」と返信ください。

■ これで何が起きるか
・全員が同じスキルセットになります（性能が揃う）
・誰かがコマンドを改善してpushすると、15分以内に自動で全員に反映されます
・あなたが自分で追加したコマンドも、自動で全員に共有されます

うまくいかなければ、エラー文ごと大串まで連絡ください。

リモート遠隔で大串が設定する場合（2026-06-25 想定）

• GitHub認証(gh auth login)だけはメンバー本人に操作してもらう（パスワード/2FAを大串が握らないため）。残りは全部大串の遠隔操作でOK。
• 当日を5分にするコツ：前日までにメンバーへ「①Claude Code導入 ②org招待承認 ③gh auth login」を済ませてもらう。
• リモートツールは画面共有＋遠隔操作できれば何でも可（ターミナル操作が主で軽い）。

関連

• 実体スクリプト: ~/Obsidian/scripts/auto_update_commands.sh / session_start_brief.sh
• launchd: ~/Library/LaunchAgents/com.scale.auto-update-commands.plist
• 姉妹: HP制作フロー /hp-flow、システム制作フロー /system-flow（このリポジトリ経由で配布される）