Claude CodeのCLAUDE.md・Rules・Skillsテンプレート設計

【結論】CLAUDE.mdとSkillsのテンプレート

全体ルールはCLAUDE.md、パス別ルールは.claude/rules/、再利用する作業手順は.claude/skills/へ分けます。

巨大な一枚物テンプレートより、短いルールと目的別Skillに分割した方がContextを節約できます。

# ターミナルでSkill用ディレクトリを作成
mkdir -p .claude/skills/create-pr
# ターミナルでパス別ルール用ディレクトリを作成
mkdir -p .claude/rules

具体的な手順・設定方法

1. CLAUDE.mdにはビルド、テスト、禁止事項など全体ルールだけを記載します。
2. .claude/rules/frontend.mdなどに対象パスを限定した規約を置きます。
3. .claude/skills/create-pr/SKILL.mdに目的、入力、手順、完了条件を記載します。
4. 対話画面で/を入力し、検出されたSkill名を選んで実行します。

実践プロンプト / 活用テクニック

次の指示は、そのままClaude Codeの対話画面へ貼り付けて使えます。

> このリポジトリのCLAUDE.mdと.claude/rules/を監査してください。
> 重複、矛盾、古いコマンドを特定し、全体ルールとパス別ルールへ整理してください。
> 変更前に差分案を示し、承認後だけ編集してください。

注意点・よくあるエラーと対処法

CLAUDE.mdはモデルを学習させるファイルではなく、セッションで参照される指示です。

秘密情報、個人データ、長大なAPI仕様を貼り付けず、必要な文書への参照と検証コマンドを記載します。

Skill名や呼び出し方法はバージョンや導入済みPluginで異なるため、/helpと候補一覧で確認してください。