octkp/badev-knowledge-sync

Badev Knowledge Sync

旧 badev-knowledge-base リポの docs/ 配下を、現役メンバー 4 人だけを対象に ba2-workspace/docs/ に同期するスキル。 ba2-workspace への統合後も、しばらくは旧リポにコミットが追加される過渡期向け。旧リポを source of truth とし、衝突時は旧リポ側で新リポを上書きする。

設計の要点

| 項目 | 方針 | |---|---| | 同期対象 | docs/{takano,tokita,yukioka,ushiroyama}/ のみ | | 除外（同期しない） | 上記 4 人以外の人ディレクトリ、docs/knowledge/、.DS_Store、.claude/ 配下 | | 同期方向 | 旧 → 新 の一方向 | | 衝突時 | 旧リポ側で新リポを上書き（新リポ独自の編集は失われる） | | 削除 | --delete は使わない（旧に無く新にしかないファイルは残す） | | コミット・プッシュ | このスキルでは行わない（git add docs/ までで停止） |

前提

• 旧リポのクローン: ローカルに badev-knowledge-base をクローンしてあること（パスは下の解決ルールで取得）。
• 新リポ（ba2-workspace）内で実行: スキルは ba2-workspace のリポ内で起動する。
• rsync: macOS / Linux 標準のものを使う。

REPO_ROOT 解決

新リポ（ba2-workspace）

NEW_REPO=$(git rev-parse --show-toplevel 2>/dev/null)
if [ -z "$NEW_REPO" ] || [ "$(basename "$NEW_REPO")" != "ba2-workspace" ]; then
  echo "ERROR: ba2-workspace リポ内で実行してください" >&2
  exit 1
fi

旧リポ（badev-knowledge-base）

OLD_REPO="${BADEV_KNOWLEDGE_BASE:-$HOME/ghq/github.com/kokopelli-inc/badev-knowledge-base}"
if [ ! -d "$OLD_REPO/.git" ]; then
  echo "ERROR: $OLD_REPO に badev-knowledge-base のクローンが見つかりません。" >&2
  echo "       BADEV_KNOWLEDGE_BASE 環境変数で正しいパスを指定してください。" >&2
  exit 1
fi

重要: BADEV_KNOWLEDGE_BASE と、過去に廃止した BADEV_KNOWLEDGE_BASE_PATH は別物。前者は本スキルの旧リポ参照用。後者は ticket-knowledge 系の旧 REPO_ROOT 解決で使われていたもので、現在は廃止済み。混同しない。

同期対象ユーザー

# 現役メンバー 4 人だけを同期対象にする
ALLOWED_USERS=(takano tokita yukioka ushiroyama)

リストを変更したい場合は本 SKILL.md を編集する（運用上、頻繁には変えない想定）。

ワークフロー

1. 旧リポを最新化

cd "$OLD_REPO"
git fetch origin 2>/dev/null
git pull --ff-only origin main 2>&1 || echo "（git pull に失敗。ローカル状態で同期します）"

• git pull は best-effort。失敗してもローカルにある内容で同期を続行する。

2. 差分プレビュー（4 人分のみ）

for user in "${ALLOWED_USERS[@]}"; do
  echo "=== $user ==="
  diff -rq "$OLD_REPO/docs/$user" "$NEW_REPO/docs/$user" 2>/dev/null | head -30
done

出力の読み方：

| 表示 | 意味 | 同期での扱い | |---|---|---| | Only in <OLD>/... | 旧リポにしかない | コピーされる（同期対象） | | Only in <NEW>/... | 新リポにしかない | そのまま残る（削除されない） | | Files <OLD>/X and <NEW>/X differ | 同名で中身が違う | 旧リポ側で上書き（新リポ側の変更は失われる） |

衝突件数が多い場合は事前にユーザーに見せ、続行してよいか確認する。

3. 同期実行（旧で新を上書き）

cd "$NEW_REPO"
for user in "${ALLOWED_USERS[@]}"; do
  if [ -d "$OLD_REPO/docs/$user" ]; then
    rsync -av \
      --exclude='.DS_Store' \
      --exclude='.claude/' \
      "$OLD_REPO/docs/$user/" "$NEW_REPO/docs/$user/"
  fi
done

• --ignore-existing は付けない（旧側で上書きする方針なので）。
• --exclude='.DS_Store' / --exclude='.claude/' で個人設定系を除外。
• --delete は使わない（旧に無く新にしかないファイルは残す）。
• 末尾の / 有無で挙動が変わるので、"$OLD_REPO/docs/$user/" のように末尾スラッシュありで渡す。

4. ステージング

cd "$NEW_REPO"
git add docs/
git status --short docs/ | head -50
git diff --cached --stat docs/ | tail -1

コミット・プッシュはこのスキルでは行わない。

5. 結果を報告

• 追加・更新されたファイル数（git diff --cached --stat | tail -1 の出力）
• 衝突して旧で上書きされたファイル一覧（あれば、影響範囲をユーザーに見せる）
• 次の手順:
  • 内容に問題なければ git commit -m "chore: badev-knowledge-base から docs/ を同期" && git push origin main（docs/ 配下のみなので main 直 push OK）
  • 新リポ側の独自編集を失いたくない衝突が見つかれば、git restore --staged --worktree -- <file> で個別に取り消し
  • 何も追加・更新されなかった場合はその旨を伝えて終了

衝突時の扱い

旧リポを source of truth とするので、衝突は旧側で上書きされる。新リポ側で独自編集していたファイルがあれば、その変更は失われる。

このリスクを避けるには:

• 差分プレビュー（ステップ 2）で Files ... differ の件数を確認し、多ければ続行前にユーザー確認
• 同期実行前に git status で新リポ側が clean であることを確認
• 同期後 git diff --cached で実際の変更内容を目視チェック

事後に旧で上書きしたくなかったと判明した場合は、該当ファイルだけ git restore --staged --worktree -- <file> で取り消す。

注意事項

• 対象は docs/{takano,tokita,yukioka,ushiroyama}/ のみ。それ以外（他の人ディレクトリ / docs/knowledge/ 等）は同期しない。
• 旧リポを source of truth とするので、衝突は旧で上書き。新リポ独自編集は失われ得る。
• --delete は使わない（旧に無いファイルを新から消さない）。
• --exclude='.DS_Store' と --exclude='.claude/' で個人設定系を除外。
• コミット・プッシュは行わない（人間が内容を確認したうえで判断）。
• 旧リポでの新規コミットが完全に止まったら、このスキルは役目を終える。旧リポを archive する判断はチームで。

使用例

通常の同期

ユーザー: 「badev-knowledge-base から同期して」

実行:

1. 新リポ・旧リポの REPO_ROOT を解決
2. 旧リポを git pull（best-effort）
3. ALLOWED_USERS の 4 人分だけ diff -rq で差分プレビュー
4. rsync -av --exclude=.DS_Store --exclude=.claude/ で人ごとに同期（旧で上書き）
5. git add docs/ でステージング
6. 追加・更新ファイル数を報告し、commit/push はユーザーに委ねる

衝突が多い場合

差分プレビューで Files ... differ が多い → 続行前にユーザーに見せて確認:

• 「衝突 N 件あります。旧リポ側で上書きする方針ですが、続行してよいですか？」
• 続行 OK なら通常同期。新リポ側の独自編集を残したい衝突がある場合は、同期後に git restore --staged --worktree -- <file> で個別に取り消す。