ln-002-best-practices-researcher

パス： ファイルパス（shared/、references/、../ln-*）は、リポジトリのルートからの相対パスです。CWD に見つからない場合は、この SKILL.md があるディレクトリを探し、1 つ上の階層をリポジトリのルートとしてください。

ベストプラクティスリサーチャー

業界標準を調査し、1 つのワークフローでプロジェクトのドキュメントを作成します。

目的と範囲

• MCP Ref と Context7 を使用して、標準、パターン、バージョンを調査します
• 調査結果から次の 4 種類のドキュメントを作成します：
  • ガイド：パターンのドキュメント（推奨／非推奨／適用時期の表）
  • マニュアル：API リファレンス（メソッド／パラメーター／ドキュメントへのリンク）
  • ADR：アーキテクチャ決定記録（Q&A 形式の対話）
  • リサーチ：特定の質問に回答する調査ドキュメント
• ストーリー／タスクからリンクできるよう、ドキュメントのパスを返します

フェーズ 0：スタックの検出

目的：調査クエリを絞り込み、出力を調整できるように、プロジェクトのスタックを特定します。

検出：

指標	スタック	クエリの接頭辞	公式ドキュメント
*.csproj、*.sln	.NET	"C# ASP.NET Core"	Microsoft docs
package.json + tsconfig.json	Node.js	"TypeScript Node.js"	MDN、npm docs
requirements.txt、pyproject.toml	Python	"Python"	Python docs、PyPI
go.mod	Go	"Go Golang"	Go docs
Cargo.toml	Rust	"Rust"	Rust docs
build.gradle、pom.xml	Java	"Java"	Oracle docs、Maven

使い方：

• すべての MCP 検索クエリに query_prefix を追加します
• スタックに適した公式ドキュメントにリンクします

使用する場面

• ln-310-multi-agent-validator がドキュメントの不足を検出した場合
• パターン、ライブラリ、または決定をドキュメント化する必要がある場合
• 次のスキルの代替：ln-321-guide-creator、ln-322-adr-creator、ln-323-manual-creator

入力パラメーター

パラメーター	必須	説明
doc_type	はい	"guide" / "manual" / "adr" / "research"
topic	はい	ドキュメント化する内容（パターン名、パッケージ名、決定のタイトル、調査の質問）
story_context	いいえ	関連性の判断に使うストーリー／タスクのコンテキスト

調査ツール

ツール	用途	クエリの形式
ref_search_documentation	標準、パターン、RFC	"[topic] RFC standard best practices {current_year}"
context7__resolve-library-id	ドキュメント用のライブラリ ID を取得	libraryName="[topic]"
context7__query-docs	ライブラリの API、メソッド	topic="[stack_prefix] [topic]"
WebSearch	市場、競合、バージョン	"[topic] latest {current_year}" または "[topic] vs alternatives"

時間の目安： 調査は 5〜10 分とし、トピックが簡単な場合は省略します

種類別の調査方法（doc_type="research" の場合）

種類	焦点	主な情報源	主な質問
技術	ソリューションの比較	ドキュメント、ベンチマーク、RFC	「どのソリューションがこちらのユースケースに適していますか？」
市場	業界の動向	レポート、ブログ、記事	「市場の規模やトレンドはどうなっていますか？」
競合	他社の解決方法	製品ページ、レビュー、デモ	「競合はどのような機能を提供していますか？」
要件	ユーザーのニーズ	フィードバック、サポートチケット、フォーラム	「顧客はどのような点に不満を持っていますか？」
実現可能性	開発の可否	PoC、プロトタイプ、ローカルテスト	「技術的に実現可能ですか？」
機能の需要	機能の実現可能性	競合の機能 + ブログ／ソーシャルメディア + ユーザーの不満	「この機能を開発する価値はありますか？」

ワークフロー

doc_type	目的	調査ソース	テンプレート	出力パス	文字数
guide	Do/Don't/When テーブルを含むパターン	ref_search（ベストプラクティス）	guide_template.md	guides/NN-[slug].md	300-500
manual	API／ライブラリのリファレンス	context7__query-docs	manual_template.md	manuals/[pkg]-[ver].md	300-500
adr	アーキテクチャ上の決定	対話（5つの質問）	adr_template.md	adrs/adr-NNN-[slug].md	300-500
research	質問に答える調査	上記の方法論テーブルを参照	research_template.md	research/rsh-NNN-[slug].md	300-700

共通ワークフロー： 番号を検出（必要な場合）→ 調査 → テンプレートから生成 → 検証（SCOPE、POSIX）→ 保存 → パスを返す

doc_type ごとの抽出項目とセクション：

• guide： 原則、2～3 件の Do/Don't、出典を抽出 → セクション：原則、実装内容、パターンテーブル、出典、関連項目
• manual： メソッド、パラメーター（型／必須／デフォルト）、戻り値を抽出 → セクション：パッケージ情報、概要、メソッドテーブル、設定テーブル、制限事項
• adr： 対話の回答 → セクション：背景、決定、根拠、代替案テーブル、結果、関連項目
• research： 方法論に基づく調査結果 → セクション：質問、背景、方法論、調査結果（テーブル！）、結論、次のステップ、出典

検証の詳細： guide：パターンテーブルがあること、manual：ファイル名にバージョンを含めること、adr：ISO 日付とステータスフィールドがあること、すべて：出典が 1 年以内であること

ADR の対話（5 つの質問）： Q1：タイトルは？ → Q2：カテゴリ（戦略／技術）は？ → Q3：背景は？ → Q4：決定と根拠は？ → Q5：代替案（長所／短所を含む 2 件）は？

出力： Stories／Tasks からリンクするためのファイルパス。ADR の場合は architecture.md で参照するよう案内し、Research の場合は決定が必要であれば ADR を提案します。

重要なルール

ファイル作成必須：

• すべての調査は、ファイルの作成（guide／manual／ADR／research ドキュメント）で必ず完了させてください
• 対象ディレクトリがない場合は作成してください（docs/guides/、docs/manuals/、docs/adrs/、docs/research/）
• 例外はありません。すべての呼び出しでファイルの作成が必要です

NO_CODE_EXAMPLES（すべてのドキュメントタイプ）：

禁止	許可
コードスニペット	テーブル（パラメーター、設定、代替案）
実装例	ASCII 図、Mermaid 図
1 行を超えるコードブロック	メソッドシグネチャ（インライン 1 行）
	公式ドキュメントへのリンク

フォーマットの優先順位（厳守）：

┌───────────────────────────────────────────────┐
│ 1. TABLES + ASCII diagrams  ←── PRIORITY      │
│    Params, Config, Alternatives, Flows        │
├───────────────────────────────────────────────┤
│ 2. LISTS (enumerations only)                  │
│    Enumeration items, file lists, tools       │
├───────────────────────────────────────────────┤
│ 3. TEXT (last resort)                         │
│    Only if cannot express as table            │
└───────────────────────────────────────────────┘

内容の種類	フォーマット
パラメーター	テーブル：Name | Type | Required | Default
設定	テーブル：Option | Type | Default | Description
代替案	テーブル：Alt | Pros | Cons | Why Rejected
パターン	テーブル：Do | Don't | When
ワークフロー	ASCII 図：A → B → C

その他のルール：

• 呼び出しごとの調査は 1 回のみとし、結果を再利用してください
• バージョン／日付を含む出典を引用してください（1 年以内）
• guide にはパターンを 1 つ、ADR には決定を 1 つ、manual にはパッケージを 1 つ記載してください
• story_context の言語（EN／RU）を維持してください
• スタックに適したドキュメントへのリンクを記載してください（.NET には Microsoft、JS には MDN など）
• 必須： 対象ディレクトリがない場合は作成してください（docs/guides/、docs/manuals/、docs/adrs/、docs/research/）。ファイルの作成は必須です

完了の定義

• 調査が完了している（標準／パターン／バージョンを抽出済み）- guide／manual の場合
• 対話が完了している（5 つの質問に回答済み）- ADR の場合
• 必須セクションがすべて含まれ、プレースホルダーがないドキュメントが生成されている
• 標準が検証されている（SCOPE、保守性、POSIX）
• 適切な命名規則に従って、正しいディレクトリにファイルが保存されている
• パスが返されている。プレースホルダーがある場合は README が更新されている

Reference Files

• Guide template: shared/templates/guide_template.md
• Manual template: shared/templates/manual_template.md
• ADR template: shared/templates/adr_template.md
• Research template: shared/templates/research_template.md
• Standards: docs/standards/DOCUMENTATION_STANDARDS.md (if exists)
• MANDATORY READ: shared/references/research_tool_fallback.md

---

Version: 3.0.1 Last Updated: 2026-02-14