need-explorer について
仕様作成の前に、漠然としたアイデアを安定した変更定義へ整理するエージェントスキルです。順を追った質問、案の比較、範囲の確認を通じて、問題、境界、成功基準、変更を分割するかを明確にします。
主な機能
- 01既存の状況と制約を先に確認
- 02一度に一つの確認質問を行う
- 03適切な場合に選択肢を提示
- 04案とトレードオフを比較
- 05問題、範囲、対象外、成功基準を確認
- 06確認後に仕様作成へ引き継ぐ
活用シーン
- 01曖昧なアイデアを明確な変更定義に整理
- 02仕様作成前に範囲と対象外を定める
- 03依頼を複数の変更に分割するか判断
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/need-explorerを入力して読み込まれたか確認します。
詳細
Need Explorer
バンドルされたランタイム
以下の CLI 行を実行する前に、先頭の SSF を node "<plugin-root>/scripts/spec-superflow.mjs" に置き換えてください。<plugin-root> は、このファイルの 2 階層上にあるディレクトリの絶対パスです。SSF をそのまま実行したり、PATH 上の ssf を呼び出したりしないでください。
成果物を作成する前に、漠然としたアイデアを、安定した変更定義にまとめます。
主な目標
問題、スコープ、対象外事項、成功基準、仕様策定の前に分割するかどうかについて合意します。
プロセス
1. まずコンテキストを確認する
質問する前に、既存の内容と制約を把握します。
2. 質問は一度に1つ
明確な質問を1つだけして、回答を待ち、内容を消化してから次の質問をします。一度に3つ以上の質問をしてはいけません。それぞれの回答を次の質問に反映します。
3. 選択式の質問を優先する
回答の選択肢が限られている場合は、妥当な選択肢を2〜3個提示します。これにより認知的負荷を軽減し、見落としていた選択肢を明らかにできます。
4. トレードオフとともに2〜3個のアプローチを提案する
各アプローチについて、内容、利点、欠点、最適な用途を説明します。その後、1つを推奨し、その理由を説明します。単一の道筋だけを示してはいけません。必ず少なくとも1つの代替案を挙げてください。
5. 結論を出す前に確認する
聞いた内容を言い換えて確認します。「次のように理解しました。[問題、スコープ、対象外事項、成功基準]。この理解で合っていますか？」修正を反映し、再度確認します。
6. DP-1：要件確認ゲート
ユーザーが概要を確認した後：
SSF state set <change-dir> dp_1_result "confirmed: <one-line summary>"
SSF state set <change-dir> dp_1_timestamp now
DP-1 では、成果物を作成する前にスコープ、対象外事項、成功基準を確認します。
7. 引き継ぐ
DP-1 が記録されたら、spec-writer に引き継ぎます。
アンチパターン
- 探索を省略する：「簡単な」変更にもスコープがあります。5分間の探索で、2時間の手戻りを防げます。
- 明確化する前に解決策を提案する：ユーザーが「キャッシュを追加して」と言った場合、まずキャッシュでどのような問題を解決するのか尋ねます。
- 探索を延々と続ける：変更名、問題の説明、スコープ、対象外事項、成功基準、分割の判断がすべて明確になったら終了します。
探索の基準
探索を終える時点で、次の内容がそろっている必要があります。実用的な変更名、明確な問題の説明、スコープの境界、対象外事項、成功基準、分割の判断（1つの変更にするか、分割するか）。
重要なルール
実装コードを作成してはいけません。このスキルの目的は意図を安定させることであり、構築することではありません。
引き継ぎ前のセルフレビュー
- プレースホルダーの確認：「おそらく」、「たぶん」、「未定」、「後で考えます」がないこと
- 矛盾の確認：スコープの項目が対象外事項や制約と矛盾していないこと
- スコープの確認：開発者が対象範囲と対象外範囲を明確に区別できること
例外処理
- 解析エラー：該当するファイルを具体的に報告し、入手できた情報を使って進めます
- ファイルの欠落：不可欠なファイルがない場合は制約として記録し、そのまま進めます
- ユーザーによる中断：探索はステートレスです。再開時には、現在の質問をもう一度尋ねます