verify-sources

あなたのタスク

入力：$ARGUMENTS（アルバム名）

指定されたアルバムでソースが未検証のすべてのトラックについて、ユーザーによるソース検証を案内します。

---

ソース検証スキル

あなたは人間によるソース検証ゲートを進行します。これは、リサーチと生成の間にある重要なチェックポイントです。人間がすべてのソースが実在し、アクセス可能で、正確に示されていることを確認するまで、Suno でトラックを生成してはいけません。

---

ステップ 1：アルバムを見つける

1. find_album(name) を呼び出します。名前、スラッグ、または部分一致で検索します
2. 見つからない場合、MCP は利用可能なアルバムを返します

ステップ 2：未検証のトラックを特定する

1. get_pending_verifications(album_slug="{album}") を呼び出します。対象アルバムの未検証トラックが返されます
2. アルバムが指定されていない場合は、get_pending_verifications() を呼び出してすべてのアルバムを対象にします

未検証のトラックがない場合：

All tracks in [album] have been verified. No action needed.

未検証のトラックがある場合は、一覧を表示します：

SOURCE VERIFICATION: [Album Title]
===================================

Tracks needing verification:
  1. [track-slug] — [track-title]
  2. [track-slug] — [track-title]
  ...

Total: X tracks pending verification

ステップ 3：各トラックを確認する

未検証の各トラックについて：

1. extract_links(album_slug, track_slug) を呼び出します。トラックファイルから Markdown のリンクを抽出します
2. extract_links(album_slug, "SOURCES.md") を呼び出します。引用ソースの一覧を取得します
3. 証拠の連鎖、確信度、および主張とソースの対応関係を確認するため、（存在する場合は）RESEARCH.md を読みます。これにより、人間の検証担当者は URL だけでなく、各ソースが「何を」裏付けるはずなのかを把握できます
4. ソースをユーザーに提示します：

TRACK: [track-title]
--------------------
Sources referenced in this track:

  1. [Source Name](URL) — [brief description of what it supports]
  2. [Source Name](URL) — [brief description]
  ...

Please verify:
  - Each URL is accessible and contains the claimed information
  - No sources are fabricated or hallucinated
  - Claims in lyrics are supported by cited sources

Type "verified" to confirm, or describe any issues.

4. ユーザーの回答を待ちます：
   • 「検証済み」または同等の肯定的な回答があった場合 → トラックを更新します
   • 問題が報告された場合 → 内容を記録し、対応方法をユーザーに尋ねます

ステップ 4：トラックファイルを更新する

ユーザーがトラックの検証を確認したら：

1. update_track_field(album_slug, track_slug, "sources-verified", "✅ Verified (YYYY-MM-DD)") を呼び出します。フィールドを更新し、状態キャッシュを自動的に再構築します

   • 今日の日付を使用します

2. 更新を確認します：

✅ [track-title] — Sources verified (2025-02-06)

3. 次の未検証トラックに進みます

ステップ 5：アルバムのステータスを更新する（自動進行）

すべてのトラックの処理後、アルバムのステータスを進める必要があるか確認します：

1. get_album_progress(album_slug) を呼び出します。検証済みになったトラック数を確認します

2. すべてのトラックが検証済みの場合（未検証のトラックが残っていない場合）：

   • アルバムの README を読み、現在のアルバムステータスを確認します
   • アルバムのステータスが Research Complete の場合：
     • アルバムの README を更新します：| **Status** | Research Complete | → | **Status** | Sources Verified | に変更します
     • 「アルバムのステータスが更新されました：Research Complete → Sources Verified」と報告します
   • アルバムのステータスが In Progress の場合：
     • 「すべてのトラックのソースが検証されました。アルバムのステータスは In Progress のままです（すでにリサーチ段階を過ぎています）。」と報告します

3. 未検証のトラックが残っている場合：

   • 残りの数とトラック名を報告します

4. 状態キャッシュを再構築します：MCP サーバーに最新のデータが反映されるよう、rebuild_state() を呼び出します

5. 概要を報告します：

VERIFICATION COMPLETE
=====================
Album: [title]
Tracks verified: X/Y
Album status: [previous] → [new status]
Date: YYYY-MM-DD

All sources verified. This album is cleared for lyric writing.
Next step: /bitwize-music:lyric-writer [track] (write lyrics from verified sources)

部分的な検証レポート（未検証のトラックが残っている場合）：

VERIFICATION PROGRESS
=====================
Album: [title]
Tracks verified this session: X
Tracks still pending: Y
  - [track-slug] — [reason if known]

Album status: unchanged ([current])
Resume verification later with /bitwize-music:verify-sources [album]

---

問題への対応

ユーザーがソースの問題を報告した場合：

1. 問題を記録します。トラックファイルにコメントまたは注記として記載します
2. 検証済みにしないでください。ステータスは Pending のままにします
3. 解決方法を提案します：
   • ソース URL が無効 → 「更新された URL を見つけられますか？」
   • ソースが主張を裏付けていない → 「歌詞を修正しますか？ それとも、裏付けとなるソースを探しますか？」
   • ソースが捏造されている → 「このソースを削除します。トラックも修正する必要がありますか？」
4. 解決後、再度検証のために提示します

---

覚えておくこと

• 自動で検証しないでください。このスキルは人間によるレビューのためにあります
• ソースを明確に提示してください。ユーザーが各 URL を実際に確認できるようにします
• すべてに日付を記録してください。検証日は監査証跡として重要です
• 一度に 1 トラックずつ進めてください。急がず、各トラックを丁寧に確認します
• 状態キャッシュを更新してください。変更後は、インデクサーの更新を実行して MCP サーバーに最新のデータを反映します