zoom-out について
zoom-outは、複数の探索役が異なる観点を並行して調べ、結果を統合して未知のコード領域を把握するスキルです。未知のサブシステムや他者の作業を引き継ぐ人に向いています。
主な機能
- 01観点別の並行調査
- 02コード構造と依存関係の把握
- 03文書と意思決定履歴の調査
- 04用語とドメイン概念の整理
- 05全体像マップへの統合
活用シーン
- 01未知のサブシステムの把握
- 02他者の作業の引き継ぎ
- 03領域の概要を求める依頼への対応
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/zoom-outを入力して読み込まれたか確認します。
詳細
全体像を把握する
まだ読み込まれていない場合は、/creative-writing-skills:qi-layer を読み込んでください。
不慣れな領域を把握するには、異なる視点を担当する探索役を並行して複数起動し、それぞれの報告を統合して全体像をまとめます。探索役が一人だと一つの側面しか見えませんが、全体像を把握する方法なら、構造と知識と歴史を同時に捉えられるため、ひとつの視点に偏りません。
不慣れなサブシステムに取り組み始めるとき、他の人の作業を引き継ぐとき、またはユーザーが「全体像を教えて」や「この領域の概要は？」と言ったときに使います。
視点を分担する
その領域に資料がある視点を選び、それぞれ一つの視点と一つの問いに絞って、並行して探索役を起動します。
- 構造（
@explorer）：領域の各部分がどうつながっているか、振る舞いがどこにあるか。コードの場合は、呼び出し元、依存関係、モジュール境界、エントリーポイント。 - 文書化された知識（ナレッジベースを調べる
@explorer）：アーキテクチャ、ガイド、統合された調査結果など、この領域について書かれた内容。 - 意思決定の履歴（
@session-miner）：現在の形になった理由。過去の選択、却下された代替案、判明した制約。 - ドメインの概念（
@explorer）：使われている用語（KB の用語集ページ、.context/CONTEXT.md、AGENTS.md）。
各探索役には、具体的なパスやトピックを指定して、ひとつの視点だけを担当させます。それぞれ独立して調査することで、異なる側面をカバーできます。
統合する
報告を読み、単なる寄せ集めではなく、ひとつの全体像をまとめます。
- これは何か：領域の目的と境界を、2〜3文で説明します。
- 構造：重要な部分やインターフェース、それらのつながりを説明します。構造を図で示すのが適切なら、mermaid 図を使います。
- なぜこの形なのか：現在の構造を説明する決定や制約をまとめます。
- 用語：正確に話すために必要な用語を示します。
- 未解決の点：探索役が見つけた不足、技術的負債、未解決の疑問を挙げます。
報告の内容が矛盾している場合は、両方を並べるのではなく、それぞれの情報源が何を示すかに基づいて解決します。対象そのもの（コード、データ、原稿）は現在の状態を示し、確定した決定は意図を示します。文書が現在の状態を誤って説明している場合は、古くなっていると注記します。現在の状態と確定した意図に隔たりがある場合は、その乖離を報告します。全体像は簡潔にまとめます。目的は、読者がその領域を自力で把握できるようにすることであり、すべてを逐語的に記録することではありません。