octkp/ba2-skill-installer

Skill Installer

ba2-workspace リポジトリでチーム共有しているスキルを、各メンバーの個人スキルディレクトリへ取り込む（コピーする）ためのスキル。

このリポジトリでは「スキルの配布元」と「実際に使う場所」を分けている：

| 区分 | 場所 | 役割 | |---|---|---| | 配布元（repo） | <ba2-workspace>/skills/<名前>/SKILL.md（Claude版）<br><ba2-workspace>/skills/<名前>/.codex/SKILL.md（Codex版・あれば） | チームで共有・バージョン管理するスキルの正本 | | 利用場所（個人） | ~/.claude/skills/<名前>/SKILL.md<br>~/.codex/skills/<名前>/SKILL.md | Claude Code / Codex CLI が実際に読み込む場所 |

スキルは個人ディレクトリに置かれて初めて発動する。このスキルは配布元 → 個人へのコピーを対話的に行う。

ワークフロー

1. リポジトリのルートを解決し、最新化する

# REPO_ROOT 解決: 環境変数 → ba2-workspace 内で実行されていれば git rev-parse → 既定値（ghq）の順
REPO_ROOT="${BA2_WORKSPACE:-}"
if [ -z "$REPO_ROOT" ]; then
  GIT_TOP=$(git rev-parse --show-toplevel 2>/dev/null)
  if [ -n "$GIT_TOP" ] && [ "$(basename "$GIT_TOP")" = "ba2-workspace" ]; then
    REPO_ROOT="$GIT_TOP"
  fi
fi
: "${REPO_ROOT:=$HOME/ghq/github.com/kokopelli-inc/ba2-workspace}"
SKILLS_DIR="$REPO_ROOT/skills"

if [ ! -d "$SKILLS_DIR" ]; then
  echo "ERROR: $SKILLS_DIR が見つかりません。ba2-workspace のクローン先を BA2_WORKSPACE 環境変数で指定してください。" >&2
  exit 1
fi

cd "$REPO_ROOT"
git pull --ff-only origin main 2>/dev/null || echo "（git pull はスキップ。ローカルの内容でインストールします）"

• git pull は best-effort。失敗しても続行する。
• ghq 以外にクローンしている場合は環境変数 BA2_WORKSPACE で絶対パスを指定する（または上記コード冒頭の既定値を実態に合わせて書き換える）。

2. 配布元スキルと個人側の状態を一覧する

各スキルディレクトリには Claude版（SKILL.md）と Codex版（.codex/SKILL.md、あれば）が同居している。両方の存在を確認し、個人側に「未インストール / 同一 / 差分あり（更新可能）」のどれかを判定する。

cd "$REPO_ROOT"
[ -d "$SKILLS_DIR" ] || { echo "（$SKILLS_DIR が無い）"; exit 0; }
echo "===== skills ====="
for dir in "$SKILLS_DIR"/*/; do
  [ -d "$dir" ] || continue
  name=$(basename "$dir")
  # Claude版（必須想定）
  src_claude="$dir/SKILL.md"
  dest_claude="$HOME/.claude/skills/$name/SKILL.md"
  if [ ! -e "$src_claude" ]; then st_c="（Claude版なし）"
  elif [ ! -e "$dest_claude" ]; then st_c="未インストール"
  elif diff -q "$src_claude" "$dest_claude" >/dev/null 2>&1; then st_c="同一"
  else st_c="差分あり"; fi
  # Codex版（任意）
  src_codex="$dir/.codex/SKILL.md"
  dest_codex="$HOME/.codex/skills/$name/SKILL.md"
  if [ ! -e "$src_codex" ]; then st_x="（Codex版なし）"
  elif [ ! -e "$dest_codex" ]; then st_x="未インストール"
  elif diff -q "$src_codex" "$dest_codex" >/dev/null 2>&1; then st_x="同一"
  else st_x="差分あり"; fi
  printf "  %-28s  claude:%-14s  codex:%-14s\n" "$name" "$st_c" "$st_x"
done

• スキルディレクトリに SKILL.md が無く .codex/SKILL.md だけある ような構成は基本ない（Claude版が正本）。
• .codex/ が無いスキルもある（Codex対応不要のもの）。その場合は Codex 側のコピーをスキップする。
• 個人側に既にあって内容が同一ならコピー不要（スキップ対象として案内する）。

3. 何をインストール／更新するか確認する

一覧を提示し、ユーザーにどれを取り込むか確認する（AskUserQuestion 等）。

• 既定の推奨は「Claude版・Codex版それぞれで、未インストール・差分ありのもの全部」。
• 特定スキルだけを指定された場合（例: 「ba2-ticket-knowledge-reader を入れて」）はそれだけを対象にする。
• 「同一」のものは黙ってスキップする。
• 既存スキルを上書き更新する場合は、その旨を明示してから実行する（個人側でローカル改変している可能性があるため）。気になる場合は diff -u "$dest_claude" "$src_claude" の内容を見せてから進める。

4. コピーを実行する

対象スキルごとに、配布元に存在する版（Claude / Codex）をそれぞれの個人ディレクトリへコピーする。

NAME="ba2-ticket-knowledge-reader"   # 対象スキル名に置換
src_dir="$SKILLS_DIR/$NAME"

# Claude版
if [ -e "$src_dir/SKILL.md" ]; then
  mkdir -p "$HOME/.claude/skills/$NAME"
  cp "$src_dir/SKILL.md" "$HOME/.claude/skills/$NAME/SKILL.md"
  # SKILL.md 以外の補助ファイル（.codex/ を除く）もコピー
  for f in "$src_dir"/*; do
    bn=$(basename "$f")
    [ "$bn" = "SKILL.md" ] && continue
    [ "$bn" = ".codex" ]   && continue
    cp -r "$f" "$HOME/.claude/skills/$NAME/"
  done
  echo "installed (Claude): $HOME/.claude/skills/$NAME/"
fi

# Codex版
if [ -e "$src_dir/.codex/SKILL.md" ]; then
  mkdir -p "$HOME/.codex/skills/$NAME"
  cp "$src_dir/.codex/SKILL.md" "$HOME/.codex/skills/$NAME/SKILL.md"
  # .codex/ 配下の他ファイルもコピー
  for f in "$src_dir/.codex"/*; do
    bn=$(basename "$f")
    [ "$bn" = "SKILL.md" ] && continue
    cp -r "$f" "$HOME/.codex/skills/$NAME/"
  done
  echo "installed (Codex):  $HOME/.codex/skills/$NAME/"
fi

• コピー先（~/.claude/skills/、~/.codex/skills/）が無ければ mkdir -p で作る。
• SKILL.md 以外の補助ファイル（参照ドキュメント、設定ファイル等）も同梱されている場合は併せてコピーする。.codex/ 自体はサブディレクトリ構造なのでコピー対象から除外する点に注意。

5. 結果を報告する

インストール／更新したスキル名と、コピー先（~/.claude/skills/ / ~/.codex/skills/）を報告する。

• Claude Code 側はスキルが自動で再読み込みされる（次のセッションまたは即時、環境による）。
• Codex 側は Codex CLI を起動し直すと自動で読み込まれる旨を案内する。

注意事項

• このスキルは「配布元 → 個人」への一方向コピー専用。逆方向（個人 → repo へのコミット）は行わない。スキルそのものを編集・追加して repo に入れたい場合は、配布元（<ba2-workspace>/skills/<名前>/）を直接編集してコミットする。
• 個人側スキルを上書きする際は事前に明示する。ローカル改変を失わせない。
• 同じスキル名でも Claude版（SKILL.md）と Codex版（.codex/SKILL.md）は内容が異なることがある。それぞれの配布元からそれぞれの個人ディレクトリへコピーする（クロスコピーしない）。
• git pull は best-effort。ネットワーク不可でもローカルの配布元内容でインストールできる。

ブートストラップ（このスキル自身の入れ方）

このスキル自体も配布元に置かれている。まだ個人ディレクトリに無いメンバーは、最初の1回だけ手動でコピーする：

# ghq 以外にクローンしている場合は事前に `export BA2_WORKSPACE=/path/to/ba2-workspace` するか、下の既定値を書き換える
REPO_ROOT="${BA2_WORKSPACE:-$HOME/ghq/github.com/kokopelli-inc/ba2-workspace}"
SRC="$REPO_ROOT/skills/ba2-skill-installer"
mkdir -p "$HOME/.claude/skills/ba2-skill-installer" "$HOME/.codex/skills/ba2-skill-installer"
cp "$SRC/SKILL.md"        "$HOME/.claude/skills/ba2-skill-installer/SKILL.md"
cp "$SRC/.codex/SKILL.md" "$HOME/.codex/skills/ba2-skill-installer/SKILL.md"   # Codex も使う場合

以降は「スキルをインストールして」と頼めば、このスキルが他のスキルをまとめて取り込む。

使用例

共有スキルをまとめて取り込む

ユーザー: 「リポジトリのスキルを個人に入れて」

実行:

1. git pull（best-effort）
2. 配布元スキルの一覧と個人側の状態（Claude版/Codex版それぞれ）を提示
3. 未インストール・差分ありのものを確認のうえコピー
4. 入れた先（.claude / .codex）と再読み込み方法を報告

特定のスキルだけ更新する

ユーザー: 「ba2-ticket-knowledge-reader を最新にして」

実行:

1. git pull（best-effort）
2. ba2-ticket-knowledge-reader の配布元（SKILL.md と .codex/SKILL.md）を個人ディレクトリへ cp で上書き
3. 結果を報告