--- name: rules-sync description: チーム共通ルール Drive ハブとの同期。「ルール同期」「共通ルール更新」「最新ルール取り込み」「rules sync」「ナレッジ統合して」「inbox マージ」などの依頼、または月初・大きなルール変更後に必ずこの手順を使う。pull（全メンバー共通: Drive→ローカル反映）と merge（管理者: knowledge-inbox→正本統合）の2モード。 --- # rules-sync — Drive ハブ同期 AI（Claude Code 等）のルール/スキルを Drive の1フォルダで正本管理し、各メンバーのローカルへ配布する同期の型。 Drive ハブ（正本）: 共通ルールハブ フォルダ（フォルダ ID = ``。owner = 管理者アカウント） サブフォルダ: rules=`` / skills=`` / knowledge-inbox=`` ## 前提となる Drive API の制約と対策 - **ファイル本文の取得は必ず `download_file_content`（base64 → デコード）を使う**。`read_file_content`（自然言語変換）は `_` `[` 等がエスケープされて**ファイルが壊れる**（実測）。read はフォルダ内容の人間向け確認のみ - update/delete/move が無いコネクタでは、更新 = 同タイトルで create_file し直し。読む側は「同タイトル複数 → modifiedTime 最新を正」 - in-place 更新できる CLI がある環境ではそちらを優先: `node /scripts/drive-hub-sync.mjs push/pull/list`（サービスアカウント + ドメイン全体委任認証、fileId 保持。大きめファイルもコンテキストを消費しない） - fileId は版ごとに変わりうる → **ファイル ID をハードコードしない**（フォルダ ID のみ固定） - アップロード時は `contentMimeType: text/plain` + `disableConversionToGoogleType: true`（Google Docs 変換させない） ## モード判定 - 「取り込み / 最新化 / 同期して」→ **pull** - 「統合 / マージ / inbox 処理」→ **merge**（管理者環境のみ） ## pull（全メンバー共通） 1. ハブフォルダを `title contains 'manifest'` で検索 → modifiedTime 最新の manifest.json を取得 2. ローカル `~/.claude/-rules-version.txt` の版番号と比較。同じなら「最新です」で終了 3. manifest の files を順に取得（該当フォルダを parentId 検索 → 同タイトルの最新を **download_file_content** で取得し base64 デコード） 4. 反映先: - `ONBOARDING.md` → プロジェクトの ONBOARDING ローカルマスター（環境ごとに設定。無い環境は `~/.claude/ONBOARDING.md`） - `rules/*.md` → `~/.claude/rules/` - `skills/.md` → `~/.claude/skills//SKILL.md` - `CLAUDE.md.template` → `~/.claude/CLAUDE.md` が**無い場合のみ**新規作成。既存があれば上書きせず差分を提示するだけ 5. 反映前に既存ファイルを `~/.claude/backups/` にバックアップ 6. version ファイルを新版番号で更新 → 完了報告（版番号 + 反映ファイル一覧） ## merge（管理者環境のみ） 1. knowledge-inbox を検索 → 最新の `knowledge-merged.json`（台帳）に載っていないファイルを列挙 2. 各投稿を read → 既存ルールとの重複・矛盾をチェック → 反映先を判定（ONBOARDING §x.x / rules/ / skills/ / 却下） 3. 反映案を1行/件で利用者に提示 → 承認後、**ローカル正本を編集** 4. 正本を Drive に再アップ（同タイトル create_file）→ `manifest.json` を version+1 で再アップ → `knowledge-merged.json` に処理済み（fileId / タイトル / 反映先 / 日付）を追記して再アップ 5. GitHub ミラー: ルール用 repo に ONBOARDING / skills / rules を同期して commit + push 6. 完了報告に新 version と反映内容を列挙 ## 注意 - 他メンバーは正本を直接編集しない（競合防止）。変更提案はすべて share-knowledge（inbox 投稿）経由 - inbox の投稿は削除できない前提 → 台帳方式で処理済み管理。古い版の正本は放置しても latest-by-title で動作に支障なし ---