메뉴
Claude Codeの拡張機構（CLAUDE.md / Skills / MCP）の使い分けガイド。 「CLAUDE.mdに書くべき？skillにすべき？」「MCPとskillの違いは？」「拡張したいけどどれで作る？」 「.claude/commandsと.claude/skillsの違い」「MCP serverはいつ使う？」 「常時適用ルールはどこに書く？」「コンテキスト効率を上げたい」などの判断に使う。 Claude Code自体の拡張設計の相談・レビュー時にも自動検出される。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | cc-extensibility-guide |
| description | Claude Codeの拡張機構（CLAUDE.md / Skills / MCP）の使い分けガイド。 「CLAUDE.mdに書くべき？skillにすべき？」「MCPとskillの違いは？」「拡張したいけどどれで作る？」 「.claude/commandsと.claude/skillsの違い」「MCP serverはいつ使う？」 「常時適用ルールはどこに書く？」「コンテキスト効率を上げたい」などの判断に使う。 Claude Code自体の拡張設計の相談・レビュー時にも自動検出される。 |
CLAUDE.md（基盤知識層・常時読み込み）
→ Skills/Commands（手順・タスク層・オンデマンド）
→ MCP（外部接続層・ステートフル通信）
ここが最も混乱しやすいポイント。どちらも「Claudeに知識を与える」点は同じ。
CLAUDE.mdにあらゆる知識を詰め込むとコンテキストを無駄に消費する。特定場面でしか使わない知識はSkillに分離する。
CLAUDE.mdが大きくなったら .claude/rules/*.md でトピック別に分割可能（paths frontmatterで適用範囲も絞れる）。
| 機能 | CLAUDE.md | Skills | MCP |
|---|---|---|---|
| 常時読み込み | o | x（オンデマンド） | x（ツール定義のみ常時） |
手動呼び出し (/name) | x | o | x |
| Claude自動検出・呼び出し | 不要（常時） | o | o（ツールとして） |
| 支援ファイル (templates等) | x（rules/で分割のみ） | o | x |
サブエージェント実行 (context: fork) | x | o | x |
| 外部API/DB/サービス通信 | x | x | o |
| ステートフル接続 | x | x | o |
| 認証 (OAuth等) | x | x | o |
常に適用したいルール？ → Yes → CLAUDE.md / rules
↓ No
外部通信が必要？ → Yes → MCP Server
↓ No
複数参照ファイル or 自動検出 or サブエージェント分離？ → Yes → Skill
↓ No
新規作成？ → Skill（Commandsより常にSkillを選ぶ）
既存Commands？ → そのまま動く。移行は必要になった時でよい
3層は排他ではなく補完関係。
| ユースケース | CLAUDE.md | Skill | MCP |
|---|---|---|---|
| Figmaデザイン実装 | React規約・命名規則 | /implement-design（変換手順） | figma-remote-mcp（API） |
| コードレビュー+コミット | テスト方針・lint設定 | /claude-review（レビュー観点） | 不要 |
| 画像生成 | — | /nanobanana-prompt-writer（プロンプト知識） | nanobanana（Gemini API） |
| 状況 | 選択 |
|---|---|
| 全セッションで常に適用したいルール・知識 | CLAUDE.md |
| 外部サービスとの通信が必要 | MCP |
| 特定の作業文脈での知識・手順 + 自動検出 | Skill |
| 単純な定型手順（既存） | Command（そのまま） |
| 新規作成 | 常にSkill |
Use by any agent before writing specs, editing code, or changing workflow files when the change could add compatibility behavior, aliases, silent fallbacks, or default-value fallbacks.
Use before presenting implementation plans and after non-trivial commits when the review should run through Claude Code with the configured Fable model. Runs claude -p in streaming review mode, derives the Fable model from claude/settings.json, constrains tools for read-only review plus currentness checks, handles resume, and defines review timeout semantics.
Use when committing, pushing, or preparing PRs. Defines the user's commit workflow, message style discovery, review handoff, and branch/worktree push requirements.
Linearのissueを整理し、会話しながら新規issueに落とすスキル。2つのモードを持つ: (1) 既存issue整理: Backlogの全issueをINVEST原則で診断し、分割・統合・再分類を提案・実行 (2) 会話→issue化: ユーザーとの対話から要件を引き出し、適切な粒度のissueに落とす 両モード完了後、整理された実行計画を自動生成する。 トリガー: 「issueを整理して」「Backlog整理」「issue棚卸し」「やること整理」「実行計画を作って」 「issueの粒度を揃えて」「issueに落として」「要件をissueにして」
Use before presenting implementation plans and after non-trivial commits that require review. Runs codex exec in read-only review mode, handles resume, MCP transport errors, and review timeout semantics.
Use for code implementation, bug fixes, refactors, and test additions. Enforces the user's development style: YAGNI, TDD, clear contracts, separation of concerns, no unsolicited fallback or backward-compatibility helpers, and maintainable code structure.