source-driven-development
作成者 addyosmanisource-driven-development スキルは、フレームワーク固有のコーディングを公式ドキュメントに基づいて進めるためのもので、実装前にパターンを確認できます。React、Vue、Next.js、Svelte、Angular などのスタックで、正確性、出典の明確さ、バージョン差に左右される判断が重要な場合に最適です。
このスキルは82/100で、出典付きかつドキュメントに根ざした実装ガイダンスを求めるディレクトリ利用者に十分有力な掲載候補です。リポジトリは、正確性が重要なフレームワーク固有のコーディングに対して導入を正当化できるだけの運用面の明確さがありますが、自動化されたツール連携型ではなく、ドキュメント主導のワークフローになる点は想定しておく必要があります。
- 用途の明確さが高く、説明文で「出典が明確なコードが重要なフレームワーク/ライブラリ作業」に使うべきだと明示している。
- 運用指針がしっかりしており、SKILL.md で DETECT → FETCH → IMPLEMENT → CITE の手順を段階的に示し、使わない場面も定義している。
- 導入判断の材料として優秀で、リポジトリは十分な規模があり（7.8k 本文、複数の見出し、プレースホルダー記号なし）、古い記憶頼みの実装ミスを減らすことに焦点を当てている。
- サポート用のファイルやスクリプトは含まれていないため、実行は同梱ワークフローではなく記載された手順に全面的に依存する。
- 対象は広くドキュメント中心なので、速度重視の用途や一般的なロジック処理を求めるユーザーには不要、あるいは過剰に感じられる可能性がある。
source-driven-development スキルの概要
source-driven-development ができること
source-driven-development スキルは、まず公式ドキュメントを確認し、その内容を根拠として参照または実装に反映しながら、フレームワーク固有のコードを書くためのスキルです。いわゆる「たぶん合っている」では困る場面、たとえばスターターコード、繰り返し使うアプリの定番パターン、アップグレード対応、フレームワークのバージョンによって正解が変わる機能に向いています。
どんな人に向いているか
source-driven-development skill は、React、Vue、Next.js、Svelte、Angular などで開発していて、古い実装パターンを減らしたい人に適しています。特に、フォーム、ルーティング、認証、状態管理、データ取得、プロジェクトのひな形生成といったコードをエージェントに書かせる用途で有効です。
通常のプロンプトと何が違うのか
一般的なプロンプトでも、学習データに基づいてそれらしいコードは生成できます。ただし source-driven-development は、スタックを特定し、公式ソースを確認し、その内容に沿って実装するという「先に検証する」流れへワークフローを寄せます。結果として、本番向けの作業、バージョン依存の強い API、出典や根拠を示したいコードレビューの場面で使いやすくなります。
source-driven-development スキルの使い方
エージェント環境に source-driven-development を導入する
スキル用リポジトリの通常のインストール手順に従って導入し、コード生成を依頼する前に source-driven-development をエージェントのコンテキストへ読み込ませます。典型的な source-driven-development install では、リポジトリのスキル管理コマンドを実行したうえで、エージェントが意図された手順に従えるよう、スキル本体のファイルも読み込む形になります。
タスクを「ソース先行」のプロンプトに変える
source-driven-development をうまく使うには、フレームワーク名、わかるならバージョン、ランタイム、そして達成したいゴールを明確に伝えるのが重要です。強い入力の例は、「Use source-driven-development to add a protected dashboard route in Next.js App Router 15, using official docs only, and explain the source for each pattern.」のような形です。逆に「build auth」だけでは弱すぎます。スタックと機能を具体的にするほど、エージェントの推測に頼る余地が減ります。
先に読むべきファイルを押さえる
最初に SKILL.md を読み、その後でスキルが参照しているリンク先のドキュメント、サンプル、リポジトリ内の注記を確認します。このリポジトリには追いかけるべき補助フォルダはないため、要点は SKILL.md のプロセスを丁寧にたどり、それを対象アプリ側のコーディング規約や構成に落とし込むことです。
出力品質を上げるワークフロー
4 段階のループで進めると安定します。まずスタックとバージョンを特定し、次に公式ドキュメントを取得し、その内容に沿った最小限で正しい実装を行い、最後に仕上がりがまだドキュメントと一致しているかを検証します。コード生成を依頼する場合は、既存のフォルダ構成、package manager、framework mode、引用をコメントで残すのか別説明にするのか、といった制約もあわせて渡してください。そこまで指定すると、実装のズレが起きにくくなります。
source-driven-development スキル FAQ
source-driven-development は大規模フレームワーク専用？
いいえ。source-driven-development guide が特に力を発揮するのは、API の変化が早い場合や、競合する実装パターンが複数ある場合です。これは最近のフレームワークやライブラリではよくある状況です。一方で、単なる文言修正や、フレームワークのバージョンに依存しないロジックには、そこまで大きな効果はありません。
普通のコード生成プロンプトの代わりに使うべき？
正確さと追跡可能性を、スピードより優先したいときに使うのが適切です。シンプルでバージョン非依存の修正なら通常のプロンプトでも十分ですが、最新の公式ドキュメントを根拠に説明できるコードがほしいなら、source-driven-development for Code Generation の進め方のほうが向いています。
初心者でも使いやすい？
はい。フレームワーク名を挙げられて、実装したい機能を説明できるなら使いやすいです。初心者にとっては、実装パターンを勘で選ぶ必要が減るのが利点です。ただし、アプリのスタックと目標の挙動はきちんと渡す必要があります。そこが曖昧だと、エージェントが誤ったドキュメントを検証してしまう可能性があります。
向いていないケースは？
ごく小さな修正、純粋なロジック処理、あるいはユーザーが「検証は不要なので最速で答えてほしい」と明示しているケースには向きません。タスクが特定フレームワークのバージョンに依存していないなら、追加のソース確認は工数だけ増えて、得られる価値はあまり大きくならないことが多いです。
source-driven-development スキルを改善するには
エージェントに渡すソース対象をもっと具体的にする
最も効果が大きいのは、フレームワーク、バージョン、機能を正確に指定することです。たとえば「Next.js stuff」ではなく、「official Next.js App Router docs for server actions」と伝えるほうが有効です。対象が明確なほど、誤ったソースを参照するリスクが減り、最終的なコードの精度も上がります。
出力条件は最初に明示する
引用が必要なら、その形式まで伝えましょう。たとえば inline comments、短い source note、簡潔な実装サマリーなどです。あわせて、既存の型、file names、UI behavior など、変えてはいけないものも先に指定してください。そうすることで、source-driven-development の流れを保ったまま、コードベースを過剰に書き換えるのを防げます。
source-driven-development で起こりやすい失敗を把握する
主なリスクは、誤ったバージョンのドキュメントを使うこと、複数リリースのパターンを混在させること、チュートリアルの例に実装を引っ張られすぎることです。最初の回答が汎用的すぎると感じたら、公式ドキュメントを再確認するよう依頼し、自分のスタックにぴったり合う範囲まで解決策を絞り込ませるのが有効です。
推測ではなくソース起点で改善を重ねる
最初の結果が惜しいけれど理想には届いていない場合は、検証済みの部分は維持したまま、不足している挙動だけを調整する 2 回目の提案を依頼しましょう。source-driven-development では、「スタックを明確にする → ソースを確認する → 1 回につき 1 点ずつ具体的に実装を調整する」という改善ループが、いちばん安定して精度を高めやすい進め方です。