| name | setup-audio-library |
| description | BGM・効果音の音源ライブラリを増やしたいときに発動する。フリー配布元の候補リスト HTML を生成し、ユーザー自身が手動でダウンロードしたファイルをドロップフォルダから照合・登録し、試聴ギャラリーで keep/drop するまでの半自動セットアップを行う。setup-library / harvest-asset の姉妹スキル（音源だけ流儀が異なるため独立）。 |
FORBIDDEN 級ハードルール
Language: Respond in the user's language — 対話・質問・承認確認・レポートはユーザーの使用言語に合わせる（例: 英語で話しかけられたら英語で応答する）。
次のいずれかに違反する形で音源セットアップを進めない。詳細リーフより常に優先する。
- AI による自動取得は、ユーザーの明示指示がある場合に限り、条件付きで許可する
（2026-07-22 オーナー裁定により改訂。旧ルール「AI は自動・一括ダウンロードしない」を
置き換え）。既定はやはり「候補リスト HTML を生成する」「ドロップフォルダを走査する」
だけであり、以下の全条件を満たさない限り
curl 等で配布元から直接音声を取得しない:
- ユーザー本人が当該取得タスクを明示的に指示していること（「候補を見て後で自分で
ダウンロードする」という既定フローを AI が勝手に取得フローへ切り替えない）
- bot/自動収集を規約で明記禁止するサイト、および robots.txt で自動化ボット向けに
アクセス制限を明示しているサイトへは一切アクセスしない。
robots.txt は毎回
取得前に確認すること。ToS が自動化について沈黙している「候補一覧上の許可サイト」
であっても、robots.txt が named bot（ClaudeBot 等 AI クローラ名を含む）に対して
個別に Disallow を明記している場合は、一般 UA を騙って回避してはいけない
（2026-07-22 の実地確認で、効果音ラボの robots.txt が ClaudeBot を含む主要 AI
ボットに対し Disallow: /*.mp3$ を明記していたことが判明。ToS 沈黙だけで
「許可サイト」と判定してはいけない教訓として記録）
- 直列取得・リクエスト間 3〜5 秒スリープ・通常ブラウザ相当 UA・失敗はリトライ 1 回
まで。 一括・並列取得はしない
- 取得元ページ URL・取得日時・ライセンス・クレジット要否を来歴として必ず記録する
（
~/.akari/assets/audio/_staging/<site>/<id>/ 等の評価用ステージングに
.meta.json を添える）
- 評価後、keep 以外は破棄する。 取得はあくまで「まとめて試聴して選ぶ」ための
一時ステージングであり、無条件の永続保存ではない
- ページからファイル URL を実際に読み取れた曲のみ取得する。当て推量で URL を
組み立てて取得しない（本ルール自体は不変）
- フォーム送信・Referer 付与など「実ブラウザが行う標準的な操作の忠実な再現」は
許容されるが、認証回避・レート制限回避・robots.txt 迂回を目的にしたヘッダー偽装や
UA 偽装は行わない
- 候補リストのリンクは必ずダウンロードページ URL にする。 音声ファイルへの直リンクは
張らない（効果音ラボ・甘茶の音楽工房・H/MIX GALLERY 等の「直リンク禁止」規約対応）。
- 在庫・実在を捏造しない。
catalog/audio/candidates.json に無いサイト・URL・
ライセンス表記を発明しない。ページの実在やファイル名を確認できない場合は
confidence: "blocked_unverifiable" 等、不確かである旨をそのまま記録する。
ai_training_allowed を安全側に倒す。 配布元の規約が AI 学習利用を明示的に許可して
いない限り false にする（未許諾を許可とみなさない）。CC0 明記のみ true。- 音声実体を本リポにコミットしない。 実ファイルは常にリポジトリ外
（
~/.akari/assets/audio/<id>/ 等の user スコープ）へ置く。catalog/audio/ には
remote: true の参照メタしか置かない。
- 既存の
catalog/audio/<id>/ を無断で上書きしない。 id が衝突したら書き込みをスキップし
ログに残す（harvest-asset / setup-library と同じ規律）。
node packages/schemas/bin/validate-asset.mjs を通さずに「登録完了」と報告しない。
（library scope の実体エントリのみ対象。remote: true のカタログ参照エントリは
validator 側の設計で preview.png チェックが免除される）
実行順リーフ
- candidate-list.md —
catalog/audio/candidates.json を元に候補リスト
HTML を生成する。既所有（catalog 登録済み）はグレーアウト表示になる
- drop-folder.md — ユーザーがドロップフォルダへ保存したファイルを走査し、
候補と照合してライブラリ配置 + catalog メタ登録、または隔離する
- gallery.md — 登録済み音源を試聴し、keep/drop を記録する
詳細を先読みせず、現在の工程に対応するファイルだけを読む。
setup-library / harvest-asset との関係（意図的に独立スキルにした理由）
このスキルは ../setup-library/ や ../harvest-asset/ の meta.json v0 契約・スコープ階層
（local / shared / user / builtin）・validator をそのまま流用する。ただし取得フロー
そのものは別スキルとして独立させた。理由:
setup-library は「その場でカタログを提示 → 承認 → 直接取得 or ログイン誘導」という
単一セッション完結のフローを前提にしている。音源は「候補リストを見て、後日ゆっくり
ダウンロードして、気づいたときにまとめて登録する」という非同期・複数セッションの
運用になり、フローの形が本質的に異なる（starter-pack.md / fetch-and-validate.md
へ無理に追記すると分岐が増えすぎる）。- ドロップフォルダ走査・ファイル名照合・隔離（出典不明リスト）・試聴ギャラリーは、
他カテゴリ（3d/font/broll 等）には無い音源固有の機構。
- 既存 2 スキルのファイルは変更していない（
setup-library/SKILL.md にこのスキルへの
参照リンクを追加することは今回のタスク境界外のため見送った。ユーザー・オーナーが
必要と判断すれば別途追加できる）。
根拠
