research

外部情報の調査と事実確認を行い、根拠と適用条件を確かめる skill。外部情報の裏づけが結論に必要なときに使用する。技術分野に限定しない。

SKILL.md

GitHub

Research

目的

外部情報を集めて評価し、結論を支える根拠と、その適用条件を説明できる状態にする。 確かめた事実、推論、未確認のことを区別し、根拠が足りない場合には断定しない。

使うタイミング

  • 外部の仕様や最新状況などの裏づけが、回答や方針の結論に必要なとき
  • 外部情報を調べたり、既存の主張が正しいかを確かめたりするよう頼まれたとき

この skill は、ユーザーに言われるのを待たずに使う。手動でも呼び出せる。 相手の意図やユーザーとの合意の確認、手元のコードだけで確かめられる問題は対象にしない。

Workflow

  1. 調べる問いと、判断に必要な根拠を定める
  2. 問いに適した情報源を選ぶ
  3. 原文と適用条件を確認し、主張を裏づける
  4. 反する根拠や食い違いを検討する
  5. 調査を終え、根拠と未確認事項を示す

1. 問いと必要な根拠

何を知り、その結果で何を判断するのかを整理する。 既存の主張を検証する場合は、個別に確かめられる主張に分ける。 対象の時点、地域、製品やバージョン、利用条件など、答えが変わる条件を押さえる。 依頼や既存の資料から判断できず、結論が変わる条件だけをユーザーに確認する。

どの根拠が揃えば判断できるかを先に決める。 例えば、仕様上の対応有無なら対象バージョンの仕様、実環境で動くかならその環境での観察が必要になる。 調査の深さは、誤った場合の影響と、情報の変わりやすさや不確かさに応じて決める。

2. 情報源の選び方

利用できる検索、接続先の資料、指定された URL などから、問いに適した情報源を探す。 ユーザーが指定した資料や調査範囲を尊重する。

発行元、元の発言、原データ、仕様、実装などの一次情報を優先する。 解説記事や検索結果は、原典を探す手がかりとして使う。 一次情報に到達できない場合は、利用できた資料と、その限界を示す。

問いに応じて、情報源が示せることを区別する。

  • 提供元の公式仕様や告知: 対応条件、提供予定、提供元が定めるルール
  • 実装や再現可能な観察: 対象の条件で実際に起きる振る舞い
  • 原データや研究: 測定方法や対象に制約のある観察結果

公式であることだけで、主張全体が裏づけられたと判断しない。 例えば、提供元の性能比較は、比較条件や測定方法も確認する。

3. 原文と適用条件の確認

検索結果の要約や引用の一部だけで確定せず、元の資料の該当箇所と前後の条件を読む。 次のことを確かめる。

  • 発行元と、資料が根拠として参照している原典
  • 公開日や更新日、記述が対象とする時点。公開日と出来事の日付を混同しない
  • バージョン、地域、プランなど、今回の対象に関わる適用条件
  • 述べたい主張を直接支えている箇所と、資料からは分からないこと

最新の資料でも、今回の対象に適用できるとは限らない。 例えば、最新版のドキュメントにある機能を、利用中の旧バージョンでも使えるとは判断しない。 仕様に書かれたことと、実際に観察したことも区別する。

根拠から追加の解釈を加えた結論は、推論として扱う。 資料を開けなかった場合や、対象条件が確認できない場合は、確認済みとしない。 検索や一覧で見つからないことだけで、存在しないとは判断しない。

4. 反する根拠と食い違い

最初の結論に合う資料だけを集めず、結論が成立しない条件や反する根拠も調べる。 複数の資料による裏づけが必要な場合は、出所が独立しているかを確かめる。 同じ発表の転載や、その発表を引用した記事を、独立した裏づけとして数えない。

情報が食い違う場合は、時点、対象条件、用語の意味、測定方法の違いを確かめる。 例えば、機能の発表と実際の提供開始は別の事実として扱う。 資料の数だけで結論を選ばず、問いへの適合性と根拠の強さで判断する。

食い違いを解消できなければ、何が一致せず、判断にどう影響するかを示す。 反する根拠が見つからなくても、それだけで正しさが証明されたとは扱わない。

5. 調査を終える判断

結論に必要な根拠と適用条件が確認でき、残る不確かさが判断を変えなければ調査を終える。 資料数や検索回数を満たすためだけに調べ続けない。

根拠にアクセスできない場合は、利用可能な原典や代替資料を探す。 追加の調査でも重要な不足を埋める見込みがなくなれば、断定せずに結果を報告する。 確かめられなかったことと、確認に必要な資料や条件を示す。

報告

結論を先に書き、その結論を支える理由を短く説明する。 調べた経緯や全資料の一覧は、求められない限り並べない。

  • 根拠: 主要な事実の近くに、直接支える資料へのリンクや参照箇所を示す
  • 適用条件: 結論を左右する時点、バージョン、対象範囲などを示す
  • 推論: 資料に直接書かれた事実と区別し、何を根拠に導いたかを示す
  • 未確認事項: 判断に影響する不足や食い違い、その影響と確認方法を示す

該当しない項目は省き、回答の長さは問いと判断の重さに合わせる。 変化しやすい情報には、いつの情報を確認したかも示す。