菜单
コードリーディングを3層フレームワーク（取得・処理・管理）で効率的に実行する。 コードの理解、調査、学習を求められた時に使用。複雑なケースではサブエージェント起動を推奨。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | code-reading |
| description | コードリーディングを3層フレームワーク（取得・処理・管理）で効率的に実行する。 コードの理解、調査、学習を求められた時に使用。複雑なケースではサブエージェント起動を推奨。 |
核心原則: 実装をむやみに精読しない。インターフェイスと役割の理解に集中し、読む箇所を極小化する。
IF 単純なケース（以下すべて該当）:
├─ 対象ファイル: 1-3個
├─ ゴール: 明確（特定の関数の動作確認など）
├─ 依存関係: 浅い
└─ → スキル内で完結（下記フローに従う）
IF 複雑なケース（以下いずれか該当）:
├─ 対象: 複数モジュール跨ぎ
├─ ゴール: 探索的（「どう動いているか全体像を把握」など）
├─ 依存関係: 深い・不明
└─ → サブエージェント（explore）を起動
┌─────────────────────────────────────────────────────────┐
│ Layer 1: 取得 (Acquisition) │
│ → どの情報を、どの順序で読むか │
├─────────────────────────────────────────────────────────┤
│ Layer 2: 処理 (Processing) │
│ → 読んだ情報をどう解釈・判断するか │
├─────────────────────────────────────────────────────────┤
│ Layer 3: 管理 (Management) │
│ → 理解した情報をどう記録・参照可能にするか │
└─────────────────────────────────────────────────────────┘
Q: 何を達成したいか？
├─ バグ修正 → 問題箇所の特定と原因理解
├─ 機能追加 → 拡張ポイントと依存関係の把握
├─ レビュー → 設計意図と実装品質の評価
├─ 学習 → パターンと設計思想の吸収
└─ 調査 → 特定の振る舞いの確認
出力: 1文でゴールを明文化（例: 「認証フローでトークン検証がどこで行われるかを特定する」）
| 優先度 | 対象 | 目的 |
|---|---|---|
| 1 | ファイル名・ディレクトリ構造 | 責務の推測 |
| 2 | 型定義・インターフェース | 契約の把握 |
| 3 | 公開API（export）の関数シグネチャ | 入出力の確認 |
| 4 | ドキュメント・コメント | 意図の理解 |
| 5 | テストコード | 期待される振る舞いの確認 |
| 6 | 実装の詳細 | 最後に、必要な箇所のみ |
understanding-record.md のテンプレートを使用
複雑なケースでは以下のプロンプトで explore サブエージェントを起動:
【ゴール】
{1文で明文化したゴール}
【対象範囲】
{ディレクトリパスまたはファイルパターン}
【探索の深さ】
{quick / medium / very thorough}
【期待する出力】
- 理解記録テンプレート形式で各モジュールを要約
- 依存関係図（テキストまたはMermaid）
- 発見した重要なパターンやハマりポイント
| シーン | 参照ファイル |
|---|---|
| ゴール定義・境界設定・取得順序 | acquisition.md |
| インターフェイス解析・判断基準 | processing.md |
| 記録戦略・情報階層化 | management.md |
| 理解記録テンプレート | understanding-record.md |
| パターン | 問題 | 対策 |
|---|---|---|
| 端から端まで精読 | 目的喪失、時間切れ | ゴール定義を最初に |
| 実装から設計を逆推理 | 非効率、誤解リスク | インターフェイスから入る |
| 図を描かず記憶で管理 | 認知負荷の肥大化 | 必ず可視化する |
日本語の文章で文と文のつながりを点検し、直前の文の不足、常識的な連続性、読者視点から論理のほころびを防ぐ。エッセイ、記事、レポート、解説文の執筆・推敲・レビューで使う。法的判断、数学的証明、事実確認のみ、文法校正のみ、意図的なシュール表現や断片的表現の矯正には使わない。
日本語の文章を、誇張、借り物の美辞麗句、過剰な謙遜を避け、実感に近い等身大な表現へ整える。エッセイ、プロフィール、商品説明、自己紹介、note、スピーチ、振り返り文の推敲で使う。法的文書、逐語訳、意図的に言葉を高める詩、学術的な出典確認、事実検証には使わない。
macOSのスクリーンショットを、screencaptureと補助CLIで取得する。画面全体、ウィンドウ指定、選択範囲、タイマー撮影、クリップボード保存に対応する。macOS上でエージェントが再現可能なパスへスクリーンショットを保存したい場合に使う。OCR、画像編集、動画収録、macOS以外のスクリーンショット取得には使わない。
文章、記事、レポート、企画書の論理破綻をレビューし、論点、必要情報、推論、結論と根拠の構造を確認する。Why So、So What、MECEの観点で飛躍、矛盾、論点ずれ、根拠不足を検出する。公開前や改稿前に文章の筋道を点検するときに使う。単なる校正、文体調整、事実確認のみ、法的助言、数学的証明の厳密検証には使わない。
UI 変更や状態遷移を伴う PR に、E2E テスト計画・操作後スクリーンショット・検証結果・検証データの副作用を確認エビデンスとして残す。 gh image で画像をアップロードし、Chrome DevTools MCP で画面を操作・撮影し、gh でテスト計画と結果を PR コメントへ投稿する際に使用。 「PR にスクショを貼る」「UI エビデンスを残す」「E2E 確認結果を PR にまとめる」「レビュー用に画面の証跡を添付」と依頼された時に適用。 内部ロジックのみの変更や、既存の自動テストで担保できる変更には使わない。コミット作成や PR 本体の作成フローには使わない。
WXTを使ったブラウザ拡張開発を支援する。プロジェクト調査、entrypoint設計、manifestと権限変更、content script UI、storage、messaging、build、zip、ブラウザ検証を扱う。WXTプロジェクトの作成、変更、監査、デバッグ時に使う。非WXT拡張、汎用フロントエンド、拡張ストア審査には使わない。