openspec-explore について
openspec-explore は、変更を正式化する前に、不明確な要件を調べ、案を比較し、コードベースを探索するスキルです。成果物を作らず会話で検討し、方向性が定まったら OpenSpec の変更計画へ移行できます。
主な機能
- 01/opsx:explore でアイデアを検討
- 02コードベースや問題を調査
- 03案を比較して要件を明確化
- 04探索中に図を作成
- 05正式な変更計画へ移行
活用シーン
- 01変更提案の前に要件を明確化
- 02方針を決める前に解決策を比較
- 03コードベースの改善点を探す
- 04計画成果物を作らずにブレインストーミング
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ partme-ai/ openspec-skills --skill openspec-exploreインストール後、Claude Code で/openspec-exploreを入力して読み込まれたか確認します。
詳細
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 対応