deep-explain

npx skills add majiayu000/claude-skill-registry --skill deep-explain --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# deep-explain > **一言**: 分からないことに対して `/deep-explain X` 一行で構造化された深層分析を受け取り、`docs/explain/`に自動保存される。 --- ## 核心原則 1. **自動検出**: 対象タイプを自動で判別して適切なコンテキストソースを探索 2. **一貫した構造**: 常に同じ6セクション構造で出力（スキップ禁止） 3. **読み取り専用**: コード変更なし。分析と説明のみ実行（docs/explain/保存を除く） 4. **コンテキスト優先**: 一般知識よりプロジェクト内の実際のファイルベース分析を優先 5. **視覚化**: 複雑なワークフロー/依存関係は`diagram-generator`エージェントでダイアグラム生成 6. **デフォルト保存**: 分析結果は常に`docs/explain/`に保存（`--no-save`で無効化） --- ## EXECUTION PROTOCOL (LIGHT) > このスキルは読み取り専用なので軽量プロトコルを適用する。 ### Pre-flight (必須) スキル実行時に必ず以下のチェックリストを出力して確認する。 ``` Pre-flight Checklist ├─ [ ] 分析対象識別: {target} ├─ [ ] 対象タイプ決定: {skill | feature | oss | library | general} ├─ [ ] コンテキストソース確認: {source_files} └─ [ ] --no-save 有無: {yes | no} ``` ### Model Routing | 作業 | モデル | 理由 | | --------------------------------- | ------ | -------------------------------- | | コンテキスト探索 (Glob/Grep/Read) | Haiku | 単純なファイル探索、トークン節約 | | 分析および出力生成 | Sonnet | 構造化された分析品質保証 | ### ダイアグラム生成 分析対象が**ダイアグラム生成条件**に該当すれば`diagram-generator`エージェントを呼び出して視覚的ダイアグラム(.drawio + .svg)を一緒に生成する。（`--no-save`時にはダイアグラムを生成せずテキスト/ASCIIで表現） **ダイアグラム生成条件**（1つ以上満たす時）: | 条件 | 例 | ダイアグラムタイプ | | ------------------------------------------------ | ---------------------------------