openspec-explore について
OpenSpec Explore Skillは、要件がまだ不明確な段階で、対話を通じて問題を調べ、案を比較し、コードベースを探索するスキルです。ファイルや固定の構成は作らず、考えがまとまった後に正式な変更計画へ移れます。
主な機能
- 01対話によるトピックの探索
- 02コード分析とアプローチの比較
- 03質問への回答とアイデアの整理
- 04探索中にファイルを作成しない
- 05正式な変更計画への移行
活用シーン
- 01不明確な要件の整理
- 02選択前の複数アプローチの比較
- 03コードベースの改善点の探索
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ full-stack-skills/ openspec-skills --skill openspec-exploreインストール後、Claude Code で/openspec-exploreを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
OpenSpec 探索スキル
アイデアを検討したり、問題を調査したり、選択肢を比較したり、要件を明確にしたりするときは、/opsx:explore を使います。成果物を作成したり、構成を決めたりする必要はありません。知見がまとまったら、openspec-new または openspec-ff に移行します。
使用するタイミング
- 要件が不明確で、ユーザーがまず調査したい場合。
- 1つに決める前に、複数のアプローチを比較する場合。
- ユーザーが改善の機会を探すためにコードベースを調査したい場合。
- 正式な変更提案を作成する前にブレインストーミングを行う場合。
前提条件
- プロジェクトで OpenSpec が初期化済み であること(openspec-initial を参照)。
ワークフロー
-
調査を開始する
/opsx:exploreまたは/opsx:explore [topic]を実行します。- エージェントが、構成を必要としない探索的な会話を開始します。
-
調査する
- コードベースを分析し、選択肢を比較し、図を作成し、質問に回答します。
- 探索中に成果物は作成されません。これは純粋な思考のための作業です。
-
準備ができたら移行する
- ユーザーの考えがまとまったら、正式な変更を開始するために
/opsx:new <change-name>を提案します。 - または、計画に必要な成果物を一度にすべて作成したい場合は、
/opsx:ff <change-name>を提案します。
- ユーザーの考えがまとまったら、正式な変更を開始するために
出力
- 成果物やファイルは作成されません。出力は会話そのもの、つまり知見、選択肢、推奨事項です。
次のステップ
- 作業を始める準備ができたら、変更を開始するには openspec-new を、計画を一気に進めるには openspec-ff を使います。
トラブルシューティング
- 「コマンドが認識されない」:OpenSpec が初期化されていることを確認してください(
openspec init)。openspec-initial を参照してください。
参考資料
コメント
Markdown 対応