web-research について
ウェブ、リポジトリ、文書、メディアから証拠を集めて評価するリサーチスキルです。調査や実装に関する問いを対象とし、情報源の質、矛盾、不確実性、重要な知見の記録を扱います。
主な機能
- 01調査範囲と問いの設定
- 02関連コンテンツの検索と取得
- 03情報源、コード、テスト、メディアの確認
- 04証拠の評価と矛盾の解決
- 05知見の引用と不確実性の明記
活用シーン
- 01最新の技術的な問いの調査
- 02食い違う文書や情報源の比較
- 03依存関係と統合動作の調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ maxedapps/ agent-skills --skill web-researchインストール後、Claude Code で/web-researchを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/fetch-content.mdmedia.mdweb-search.md詳細
Web Research
ルール
- 書き込み禁止/チャットのみの依頼を含め、ユーザーの制約を守ってください。利用可能な情報取得機能を確認し、ツール名を決めつけないでください。
- 一次情報を優先し、回答に不可欠な内容を確認してください。検索結果の抜粋や生成された要約は情報を探す手掛かりであり、十分な根拠ではありません。
- 依存関係に関する主張では、インストール済みのバージョンまたは対象バージョンと、ランタイム/統合の境界を確認してください。現行ドキュメントと矛盾する場合は、バージョンが一致するソースを優先してください。
- 署名、ハッシュ、シリアル化、正規化、認証、ワイヤープロトコルについては、独立した公式実装、テストベクトル、または相互運用性の確認を必須としてください。一貫性のある往復処理だけでは不十分です。
- URLを引用し、観察した事実と推論を分け、不確実性を明示してください。秘密情報、認証情報、非公開セッション、機密性の高いソース内容は保存しないでください。
リソース
該当する作業の前にお読みください。
| 作業 | リソース |
|---|---|
| 大規模な調査メモや意思決定の統合 | ADR conventions:共通ドキュメントのパスと意思決定の権限 |
| 複雑な条件指定、複数の観点、または最新情報の検索 | Web search |
| 複数のソース、リポジトリ、PDF、または途中で切れているコンテンツ | Content retrieval |
| 動画/音声または視覚的な場面 | Media |
ログイン、フォーム、動的な操作にはブラウザー自動化を使用し、ローカル文書にはローカルのパーサー/スクリーンショットを使用してください。
ワークフロー
- 枠組みを定める。 簡単な個別の確認には成果物は不要です。大規模、情報が競合する、再開が必要、実装に不可欠、または高リスクな調査では、ADR conventionsを読み、進行中の作業ドキュメントを再利用するか、
adrs/work/<research-slug>.mdを作成してください。問い、対象範囲、制約、既知の背景、検索の観点を記録してください。書き込み禁止の場合は、根拠を回答に残してください。 - 背景を把握する。 該当する場合は、マニフェスト、ロックファイル、設定、または正確なソースを調べてください。回答に影響する動作、互換性、障害、統合に関する問いを特定してください。
- 情報を探す。 まずユーザーが提示したソースを確認してください。提示されていない場合は、公式ドキュメント、ソース/リリース履歴、裏付けとなる実装など、2~4種類の異なる観点から調査してください。回答に不可欠なソースを取得してください。
- 内容を確認する。 実際のドキュメント/ソース/テスト、またはメディアを読んでください。内容が途中で切れている場合は、全体を取得するか別の取得経路を使って解決してください。大規模な調査では、役立つ知見、引用、バージョン/日付の範囲、重大な矛盾、採用しなかった根拠、未解決の問い、次のアクションを同じ作業ドキュメントに残してください。
- 結論を導く。 信頼性、直接性、バージョンの一致、障害時の動作を評価してください。重大な不足があれば焦点を絞って追加調査し、根拠が揃った場合、残る不足が重大でない場合、または有用な根拠をこれ以上得られそうにない場合に調査を終了してください。
- 統合する。 最終回答、引き継ぎ、またはコンテキストの圧縮の前に、既存の作業メモを読み直してください。知見、影響、ソース間の矛盾、制約を明示してください。意思決定に関わる根拠は該当するADRにリンクしてください。実質的に重要な選択肢だけを起草し、調査そのものを承認と見なさないでください。再利用可能な技術知識はWikiに記載してください。
遅れて得られた結果については、結論が実質的に変わる場合、またはユーザーから求められた場合に限り、追加調査を行ってください。
コメント
Markdown 対応