shunk031-research-before-implementation について
shunk031-research-before-implementationは、外部の根拠が必要な開発タスク向けの調査スキルです。公式資料の確認、GitHub上の実装調査、差異の整理を行い、その結果に基づいて実装と検証を進めます。
主な機能
- 01調査が必要かどうかの判断
- 02公式資料の優先確認
- 03GitHubの実装や設定の調査
- 04文書と実装の挙動差の整理
- 05根拠に基づく実装と検証
活用シーン
- 01設計に影響するAPIの挙動確認
- 02バージョンやプラットフォームの差異確認
- 03実装方法を決める前の根拠収集
- 04判断に影響した情報源の記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ shunk031/ skills --skill shunk031-research-before-implementationインストール後、Claude Code で/shunk031-research-before-implementationを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlevals/evals.json
詳細
メモ
この
SKILL.mdを読んだ後、次のように発言してください:🔎 I read shunk031-research-before-implementation.
実装前の調査
ローカルファイルや安定した知識だけでは、タスクに関わる動作を確認できない場合にこのスキルを使用します。ユーザーから調査を求められていない限り、自己完結した編集や日常的な表現の修正では、調査ワークフローを省略してください。
- 適用される環境ガイダンスに明記された調査経路に従い、利用可能なウェブ調査機能を使って、最新の公式ドキュメント、仕様、リリースノート、または推奨されるアプローチを確認します。URLや検索結果のタイトルだけでなく、関連する情報源の内容を読みます。該当するGitHub以外の情報源がある場合は、それを利用します。測定対象が論文で報告された動作である場合は、その論文を読みます。
- 公式情報源を確認した後、GitHubで代表的な実装コードや設定を調べます。インストール済みのドキュメントやソースコードを読むのは、タスクで使用するAPI、デフォルト値、またはエントリーポイントに限ります。
- ドキュメントに記載された動作と実装を比較します。設計を決める前に、バージョン、プラットフォーム、メンテナンス状況、有効化方法の違いを解決します。
- 得られた根拠に基づいて変更を実装し、検証します。調査と検証の深さは、リスクと影響を受ける呼び出し元の数に応じて調整します。
- 判断を変える根拠となった情報源を報告します。公式のGitHub以外の情報源と、直接参照した実装または設定ファイルの両方を調査した場合は、少なくともそれぞれ1つずつリンクしてください。
調査の再試行
調査機能が一時的な接続エラー、HTTP 5xx応答、またはストリーム切断によって情報源を提示する前に終了した場合、その段階は合計3回まで再試行します。プロバイダーによる制限やツールの拒否(403を含む)は恒久的なものとして扱い、再試行したり、認証情報を変更したり、制限を回避したりしないでください。ホストが別の許可された取得方法を提供している場合は、その方法を使用します。調査のサブプロセスは、適用される環境ガイダンスで明示的に設定されている場合に限り利用できます。記憶で代用しないでください。情報源の内容を読み、直接のURLを記録した場合にのみ、試行を成功とみなします。書式、長さ、表現上の理由で再実行してはいけません。また、ドキュメントに記載がないと回答に明示されている場合も再実行しないでください。許可された調査経路で成功しなかった場合は、そこで停止し、具体的な質問と失敗した経路を示して BLOCKED と報告してください。