fit-scorer

適合度スコアラー

候補に絞り込んだクリエイターを、型付き STAR の**適合性（S）**の観点でそれぞれ評価し、案件固有の商業的適合性は別の優先順位付けマトリクスで扱います。適合性には、特定の案件に依存しない STAR-S8 のブランド／カテゴリーおよびオーディエンスとブランドの適合性を示す根拠が含まれます。案件条件、対応可能状況、キャンペーンの調整は適合性の対象外です。商業的適合性マトリクスは適合性スコアではなく、SQS に含めることもありません。

クイックスタート

インフルエンサーを1人評価します。

Score @[handle] for [brand/campaign] and tell me if they're a good fit

候補リストを比較して順位付けします。

Compare and rank these influencers for [campaign]: @influencer1, @influencer2, @influencer3

スキルの契約

• 読み取り：ブランド／キャンペーンのコンテキスト、ターゲットオーディエンスの定義、キャンペーン目標、および安定した不透明な creator_ref と、一時的なハンドル／プロフィール URL または解決可能な不透明なハンドル参照を含む候補エントリー（ユーザーが提供したもの、または influencer-discovery から引き継いだもの）。任意で、memory/influencer/audience-mapper/ の過去のオーディエンスプロフィール、memory/influencer/competitor-tracker/ の競合パートナーのベンチマーク、およびユーザーが引き継ぎを提供または許可した場合の WARM Campaign Retro Card の evidence_refs と next_campaign_hypothesis。登録済みクリエイターについては、memory/creators/<aggregate-id>.md にあるパートナーシップ履歴とオーディエンス統計の出典情報（creator-registry の登録記録）を、パートナーシップの可能性を判断する入力として読み取ります。
• 書き込み：型付きの適合性（S）の評価と、別途ラベルを付けた商業的適合性の比較結果を、既定ではインラインで返します。Retro Card が提供された場合は、その仮説を次サイクルのテスト制約として別途ラベルを付けて保持し、スコアや判定には影響させません。レポートを memory/influencer/fit-scorer/YYYY-MM-DD-<topic>.md に保存するのは、正確な WARM 保存許可がある場合に限ります。保存したレポートと引き継ぎには、安定した不透明な creator_ref と不透明な根拠参照を保持し、生のハンドル、名前、プロフィール URL、メールアドレス、プロバイダー ID、または決定論的ハッシュを creator_ref に含めません。
• 昇格：別途、正確な許可がある場合に限り、根拠によって裏付けられた有力候補と、その正確な適合性（S）の評価およびカタログバージョンを memory/hot-cache.md に昇格します。未評価／暫定の結果や、Retro Card の定性的な判断／仮説を、スコア付きの事実として昇格させてはなりません。
• 完了条件：
  • すべてのクリエイターについて、適合性の10項目 S1～S10 すべてに、日付付きの根拠または不足理由を添えて、Pass／Partial／Fail／Unknown／N/A を明示します。
  • すべてのクリエイターについて、発見／登録時に引き継いだ安定した不透明な creator_ref、またはこの系統のために一度だけ生成したものを保持します。生の識別情報ロケーターは一時的なものとして扱います。
  • 型付きの目標／コンテキストと適合性項目の状態をゲート用に保持します。Unknown がある場合、適合性の評価は出せません。
  • 商業的適合性の順位付けを行う場合は、適合性の評価と明確に分け、拒否条件や根拠の欠落を覆せないようにします。
  • Retro Card が提供された場合、その next_campaign_hypothesis は、反証可能なテスト制約／商業的適合性マトリクスのコンテキストとしてのみ表示します。その evidence_refs は新たな調査のための参照先であり、STAR 項目の根拠や自動的な選定ルールではありません。
• 主な次のスキル：campaign-planner — 順位付けした候補リストを、承認済みのキャンペーン計画にまとめます。計画がすでに承認済みで、アウトリーチの準備も整っている場合は、代わりに outreach-manager に引き継ぎます。競合ベンチマークは任意です。

引き継ぎサマリー

skill-contract.md §Handoff Summary Format にある標準形式で出力します。

データソース

このファミリーでは、ライブ連携は不要です（Tier 1）。Fit Scorer は、スコアリング対象の入力（有効期間が限られたハンドルまたはプロフィールの参照先、オーディエンスのターゲット、ブランド価値、手元にある指標）をユーザーに尋ねることで、エンドツーエンドで動作します。コネクターを使えば数値の精度が高まりますが、必須ではありません。

• ~~influencer database — フォロワー数、オーディエンスの属性、パートナーシップの履歴。
• ~~social platform analytics — エンゲージメント率、コメントの品質サンプル、投稿頻度、成長傾向。
• ~~audience intelligence — 実際のフォロワーとボットのフォロワーの推定数、ターゲットとのオーディエンスの重複状況。
• Roster record (keyless Tier 1) — クリエイターが名簿に登録されている場合、過去の連絡、返信の評判、納品履歴は memory/creators/<aggregate-id>.md に記録されています（creator-registry が管理します）。同じ履歴について、名簿レコードがない場合は ~~CRM を Tier 2 の任意の精度向上手段として利用できます。

測定済みの YouTube 入力値（無料キー）：YouTube の候補については、python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/youtube.py" videos @handle --limit 10 を実行すると、エンゲージメントの真正性を判定する入力値が直接得られます。動画ごとの再生回数・高評価数・コメント数を表示されている登録者数と照らし合わせるため（再生回数と登録者数の整合性、コメント率、投稿頻度）、これらのサブスコアにはスクリーンショットではなく測定済みの数値が使われます。無料の YOUTUBE_API_KEY が必要です。候補の絞り込み時の審査に限ります（ToS により、クォータを使用した一括取得は禁止されています）。scripts/connectors/README.md を参照してください。

連携を一切使わない場合は、スコアリング表で求められる各値をユーザーに提示してもらいます。フレームワークと重み付けにより、引き続き根拠のあるランキングを作成できます。カテゴリごとの無料／キー不要の方法については、CONNECTORS.md を参照してください。

手順

契約に準拠したコピー用レイアウトは references/scoring-templates.md にあります。Suitability の評価には、creator_ref のみを使う型付きの STAR-S1～STAR-S10 エビデンステーブルを使用し、その後、意思決定を別途支援する目的で、任意の commercial_fit_score テーブルを使用してください。これらの出力に生の参照先をコピーしないでください。

1. ID と型付きコンテキストを固定します。 ディスカバリーで明示的に引き継がれた不透明な creator_ref を再利用します。クリエイターレジストリの集約 ID は、そのハンドルとのリンクが検証済みの場合に限り使用します。ユーザーが未加工のハンドル／プロフィール URL のみを提供し、検証済みの集約 ID が存在しない場合は、ランダムな creator-<UUIDv4> を 1 つ生成し、このレポート、許可された保存、以降の引き継ぎで変更せずに再利用します。creator_ref を未加工のハンドル、名前、URL、メールアドレス、プロバイダー ID、またはそれらの決定論的ハッシュに設定してはいけません。これらの特定用情報は、証拠の取得時のみ一時的に使用します。不透明な参照を解決するのは、付随する許可済みアーティファクト、または検証済みレジストリリンクを通じてのみです。どちらも利用できない場合は、一時的な特定情報を求め、推測や統合をせずに ID を未解決のまま保持します。次に、クリエイターの target とターゲットのバージョン、名前付き STAR プロファイル／目標（awareness|engagement|conversion|brand-building）、assessment_time: forecast|actual、共有キャンペーンの rollup_id、観測日、プラットフォーム／ティア／ニッチのコホート、証拠の期間、重要なコンテキストオブジェクト、現在の STAR catalog_version を必須とします。これらが、ゲートで再利用される正確な型付き ID です。フィールドが欠けている場合は補完せず、不足フィールドを明示して NEEDS_INPUT を返し、再開時に使えるよう、提供された ID を変更せずに保持します。Campaign Retro Card が提供された場合は、その evidence_refs と next_campaign_hypothesis を、スコアに影響しないサイクル前のコンテキストブロックに別途記録します。どちらも STAR の型付き ID の一部にはなりません。
2. 現在の期間の証拠を確定します。 現在のクリエイター分析、公開情報、ロースター履歴、コホートのベンチマークを、ソース／日付／種類／信頼度とともに使用します。Retro Card とその evidence_refs はディスカバリー用の参照情報に限られ、STAR の項目証拠にはなりません。参照先の一次情報源を独立して再取得でき、現在の証拠期間の要件を満たす場合は、カードではなく、その新しい観測結果を引用します。非公開データへのアクセスが得られない、または拒否された場合は Unknown とし、Fail や Partial にはしません。
3. Suitability のみをスコアリングします。 star-benchmark.md に基づき、Suitability 項目 S1～S10（オーディエンス構成／実在性、フォロワー増加の健全性、リーチの信頼性、エンゲージメントの健全性と真正性、信頼性、取引に依存しないブランド／カテゴリー適合性）を評価します。取引固有の商業条件、対応可能性、オーケストレーション上の競合は別のマトリックスで扱います。費用と測定済みのキャンペーンコンバージョンは Return（R）に属し、後でゲートがスコアリングします。
4. 引き継ぎに必要な重要管理項目の証拠を認定します。 STAR-S2 は、実証されたフォロワー不正／該当するティア × プラットフォーム × ニッチのベンチマークを下回る実フォロワー率を対象とします。STAR-S6 は、実証された購入、協調的、またはポッドベースのエンゲージメントを対象とします。ブランドセーフティはゲートの Trust 管理項目 STAR-T3 であり、Suitability 項目ではありません。項目を Fail とするのは、要件を満たす証拠がある場合に限り、潜在的なゲート所見として明示し、その状態が続く間は運用上のアウトリーチを保留します。ここでは検証済みの拒否権と呼んだり、SQS の上限やビジネス判定を適用したりしません。STAR 全体の実行結果を集約する際の判断は監査担当者が行います。
5. ゲート用に Suitability の評価結果を記録します。 固定されたブランド／カテゴリー／コホートのコンテキストにおいて、S1～S10 の各状態を Pass／Partial／Fail／Unknown／N/A のいずれかで正確に記録し、ソース／日付／期間／種類／信頼度、または明示的な不足理由／N/A の理由を添えます。この型付きテーブルが Suitability の評価結果であり、1～5 の参考値ではありません。creator-content-auditor ゲートはこれを完全な STAR 実行に統合し、決定論的スコアラーでプロファイル加重 SQS を算出します。このスキルはスコアラーを実行せず、SQS も出力しません。Unknown は、該当する証拠が不足していることを意味し、Suitability の評価結果を確定できません。Unknown を Partial に置き換えたり、複合スコアを手計算したりしてはいけません。
6. 依頼があれば、別個の商業マトリックスを作成します。 取引固有のオーディエンス／目標に関する詳細、コンテンツ案、ブランド競合、商業条件、対応可能性、パートナーシップの可能性を使用します。提供された next_campaign_hypothesis は、反証可能なテスト制約としてマトリックスの横に記載できますが、ポイントにも重み付けにも一切加算しません。すべての 1～5 の構成要素と、その集計値に commercial_fit_score とラベルを付けます。「Fit Score」や「Final Score」と呼んではいけません。これは Suitability スコアではなく、Suitability の管理項目の所見を解消できず、SQS にも含まれません。
7. 透明性を保って順位付けします。 型付き Suitability 評価、重要管理項目、個別の commercial_fit_score、証拠の信頼度、宣言されたルールに基づく担当者と再実行条件付きのアクションを示します。一般的な Verdict や星評価は出力しません。デフォルトでは campaign-planner に引き継ぎます。承認済みキャンペーン計画が実行準備済みの場合に限り、outreach-manager に引き継ぎます。競合ベンチマークは任意の確認項目として案内し、必須の寄り道にはしません。Unknown が多い候補を明確に優位と判断したり、Retro の仮説が特定のクリエイターや戦術に言及していることを理由にポイントを加減したり、前サイクルの renew | retest | retire | unknown の判断から候補を自動選択したりしてはいけません。
8. 許可がある場合に限り、保存します。 正確な WARM 承認を得た後にのみレポートを保存します。ホットキャッシュへの昇格には、別途承認を求めます。保存および引き継ぎには、一時的な未加工の ID 特定情報ではなく、creator_ref と不透明なハンドル／証拠参照を使用します。Retro の仮説は WARM の作業コンテキストとして保持します。このスキルは、暫定的な商業順位やゲートを通していない Suitability の結果を creator-registry に提案しません。

コンパクトな例

ユーザー: 「サステナブルファッションブランド（目標：コンバージョン）のために、@ecofashionista、@greenwardrobe、@sustainablesarahを比較してください。」

出力: 各クリエイターは、上流で付与された不透明なcreator_refを再利用するか、スコアリングの前にランダムなcreator-<UUIDv4>を受け取ります。元のハンドルは一時的な検索入力としてのみ扱われます。次に、各クリエイターには同じキャンペーンのrollup_idのもとでS1～S10の項目状態が付与されます。該当する項目をすべて網羅した場合にのみ適合性（S）の判定が可能です。一方、別の商業条件マトリクスでは、キャンペーン固有の条件と提供状況を説明します。以前のレトロカードが提供された場合、その仮説は次サイクルで検証する重みゼロの制約としてのみ示され、その情報源は現在の期間にあらためて確認されます。ベンチマークを下回る実フォロワー率が確認された場合、STAR-S2は不合格となり、アウトリーチは保留されます。アクセスが拒否された場合は不明のままとなり、判定は行われません。後続のSTAR事業判定／上限を適用できるのはcreator-content-auditorだけです。永続化は提案されますが、前提とはされません。

参考資料

• references/scoring-templates.md — 型付きの適合性エビデンステーブルに加え、個別のcommercial_fit_scoreの構成要素／集計、比較、カスタム重み付け、記入例、部分状態のレイアウト。
• skill-contract.md — 共通契約とハンドオフの要約形式。
• state-model.md — メモリ層と保存先の規約。
• CONNECTORS.md — コネクターのカテゴリごとの無料／キー不要のデータ取得手順。
• スコアリング基準：star-benchmark.md — STARフレームワーク、このスキルが読み取る適合性（S）ディメンション（STAR-S2／STAR-S6の拒否項目を含む）、およびゲートが算出するプロファイル加重SQS。
• 関連スキル：influencer-discovery、competitor-tracker、audience-mapper、outreach-manager。

次に最適なスキル

主な候補：campaign-planner — ランク付けした候補リストを、キャンペーン計画、予算、スケジュール、承認フローに落とし込みます。

条件付きの次のステップ:

• outreach-manager — オファー、予算、対象クリエイター、チャネル、アウトリーチの承認フローがすでに定められた承認済みキャンペーン計画がある場合に限ります。このハンドオフによって送信が許可されるわけではありません。

任意の確認と代替案:

• competitor-tracker — その情報によって選定結果が変わる場合に、競合との提携状況を基準として上位候補を任意で評価します。
• creator-content-auditor — 適合性の判定が完了した場合、またはSTAR-S2／STAR-S6／STAR-T3の管理統制に関する証拠がそろった可能性がある場合は、停止して、この唯一のSTARゲートに別の呼び出しとして引き継ぎます。判定を自動実行したり、模擬したりしてはいけません。
• influencer-discovery — ランク付けする候補が少なすぎる場合に、候補を追加で探します。
• audience-mapper — オーディエンス適合スコアが不確かな場合は、まずターゲットオーディエンスの定義を明確にします。

終了時の注意: このセッションで呼び出したスキルの訪問済みセットを記録します。推奨された次のスキルがすでに実行済みの場合は、再度呼び出さずに終了し、スキルチェーンが完了したことを報告します。最大3ホップ（最大深度3）で停止し、インラインの結果と、個別に承認された保存先があればそれを返します。

関連スキル

• influencer-discovery - スコアリングするインフルエンサーを探します
• competitor-tracker - 競合の提携先を基準に評価します
• audience-mapper - ターゲットオーディエンスを定義します
• outreach-manager - 高スコアのインフルエンサーに連絡します