zoom-out

Zoom Out

不慣れなコードセクションを、より高い視点からアーキテクチャとして把握します。

上流の状況

mattpocock/skills の上流では削除されています（実際には使われていません）。ここでは、アーキテクチャを俯瞰するためのエントリーポイントとして保持しています。

このスキルを使う場面

• 不慣れなコードを調べていて、システム全体の中でどのようにつながっているか把握したい場合
• 変更を加える前に、影響範囲を理解したい場合
• 実装に踏み込む前に、モジュールのマップが必要な場合

このスキルを使わない場面

• 特定のシンボルやパターンを見つける場合 → codebase-search を使います
• アーキテクチャの改善機会を探す場合 → improve-codebase-architecture を使います
• 特定の障害をデバッグする場合 → debugging を使います

俯瞰によって得られるもの

以下を示す構造マップです。

• 関心のある領域に関連するすべてのモジュール
• 呼び出し関係（何が何を呼び出すか）
• 主な依存関係（何が何に依存しているか）
• CONTEXT.md のドメイン用語をモジュール名に適用したもの

使い方

不慣れなコードに遭遇したら、詳細に踏み込む前に俯瞰を依頼します。

「[module/component] がシステムの中でどのように位置づけられているか、全体像を示してください。」

プロジェクトの内部実装名ではなく、プロジェクトのドメイン用語集を使って、関連するモジュールがマッピングされます。

出力形式

[Module A] → calls → [Module B], [Module C]
[Module B] ← called by → [Module A], [Module D]

Key seams:
- [Interface X] separates [Domain Concept 1] from [Domain Concept 2]
- [Interface Y] is where [Domain Concept 3] behavior can be swapped

Domain terms in use here:
- "Order" = [what it means in this context]
- "Customer" = [what it means in this context]

呼び出しに関する注意

このスキルでは disable-model-invocation: true を設定しています。これは、独立した処理ユニットではなく、エージェントの応答方法を指示するディレクティブフレームワークです。コードを調査するときは、振る舞いを指示するディレクティブとして呼び出してください。

指示

1. タスクのトリガーと期待される出力を特定します。
2. このスキルのワークフロー手順に上から順に従います。
3. 次のステップに進む前に、出力を検証します。
4. 手順が失敗した場合は、障害となった要因と代替手段を記録します。

例

• 例：まず小さな範囲にこのスキルを適用し、検証に合格したら全体に拡大します。

ベストプラクティス

• 出力の決定性と監査可能性を保ちます。
• 広範囲でリスクの高い編集より、小規模で元に戻せる変更を優先します。
• 前提条件を明示的に記録します。

参考資料

• プロジェクト標準：.agent-skills/skill-standardization/SKILL.md
• バリデータースクリプト：.agent-skills/skill-standardization/scripts/validate_skill.sh