菜单
Claude Codeの拡張機構（CLAUDE.md / Skills / MCP）の使い分けガイド。 「CLAUDE.mdに書くべき？skillにすべき？」「MCPとskillの違いは？」「拡張したいけどどれで作る？」 「.claude/commandsと.claude/skillsの違い」「MCP serverはいつ使う？」 「常時適用ルールはどこに書く？」「コンテキスト効率を上げたい」などの判断に使う。 Claude Code自体の拡張設計の相談・レビュー時にも自動検出される。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/lilpacy/dotfiles --skill cc-extensibility-guide命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Compare an installed package, its release archive, and its source repository; distinguish source drift from runtime state; and backport verified installed-only fixes. Use when installed files or a ZIP were edited directly, or when the repository may be stale.
Maintain product, architecture, design, API, data, and operational documentation in an established repository. Use when deciding whether to edit an existing source of truth or add a document, separating current-state contracts from implementation plans, keeping volatile repository facts and technical debt out of reusable agent skills, moving content out of change-named documents, or reviewing documentation scope and placement.
Design, implement, and review CI test-result parsers, PR comments, job summaries, artifacts, and required checks. Use when cancelled or timed-out runs are misreported as test failures, setup/global errors disappear because zero tests ran, diagnostics may expose stacks or payloads, or workflow provenance limits what a run actually validates.
正在显示 SKILL.md
基于 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 |