ネストした .claude ディレクトリを使いたい
8. スキルコマンド / 機能
ネストした .claude/ 対応(近い方が優先)モノレポでの階層的なカスタマイズ
概要
v2.1.178 以降、サブディレクトリごとにネストした .claude/ ディレクトリを持てるようになりました。agents/workflows/skills はカレントディレクトリに近い .claude/ の定義が優先されます。モノレポで各パッケージごとに異なるエージェントやスキルを持たせたい場合に有効です。
設定例
# モノレポでの配置例
repo/
.claude/
skills/
deploy/SKILL.md # リポジトリ全体向けの deploy
packages/
api/
.claude/
skills/
deploy/SKILL.md # api/ 配下ではこちらが優先される
web/
.claude/
agents/
reviewer.md # web/ 配下限定のエージェント
# packages/api/ で作業中は packages/api/.claude/skills/deploy が使われる
# packages/web/ で作業中は repo/.claude/skills(api用ではない)と
# packages/web/.claude/agents が使われるこんな時に使う
- モノレポで各パッケージごとに異なるスキル・エージェントを定義したい時
- サブディレクトリ固有のワークフローをルートの設定より優先させたい時
- 大規模リポジトリで設定の影響範囲を局所化したい時
使い方
- 1各サブディレクトリに個別の .claude/ ディレクトリを作成
- 2agents/ workflows/ skills/ を必要な階層に配置
- 3Claude Code は作業中のディレクトリに近い .claude/ の定義を優先して読み込む
Tips
- v2.1.178 で追加された機能。それ以前はリポジトリルートの .claude/ のみが有効だった
- 同名のスキル・エージェントがある場合、近い階層の定義が上書きする形になる
- プラグインの .claude/skills/ 自動ロードとも組み合わせて使える