best-practice-research

ベストプラクティス調査

タスクが最新の外部ベストプラクティス、バージョンを考慮したガイダンス、標準、公式の推奨事項、またはアップストリームの動作に依存する場合にこのスキルを使用します。これはワークフローのラッパーであり、新しい調査の権威ではなく、証拠収集と統合を振り分けるものです。researcher の代わりにはなりません。

目的

現在の外部証拠を、リポジトリ内のローカルな事実や依存関係の選定判断と区別した、出典付きで再利用可能なベストプラクティスの回答またはハンドオフを作成します。計画前の調査では、これが通常の最初の調査ラッパーとなります。公式/アップストリームの証拠を収集し、それを $ralplan または呼び出し元に計画の入力として引き渡します。$best-practice-research を最終的なアーキテクチャのコンポーネントや、バリデーターでゲートされた調査ループとして提示しないでください。

デフォルトで終端・読み取り専用

このスキルはデフォルトで終端的かつ読み取り専用です。証拠を収集し、ハンドオフ付きの出典付き推奨を作成したら停止します。問いに明確な実装上の意味があっても、このスキルの下でファイルを書き込んだり編集したり、コミットを作成または修正したり、変更を伴うコマンドを実行したり、その他リポジトリの状態を変更したりしないでください。実装が妥当な場合は、作業を続けず停止してハンドオフします。計画には $ralplan、実行には $ultragoal、$team、または executor を指定し、ユーザーが明示的にそのワークフローに切り替えた後でのみ再開します。

使用する場面

• ユーザーがベストプラクティス、推奨アプローチ、最新のガイダンス、公式の推奨事項、標準、またはバージョンを考慮した外部の動作を求めている場合。
• $ralplan、$deep-interview、$team、または他のワークフローが、計画や実行を正しく行うために現在の外部証拠を必要とする場合。
• 既に選択された技術に関わるタスクで、権威ある使用ガイダンス、移行メモ、API の動作、ライフサイクルのルール、または現在の安全性に関するガイダンスが必要な場合。

使用しない場面

• 回答がリポジトリ内のみで完結する場合。コードベースの事実には explore を使用します。
• 主な問いが依存関係を採用、置換、アップグレード、または比較すべきかどうかである場合。dependency-expert を使用します。
• ユーザーが、既に根拠のある要件に対する実装だけを必要としている場合。直接実行するか、調整された並列作業が妥当な場合は $team を使用します。
• 外部の最新情報を調べなくても、安定したローカルのプロジェクト規約から回答できるタスクの場合。

スペシャリストへの振り分け

1. ブラウンフィールドの事実については、まず explore を使用します。現在のコードの使用状況、ローカルの制約、バージョン、設定、統合ポイントを確認します。
2. 既に選択された技術について、公式/アップストリームのドキュメント、リリースノート、標準、移行ガイド、ソースに基づく例、現在のベストプラクティスの証拠には researcher を使用します。
3. 採用/アップグレード/置換/比較の判断にのみ dependency-expert を使用します。
4. 明示的な証拠、不確実性、および実装ハンドオフの制約を添えて呼び出し元に返します。

情報源の品質に関するルール

• 公式ドキュメント、アップストリームのソース、リリースノート、変更履歴、標準、メンテナーのガイダンスを優先します。
• 重要な主張には情報源の URL を含めます。
• 現在のベストプラクティスに関する主張には、日付とバージョンの文脈を明記します。
• サードパーティの要約は補足資料としてラベル付けし、公式/アップストリームの情報源より先に使用しないでください。
• 古い、矛盾する、文書化されていない、またはバージョンが一致しない証拠にはフラグを立てます。
• 過剰な取得をしないでください。判断を支えられる最小限の証拠セットを収集します。

ワークフロー

1. 問いを分類します。概念的なベストプラクティス、実装ガイダンス、移行/バージョンのガイダンス、標準/コンプライアンスのガイダンス、またはローカルと外部が混在するガイダンスのいずれかです。
2. ローカルの使用状況や制約が回答に影響する場合は、explore でリポジトリ内の事実を収集します。
3. 現在のまたはバージョンを考慮した実践が正しさに影響する場合は、researcher で外部の証拠を収集します。
4. 情報源の品質、バージョン/日付の文脈、注意点、そして実装または計画へのハンドオフを添えて、簡潔な回答にまとめます。
5. 呼び出し元にとって回答が十分に根拠づけられた時点で停止します。そうでなければ、正確な障害または必要なスペシャリストへのハンドオフを報告します。

出力の契約

## Best-Practice Research: <question>

### Direct Recommendation
<actionable guidance or decision support>

### Evidence Used
- Official/upstream: <source URL> — <what it establishes>
- Supplemental, if any: <source URL> — <why it is secondary>

### Version / Date Context
<versions, dates, release channels, or unknowns>

### Repo-Local Context
<facts from explore, or "not needed">

### Boundaries / Non-goals
<what this research does not decide>

### Handoff
<planning/execution/test implications; name the next workflow — `$ralplan` for planning, `$ultragoal`/`$team`/`executor` for execution — and note that this skill stops here unless the user explicitly switches workflows>

停止ルール

• 出典に基づく推奨事項を呼び出し元が再利用できる状態になったら、停止します。
• タスクが依存関係の比較、広範なアーキテクチャ、または実装に及ぶ場合は、停止して上位へ振り分けます。
• 残りの作業が推奨事項を変えず、文言を整えるだけの場合は、調査を続けません。
• このスキルは実装を行いません。推奨事項とハンドオフを提示した後は停止し、リポジトリのファイルやリポジトリの状態を変更しません。ハンドオフで指定された計画または実装のワークフローにユーザーが明示的に切り替えた場合にのみ再開します。

Task: {{ARGUMENTS}}