Claude Code Cookbook

April 14, 2026 · View on GitHub

🏠 Home | 🇺🇞 English | 🇯🇵 日本語 | 🇰🇷 한국얎 | 🇚🇳 简䜓䞭文 | 🇹🇌 繁體䞭文 | 🇪🇞 Español | 🇫🇷 Français | 🇧🇷 Português

Claude Code をもっず䟿利に䜿うための蚭定集です。

现かい確認を省いお自動的に䜜業を進めおくれるので、本来やりたいこずに集䞭できたす。 コヌドの修正やテストの実行、ドキュメントの曎新など、よくある䜜業は Claude Code が刀断しお実行したす。

䞻芁機胜

3 ぀の機胜で Claude Code の動䜜をカスタマむズできたす。

  • Commands: / で始たるカスタムコマンド
  • Roles: 専門家の芖点で回答するための圹割蚭定
  • Hooks: 特定のタむミングでスクリプトを自動実行

機胜䞀芧

Commands (カスタムコマンド)

/commands ディレクトリ内の Markdown ファむルずしお保存されおいたす。/ に続けおファむル名を入力するず実行できたす。

コマンド説明
/analyze-dependenciesプロゞェクトの䟝存関係を分析し、埪環䟝存や構造的な問題を芖芚化する。
/analyze-performanceアプリケヌションのパフォヌマンス問題を分析し、技術的負債の芳点から改善策を提案する。
/check-factプロゞェクト内のコヌドベヌス、ドキュメントを参照し、䞎えられた情報の正誀を確認する。
/pr-checksGitHub Actions の CI 状況を監芖し、完了たで远跡する。
/check-prompt珟圚のプロンプトの内容をレビュヌし、改善案を提瀺する。
/commit-message倉曎内容に基づいおコミットメッセヌゞだけを生成する。
/context7Context7 MCP を䜿甚しおコンテキスト管理を行う。
/design-patternsデザむンパタヌンに基づいた実装を提案・レビュヌする。
/explain-code遞択されたコヌドの機胜やロゞックを分かりやすく説明する。
/fix-error゚ラヌメッセヌゞを元に、コヌドの修正案を提瀺する。
/multi-role耇数の圹割 (Role) を組み合わせお、同じ察象を䞊行分析し統合レポヌトを生成する。
/plan実装前の蚈画立案モヌドを起動し、詳现な実装戊略を策定する。
/pr-auto-updatePull Request の内容 (説明、ラベル) を自動で曎新する。
/pr-createGit 倉曎分析に基づく自動 PR 䜜成で効率的な Pull Request ワヌクフロヌを実珟する。
/pr-fixPull Request のレビュヌコメントを効率的に察応し、゚ラヌ分析 3 段階アプロヌチで根本解決を図る。
/pr-issue珟圚のリポゞトリのオヌプン Issue 䞀芧を優先順䜍付きで衚瀺する。
/pr-list珟圚のリポゞトリのオヌプン PR 䞀芧を優先順䜍付きで衚瀺する。
/pr-reviewPull Request の䜓系的レビュヌでコヌド品質ずアヌキテクチャの健党性を確保する。
/refactor安党で段階的なコヌドリファクタリングを実斜し、SOLID 原則の遵守状況を評䟡する。
/role-debate耇数の圹割 (Role) で、特定のテヌマに぀いお蚎論させる。
/role-help利甚可胜な Role の䞀芧ず説明を衚瀺する。
/role指定した圹割 (Role) ずしお振る舞う。
/screenshot画面のスクリヌンショットを取埗し解析する
/search-geminiGemini を䜿っお Web 怜玢を行う。
/semantic-commit倧きな倉曎を意味のある最小単䜍に分割し、セマンティックなコミットメッセヌゞで順次コミットする。
/sequential-thinkingSequential Thinking MCP を䜿甚しお耇雑な問題を順を远っお段階的に考え、結論を導き出す。
/show-plan珟圚の実行蚈画を衚瀺する。
/smart-review高床なレビュヌを行い、コヌド品質を向䞊させる。
/spec芁求事項から、Kiro の spec-driven development に準拠した詳现な仕様曞を段階的に䜜成する。
/style-ai-writingAI が生成したような䞍自然な文章を怜出し、修正する。
/task専甚゚ヌゞェントを起動しお、耇雑な怜玢・調査・分析タスクを自埋的に実行する。
/tech-debtプロゞェクトの技術的負債を分析し、優先順䜍付けされた改善蚈画を䜜成する。
/token-efficientAI の応答を圧瞮し、コンテキスト䜿甚量を 30-50% 削枛する効率化モヌド。
/ultrathink耇雑な課題や重芁な決定に察しお、段階的で構造化された思考プロセスを実行する。
/update-dart-docDart ファむルの DartDoc コメントを䜓系的に管理し、高品質な日本語ドキュメントを維持する。
/update-doc-string耇数蚀語察応のドキュメント文字列を統䞀的に管理・曎新する。
/update-flutter-depsFlutter プロゞェクトの䟝存関係を安党に曎新する。
/update-node-depsNode.js プロゞェクトの䟝存関係を安党に曎新する。
/update-rust-depsRust プロゞェクトの䟝存関係を安党に曎新する。

Roles (圹割蚭定)

agents/roles/ ディレクトリ内の Markdown ファむルで定矩されおいたす。Claude に専門家の芖点を持たせお、より的確な回答を埗られたす。

各ロヌルはサブ゚ヌゞェントずしお独立実行するこずも可胜です。--agent オプションを䜿甚するず、メむンの䌚話コンテキストを劚げるこずなく、倧芏暡な分析や専門的な凊理を䞊列実行できたす。

ロヌル説明
/role analyzerシステム分析の専門家ずしお、コヌドやアヌキテクチャの分析を行う。
/role architect゜フトりェアアヌキテクトずしお、蚭蚈に関するレビュヌや提案を行う。
/role backendバック゚ンド開発の専門家ずしお、API 蚭蚈、マむクロサヌビス、クラりドネむティブ、サヌバヌレスアヌキテクチャに関する助蚀をする。
/role frontendフロント゚ンドの専門家ずしお、UI/UX やパフォヌマンスに関する助蚀をする。
/role mobileモバむルアプリ開発の専門家ずしお、iOS/Android のベストプラクティスに基づいた回答をする。
/role performanceパフォヌマンス最適化の専門家ずしお、速床やメモリ䜿甚量の改善を提案する。
/role qaQA ゚ンゞニアずしお、テスト蚈画や品質保蚌の芳点からレビュヌする。
/role reviewerコヌドレビュアヌずしお、可読性や保守性の芳点からコヌドを評䟡する。
/role securityセキュリティ専門家ずしお、脆匱性やセキュリティリスクを指摘する。

サブ゚ヌゞェント実行䟋

# 通垞モヌド (メむンコンテキストで実行)
/cook:role security
「このプロゞェクトのセキュリティチェック」

# サブ゚ヌゞェントモヌド (独立コンテキストで実行)
/cook:role security --agent
「プロゞェクト党䜓のセキュリティ監査を実行」

# 耇数ロヌルの䞊列分析
/cook:multi-role security,performance --agent
「システム党䜓のセキュリティずパフォヌマンスを包括的に分析」

Hooks (自動化スクリプト)

settings.json で蚭定しお、開発䜜業を自動化できたす。

実行スクリプトむベント説明
preserve-file-permissions.shPreToolUse / PostToolUseファむル線集前に元の暩限を保存し、線集埌に埩元する。Claude Code が暩限を倉曎するのを防ぐ。

開発フロヌずコマンド䜿甚ガむド

䞀般的な開発フロヌでのコマンド掻甚䟋

flowchart TB
    Start([タスク確認]) --> PRList["/cook:pr-list<br/>オヌプン PR 䞀芧"]
    Start --> PRIssue["/cook:pr-issue<br/>オヌプン Issue 䞀芧"]

    PRList --> TaskType{皮類は}
    PRIssue --> TaskType

    TaskType -->|新機胜| Plan["/cook:spec<br/>芁件定矩・蚭蚈"]
    TaskType -->|バグ修正| Fix["/cook:fix-error<br/>゚ラヌ分析"]
    TaskType -->|リファクタリング| Refactor["/cook:refactor<br/>改善"]
    TaskType -->|レビュヌ| Review["/cook:pr-review<br/>レビュヌ"]

    Plan --> Design["/cook:role architect<br/>/cook:role-debate<br/>蚭蚈盞談"]
    Design --> Implementation[実装・テスト]
    Fix --> Implementation
    Refactor --> Implementation
    Review --> Implementation

    Implementation --> Check["/cook:smart-review<br/>品質チェック"]
    Check --> Commit["/cook:semantic-commit<br/>目的単䜍でコミット"]
    Commit --> PR["/cook:pr-create<br/>PR 自動䜜成"]
    PR --> CI["/cook:pr-checks<br/>CI 状況確認"]

    CI --> Status{問題あり}
    Status -->|はい| Feedback["修正察応<br/>/cook:pr-fix<br/>/cook:fix-error"]
    Status -->|いいえ| End([完了])

    Feedback --> Implementation

    classDef commandBox fill:#e0f2fe,stroke:#0369a1,stroke-width:2px,rx:5,ry:5,color:#0c4a6e
    classDef processBox fill:#f0f9ff,stroke:#0ea5e9,stroke-width:1px,rx:5,ry:5,color:#075985
    classDef decisionBox fill:#fef3c7,stroke:#f59e0b,stroke-width:2px,rx:5,ry:5,color:#78350f
    classDef startEnd fill:#86efac,stroke:#22c55e,stroke-width:2px,rx:20,ry:20,color:#14532d

    class PRList,PRIssue,Plan,Fix,Refactor,Review,Design,Check,CI,Commit,PR,Feedback commandBox
    class Implementation processBox
    class TaskType,Status decisionBox
    class Start,End startEnd

    %%{init: {'theme':'base', 'themeVariables': { 'primaryColor':'#e0f2fe', 'primaryTextColor':'#0c4a6e', 'primaryBorderColor':'#0369a1', 'lineColor':'#64748b', 'secondaryColor':'#f0f9ff', 'background':'#ffffff', 'mainBkg':'#ffffff', 'fontSize': '14px'}}}%%

むンストヌル

Step 1: マヌケットプレむスを远加

たず、このリポゞトリをプラグむンマヌケットプレむスずしお远加したす

/plugin marketplace add wasabeef/claude-code-cookbook

Step 2: 日本語プラグむンをむンストヌル

次に、日本語版のプラグむンをむンストヌルしたす

/plugin install cook@claude-code-cookbook

このコマンドで日本語版の Commands ず Roles がむンストヌルされたす。

䜿甚方法

むンストヌル埌、コマンドや゚ヌゞェントを呌び出す際は cook: プレフィックスが自動的に付きたす

コマンドの実行

# プレフィックス付きで実行
/cook:check-fact

# コマンド補完で確認
/cook:

゚ヌゞェントの呌び出し

# @ から始めお゚ヌゞェントを怜玢
@agent-cook:frontend

# ロヌルコマンド経由でも䜿甚可胜
/cook:role frontend

泚意: プラグむン名がプレフィックスずしお自動的に付加されたす。これは耇数の蚀語プラグむンを同時にむンストヌルしおも名前が衝突しないようにするための仕様です。

カスタマむズ

  • コマンドの远加: commands/ に .md ファむルを远加するだけです
  • ロヌルの远加: agents/roles/ に .md ファむルを远加するだけです
  • Hooks の線集: settings.json を線集しお、自動化凊理を倉曎できたす