deep-dive について
deep-diveは、コードベースの調査と解決策の検討を段階的に行うスキルです。調査段階では提案を避けて事実を記録し、別の創案段階で複数の案とトレードオフを比較します。
主な機能
- 01コードと依存関係の分析
- 02調査結果の記録
- 03調査とブレインストーミングの分離
- 04複数の解決案の比較
- 05創案段階で単一案を押し付けない
活用シーン
- 01コードベース調査の記録
- 02調査後の代替案の検討
- 03事実確認と解決策設計の切り分け
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ okou-ai/ okou-skills --skill deep-diveインストール後、Claude Code で/deep-diveを入力して読み込まれたか確認します。
詳細
操作:deep research
使用方法: deep research [task description]
情報収集フェーズです。解決策を提案せずに、コードベースを分析します。
制約事項
許可される操作:
- ファイルとコードの読み取り
- 確認の質問
- コード構造とアーキテクチャの理解
- 依存関係と制約の分析
- 調査結果の記録
禁止される操作:
- 提案や推奨
- 実装のアイデア
- 計画やロードマップ
- 行動を促すあらゆる示唆
ワークフロー
- 確認 - 範囲を把握するために質問する
- 調査 - 関連するコードを体系的に分析する
- 記録 - 調査結果を
deep-dive/{task-name}/research.mdに記録する - 完了 - 事実のみで調査結果を要約し、次に何をするか尋ねる
research.md の構成
# Research: {task-name}
## Scope
What was investigated and why.
## Findings
### Architecture
- Current structure and patterns observed
### Dependencies
- Libraries, services, and internal modules involved
### Constraints
- Technical limitations, compatibility requirements
### Data Flow
- How data moves through the relevant components
## Open Questions
- Unresolved items that need clarification
操作:deep innovate
使用方法: deep innovate [task description]
創造的なブレインストーミングのフェーズです。調査結果に基づいて、複数のアプローチを検討します。
前提条件
調査ドキュメントが deep-dive/{task-name}/research.md に存在している必要があります。
制約事項
許可される操作:
- 複数の解決策のアイデアについて議論する
- メリットとデメリットを評価する
- アーキテクチャの代替案を検討する
- 技術戦略を比較する
- トレードオフを検討する
禁止される操作:
- 具体的な手順を含む計画
- 実装の詳細や疑似コード
- 単一の解決策への決定
- ファイルごとの変更仕様
ワークフロー
- 確認 - 調査ドキュメントを読み、主な調査結果を要約する
- 検討 - 異なる解決策のアプローチを2~3案作成する
- 分析 - 各案のメリット、デメリット、トレードオフを記録する
- 記録 -
deep-dive/{task-name}/innovate.mdを作成する - 議論 - アプローチを提示し、ユーザーからフィードバックを得る
innovate.md の構成
各アプローチについて、以下を記録します。
# Innovation: {task-name}
## Research Summary
Key findings from the research phase.
## Approach A: {name}
### Core Concept
Philosophy and high-level idea.
### Advantages
- ...
### Challenges / Risks
- ...
### Compatibility
How it fits with existing architecture.
### Scalability & Maintainability
Long-term considerations.
## Approach B: {name}
(same structure)
## Approach C: {name}
(same structure)
## Comparison Matrix
| Criterion | Approach A | Approach B | Approach C |
|------------------|------------|------------|------------|
| Complexity | | | |
| Risk | | | |
| Time to deliver | | | |
| Maintainability | | | |
## Next Steps
Awaiting user decision before proceeding.
コメント
Markdown 対応