hf-sync — ローカル HF データセットミラー同期

graph.jsonld を持つ研究リポジトリの HF データセットミラーを、手元から1コマンドで同期するスキル。jsonld-knowledge-graph でエンコードしたグラフを HF Datasets 上のミラーに反映する運用レイヤー。

使用するタイミング

graph.jsonld を持たないリポジトリ（HF ミラーが存在しない）
HF データセット自体がまだ作成されていないプロジェクト（先に hf repo create <Owner/dataset> --repo-type dataset でリポジトリを作成する）
HF クローンディレクトリ（$HF_CLONE_BASE/<dataset>/）が存在しない（先に mkdir -p ~/MyAI_Lab/hf-datasets/<dataset> で staging ディレクトリを作成する。HF 側の README.md と過去のスナップショットがここに配置される）
hf login していない / トークンが write スコープを持っていない（先に hf auth login でトークンを再設定する）

bash ~/.claude/skills/hf-sync/sync.sh $ARGUMENTS

$ARGUMENTS は HF データセットのリポジトリ ID（例：Shimo4228/agent-knowledge-cycle）。

カレントワーキングディレクトリ制約: graph.jsonld が存在するプロジェクトルートで実行する。

cwd の graph.jsonld の構造的健全性チェック（@graph が配列かつ空でない）
ソースの graph.jsonld を HF クローンディレクトリ（$HF_CLONE_BASE/<dataset>/、デフォルト ~/MyAI_Lab/hf-datasets/<dataset>/）にコピー
HF クローン側で jq -c '.["@graph"][]' graph.jsonld > graph.jsonl を生成（HF Dataset Viewer 用、1ノード1行のフラット化）
hf upload <Owner/dataset> <hf-clone>/graph.jsonld graph.jsonld --repo-type dataset
hf upload <Owner/dataset> <hf-clone>/graph.jsonl graph.jsonl --repo-type dataset
成功ログと HF URL を表示

ソースリポジトリは汚さない: graph.jsonl は HF クローン側でのみ生成・存在し、ソースの git ツリーには残らない。

認証は ~/.cache/huggingface/token（hf login で保存されたもの）を hf CLI が自動で読み取る。

各プロジェクトの GitHub リポジトリと HF データセットの対応はプロジェクトごとに異なる。スキル本体には埋め込まない（移植性を維持）。マッピングはプロジェクトの CLAUDE.md または同等の場所に記録し、起動時にコピー＆ペーストで引数として渡す。

shimo4228 系の現在のマッピングは ~/MyAI_Lab/shimo4228/CLAUDE.md の「HF Datasets mirror」セクションを参照。

graph.jsonld が cwd に見つからない → プロジェクトルートに移動してから起動
HF クローンディレクトリが見つからない → mkdir -p $HF_CLONE_BASE/<dataset>/ で staging ディレクトリを作成（HF 側に既存ファイルがあれば手動で取得して配置するか、hf download <Owner/dataset> --local-dir <hf-clone> で初期同期）
@graph が配列でない / 空 → graph.jsonld の構造を見直す（jsonld-knowledge-graph スキル参照）
hf upload が 401 / 403 を返す → hf auth whoami でトークンを確認。write スコープを持っていなければ HF 設定で新規発行 → hf auth login
HF データセットリポジトリが存在しない (404) → 先に hf repo create <Owner/dataset> --repo-type dataset でリポジトリを作成