Claude Codeの設定はどこに書くべきか ― プロンプト・RULES・スキル・エージェントの使い分け

Zenn / 4/16/2026

💬 OpinionIdeas & Deep AnalysisTools & Practical Usage

共有:

Key Points

Claude Codeにおける設定は、プロンプト、RULES、スキル、エージェントの役割を理解して書き分けることで意図をブレずに伝えられると整理しています。
プロンプトは「その場の目的や前提」を与える用途に寄せ、RULESは「守るべき制約・方針」を明確に記述するのが有効だと説明しています。
スキルは再利用可能な機能（手順・能力）として切り出し、エージェントはそれらを束ねて動かす実行単位として設計する考え方を示しています。
使い分けの判断基準を提示し、設定の配置ミスによる挙動の揺れや保守性低下を防ぐことを狙っています。

はじめに Claude Code を本格的に使い込むと、すぐにぶつかる疑問がある。「この指示は、プロンプトに書くべきか？ AGENTS.md に書くべきか？スキルにすべきか？それとも専用エージェントにすべきか？」どれに書いても「一応動く」のが厄介なところで、動くからこそ場当たり的に積み上がっていき、いつの間にかメンテナンス不能な設定群になる。実装者ごとにスタイルが違えば、チームで共有したときにさらに事故が起きる。本記事では、スキルやエージェントファイルの書き方そのもの（フロントマターの書式、ツール指定の構文など）には立ち入らない。そこは公式ドキュメントに譲る。代わりに、...

Continue reading this article on the original site.

Read original →