claude-code-mastery

Claude Code の習熟

Claude Code CLI 向けのエキスパートスキルです。CLAUDE.md の最適化、スキルの作成、サブエージェントの作成、フックの自動化、コンテキストエンジニアリングに対応します。

キーワード： claude-code、claude-cli、CLAUDE.md、skill-authoring、subagents、hooks、context-window、token-budget、MCP-servers、worktrees、permission-modes、prompt-engineering、context-engineering、slash-commands

主な機能

• CLAUDE.md の最適化 — トークン効率を高めるため、設定ファイルを監査、再構成、圧縮、階層化します。
• スキルの作成 — 正しいレイアウトとフロントマターを備えた、見つけやすいスキルパッケージをひな形から作成します。
• サブエージェントの作成 — tools の許可リストと Markdown 本文のシステムプロンプトを含む .claude/agents/<name>.md ファイルを作成します。
• フックの自動化 — .claude/settings.json を介して、PreToolUse／PostToolUse／Stop のライフサイクルスクリプトを接続します。
• コンテキストエンジニアリング — コードベース全体のコンテキストウィンドウのトークン予算を測定、管理します。

使用する場面

• あらゆるプロジェクトの CLAUDE.md ファイルを作成、構成、最適化する場合。
• 新しいスキルパッケージのひな形を作成する場合や、Claude Code のサブエージェントを作成する場合。
• 品質、セキュリティ、ワークフローの各ステップを自動化するフックを設定する場合。
• コンテキストウィンドウの消費量を監査、削減する場合。

最初に確認すること

ひな形の作成や最適化を始める前に、次の入力を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• タスク — 新しいスキルのひな形作成、CLAUDE.md の最適化、サブエージェントの作成、コンテキスト予算の分析のいずれか（skill_scaffolder.py、claudemd_optimizer.py、context_analyzer.py のどれを使うかが決まります）
• 対象の情報 — 新しいスキルの場合は名前、分野、1 行の説明。最適化の場合はファイルまたはプロジェクトのパス（スクリプトで必要な入力です）
• トークン予算 — 上限値（--token-limit の設定と、予算超過の判定基準に使います）

中断ルール：出力に最も影響する 2～3 項目だけを質問してください。ユーザーが「とにかく下書きを作って」と言った場合は、作業を進め、成果物の冒頭に前提を列挙してください。

クイックスタート

# Scaffold a new skill package
python scripts/skill_scaffolder.py my-new-skill --domain engineering --description "Brief description"

# Analyze and optimize an existing CLAUDE.md
python scripts/claudemd_optimizer.py path/to/CLAUDE.md

# Estimate context window usage across a project
python scripts/context_analyzer.py /path/to/project

# All tools support JSON output
python scripts/claudemd_optimizer.py CLAUDE.md --json

ツール

ツール	用途	コマンド
skill_scaffolder.py	正しい構成とフロントマターを備えた新しいスキルパッケージのひな形を作成します	python scripts/skill_scaffolder.py my-skill -d engineering --description "Does X"
claudemd_optimizer.py	CLAUDE.md の構成、トークン数、冗長性を評価し、改善案を提示します	python scripts/claudemd_optimizer.py CLAUDE.md --token-limit 4000
context_analyzer.py	ファイルのカテゴリ別にコンテキストウィンドウの消費量を推定し、予算の内訳を提示します	python scripts/context_analyzer.py /path/to/project --max-depth 4

すべてのツールは --json に対応しています。パラメーターの一覧と出力形式については、references/tool-reference.md を参照してください。

参考資料

タスクに合った参考資料を読み込みます。このファイルは簡潔に保ち、必要に応じて詳細を参照してください。

• references/workflows.md — 番号付きの5つの手順ガイド：CLAUDE.md の最適化、スキルの作成、サブエージェントの作成、フックの設定、コンテキスト予算の管理。これらのタスクを手順に沿って実行するときに読みます。
• references/quick-reference.md — スラッシュコマンド、権限モード、CLAUDE.md の読み込み順序、MCP サーバー、トラブルシューティング表、成功基準を記載しています。概要をすばやく確認するときや、設定の問題をデバッグするときに読みます。
• references/tool-reference.md — 3つの Python ツールの全パラメータ表と出力形式を記載しています。ツールをスクリプトから操作するときや、JSON 出力を解釈するときに読みます。
• references/skill-authoring-guide.md — YAML フロントマターから構成まで、効果的なスキルの作成に関する包括的なリファレンスです。スキルを詳しく作成するときに読みます。
• references/subagent-patterns.md — 並列作業や範囲を限定したタスクに向けた、サブエージェントの作成と使用に関するガイドです。サブエージェントを設計するときに読みます。
• references/hooks-cookbook.md — コード品質、セキュリティの適用、ワークフロー自動化に役立つ実践的なフックのレシピです。フックを作成するときに読みます。

テンプレート： assets/skill-template.md, assets/agent-template.md

対象範囲と制限事項

このスキルの対象：

• あらゆるプロジェクトを対象とした CLAUDE.md ファイルの作成、構成、最適化
• 正しいディレクトリ構成とフロントマターを備えた新しいスキルパッケージのひな形の作成
• スコープを限定したツールアクセスによる Claude Code サブエージェントの作成と設定
• コードベース全体におけるコンテキストウィンドウのトークン予算の分析と管理

このスキルの対象外：

• アプリケーションのソースコードの作成やビジネスロジックの実装（senior-fullstack、senior-backendを参照）
• MCP サーバーの開発やカスタムトランスポートプロトコル（mcp-server-builderを参照）
• LLM アプリケーション向けの高度なプロンプトエンジニアリング手法（senior-prompt-engineerを参照）
• CI/CD パイプラインの設定やデプロイ自動化（senior-devops、ci-cd-pipeline-builderを参照）

連携ポイント

スキル	連携内容	データフロー
senior-architect	アーキテクチャの決定が CLAUDE.md の構成セクションに反映されます	アーキテクチャ図とパターンが、CLAUDE.md の「アーキテクチャ概要」セクションに反映されます
code-reviewer	自動コードレビュー用のサブエージェントを作成します	Claude Code Mastery がエージェントの .md ファイルを作成し、Code Reviewer がレビューのロジックを提供します
senior-prompt-engineer	スキルの説明とエージェントの指示を最適化します	プロンプトエンジニアリング手法により、YAML フロントマターのトリガーフレーズとエージェントのシステムプロンプト（エージェントファイルの本文）が改善されます
doc-drift-detector	CLAUDE.md がコードベースと同期しなくなったときに検出します	Context Analyzer の出力がドリフト検出に使われ、ドリフトの検出結果を受けて CLAUDE.md を最適化します
context-engine	高度なコンテキスト管理戦略を適用します	Context Analyzer がトークン予算を提示し、Context Engine が圧縮と優先順位付けを適用します
senior-secops	セキュリティフックと権限モードを設定します	SecOps のポリシーで拒否するツールを定義し、Claude Code Mastery が権限の許可リストを設定します