x-search-insight

name: x-search-insight description: | X 調査のファクトレポートをインプットに、観察された事実の解釈、想定される仮説、グループ間の関係性、リスク、次に調べるべき論点を Markdown にまとめる skill。各記述に投稿グループ ID (`#group-N`) と代表投稿 ID (`#post-N`) の根拠引用を必須とし、確信度 (low / medium / high) と理由を併記する。施策提案・投稿文・広告文・クリエイティブ案は生成せず、外部 API 呼び出しや新規取得も行わない。

X 調査の考察・仮説レポートを生成する skill。x-search-report が出力したファクトレポートだけをインプットにし、新規取得や外部 API 呼び出しは行わない。

ファクトレポートの投稿グループ (group-N) と代表投稿 (post-N) を根拠引用しながら、観察された事実の解釈、想定される仮説、グループ間の関係性、リスクや懸念、次に調べるべき論点を Markdown にまとめる。仮説は反証可能な形で書く。

いつ呼ぶか

x-search-report がファクトレポートを 1 本生成し終え、その内容を起点に意味付けや仮説出しを行いたいとき。
同じファクトレポートに対し、観点を増やしたい / 反証を点検したいとき。
次ターンの x-search-plan 入力として「不足している事実」「次に調べるべき論点」を整理したいとき。

呼ばないでよいケース:

計画立案だけが必要 → x-search-plan
一次取得だけが必要 → x-search
ファクトレポートを書き起こすだけ → x-search-report
ファクトレポートが未生成 / status=failed のとき。先に再取得して x-search-report を成立させる。

インプット

この skill が読むのは次のみ。

ファクトレポート Markdown 1 本（status=complete または status=partial）。
frontmatter の purpose / language / period_from / period_to / collected_at / tools_used。
本文の ## 調査条件 / ## 全体サマリ / ## 検索ログ / ## 検索品質メモ / ## 次に試す検索候補 / ## 投稿グループ / ## 未分類 / ## 取得できなかった情報 / ## 失敗した検索。

次のものは読まない / 持ち込まない。

x-search の生 JSON。引用はファクトレポートの ID 経由のみ。
別のファクトレポート。あれば別ターンで生成する。
agent 自身の事前知識、外部記事、Web 検索結果。事実の補完は行わない。

出力

単一の Markdown ファイル（考察・仮説レポート）。
出力先は aachat 共有ドキュメント (aachat/docs/<team>/<project>/<kind>/<id>.md) に同期する前提。
templates/insight-report.md を雛形として開き、固定セクションをそのまま埋める。
例は examples/insight-report.md を参照する。

固定セクション順 (この順で固定)

前提
解釈
仮説
リスク・懸念
次に調べるべき論点
不足している事実

セクション順は変えない。記載すべき事実が無いセクションも見出しは残し、本文に「該当なし」と書く。

引用ルール (Iron Law)

各記述に必ず根拠引用を付ける。引用形式は #group-N / #post-N / Q#N のいずれか、もしくは「観察された声 (不満|要望|称賛|比較対象) - #group-N」。
1 つの解釈・仮説に対し、複数のグループや投稿を根拠とする場合は全て列挙する。
引用できる事実が無い記述は書かない。書く必要があれば「不足している事実」に回す。
数値（likes / reposts / replies / views など）を引用するときは、その値の出所となる #post-N を必ず併記する。
ファクトレポートに無い数値・固有名詞・出典を本レポートに持ち込まない。
ファクトレポートが partial の場合、欠損領域に関する記述は「不足している事実」に寄せる。

確信度の付け方

各「解釈」「仮説」に low / medium / high を付け、理由を併記する。

確信度	目安
high	同じ傾向を示すグループが複数あり、代表投稿の指標と観察された声が一貫している
medium	単一グループの中で代表投稿の傾向は揃うが、他グループとの関係や反証がまだ確認できていない
low	観察された事実が少ない / 代表投稿数が少ない / サンプル偏りやノイズの懸念がある

確信度を上げるには、ファクトレポート側で何が追加観察されれば足りるかを「不足している事実」または「次に調べるべき論点」に書く。

仮説の書き方

仮説は反証可能な形で書く。「〜なら○○な観察が出るはず」を含める。
仮説の主語は人 / セグメント / 文脈にし、媒体全体や「X ユーザー全員」と一般化しない。
1 仮説 1 主張に絞る。複数主張がある場合は別仮説に分ける。
各仮説に「反証されうる観察」を必ず併記する。これが書けないなら仮説として書かない。
仮説の根拠は最低 1 つの #group-N または #post-N を引用する。

リスク・懸念で必ず点検する観点

サンプル偏り（特定アカウント、bot、自動投稿クライアントへの集中）。
言語・地域による偏り（ファクトレポートの language で説明可能か）。
期間による偏り（period_from / period_to のスナップショット性）。
誤読しやすい点（皮肉、引用 RT、否定形、文脈反転）。
反証材料の可能性（同じ事象の別解釈）。
グループ間の混在（同じ投稿が複数グループにまたがる場合の重み付け）。

各点検観点に該当する事実が無い場合は「該当なし」と書き、点検を省略しない。

次に調べるべき論点の書き方

論点ごとに次を埋める。

論点 (1 文)
想定される検索クエリ案 (言語・期間・絞り込み軸を含む粒度)
期待する確認内容 (どんな観察が出れば論点が解消するか)
次ターンで使う skill (x-search-plan / x-search / x-search-report / x-search-insight)

ファクトレポートに next-query-N がある場合は、論点の末尾に参照 ID を付ける。反証用候補 (kind=contradict) は、仮説の確信度を上げるためではなく、仮説が崩れる条件を確認する論点として扱う。

取得手段 (bird / x-api / web) の選定はここでは行わない。x-search-plan に任せる。

手順

ファクトレポートの frontmatter から purpose / language / period_* / collected_at / tools_used を読む。status=failed なら本 skill は走らせず、x-search-plan に戻る。
本文を読み、Q#N / #group-N / #post-N の対応関係をメモする (本レポートの根拠引用に使う)。
templates/insight-report.md をコピーし、frontmatter の source_fact_report / purpose / collected_at / written_at を埋める。written_at は本レポート生成時刻。
「前提」セクションに参照ファクトレポートの位置、調査目的、範囲、グループ一覧を転記する。
「解釈」に、観察された事実ごとに 根拠 → 想定される意味 → 確信度 → 確信度の理由 → 反証材料の可能性 を埋める。
「仮説」に、反証可能な単一主張ごとに 仮説 → 根拠 → 確信度 → 確信度の理由 → 反証されうる観察 を埋める。
「リスク・懸念」の 6 観点すべてを点検する。該当なしも明記する。
「次に調べるべき論点」に、ファクトレポートの「検索品質メモ」「次に試す検索候補」「取得できなかった情報」「失敗した検索」「未分類」を吸収して埋める。
「不足している事実」に、引用できる事実が足りず本レポートに書けなかったことをまとめる。
frontmatter の status を、すべてのセクションが事実引用付きで埋まったら complete、一部が「不足している事実」止まりなら partial、ファクトレポート自体が薄く本レポートを成立させられなかったら blocked にする。

やらないこと

施策提案、マーケ施策の優先順位付け、KPI 提案。
投稿文、広告文、クリエイティブ案、ハッシュタグ案、コピー案。
取得手段の選定や script 実装の指示（bird / X API / Web のどれを呼ぶかは x-search-plan / x-search に任せる）。
ファクトレポートに存在しない事実の補完、外部知識や事前学習の混入。
「優良」「成功」「狙い目」「勝ち筋」など評価語・推測語を解釈や仮説の見出しに使うこと。
単一の #post-N だけを根拠に媒体全体や全ユーザーへの一般化を行うこと。
ファクトレポートの ID を書き換えること（#post-N の番号は欠番含めてそのまま引用する）。

単体再利用

この skill ディレクトリは単体で別 agent repo の .agents/skills/<name>/ / Claude Skills .claude/skills/<name>/ / plugin skills/<name>/ に移しても動く。

scripts/ / schemas/ を持たないため、外部依存はない。
インプットは事前生成済みのファクトレポート Markdown（パス指定）。
secret は不要。aachat env provider からの環境変数注入も不要。

参考

docs/agent-designs/x-research-expert/SPEC.md: agent / skill 全体の責務、レポート仕様、考察・仮説レポートの章。
同一 agent 配下の x-search-report skill: 入力となるファクトレポートのテンプレートと項目定義。
同一 agent 配下の x-search-plan skill: 「次に調べるべき論点」を次ターン計画に反映する。