Claude Code ガイド

Appearance

スキルで ${CLAUDE_EFFORT} 変数を使って現在のエフォートレベルを参照 ​

原文（日本語に翻訳） ​

スキルが ${CLAUDE_EFFORT} でコンテンツ内の現在のエフォートレベルを参照できるようになりました。

原文（英語） ​

Skills can now reference the current effort level with ${CLAUDE_EFFORT} in their content

概要 ​

Claude Code v2.1.120 では、スキル（カスタムコマンド）のコンテンツ内で ${CLAUDE_EFFORT} 変数が使えるようになりました。この変数には現在設定されているエフォートレベル（low・medium・high など）が展開されます。スキルの動作をエフォートレベルに応じて動的に変えたい場合や、エフォートレベルに関する情報をプロンプトに含めたい場合に活用できます。

基本的な使い方 ​

markdown
<!-- .claude/skills/smart-review.md -->
---
description: エフォートレベルに応じたコードレビュー
---

現在のエフォートレベル: ${CLAUDE_EFFORT}

このコードを以下のレベルでレビューしてください:
- エフォートレベルが high の場合: 詳細なセキュリティ・パフォーマンス分析を含む徹底的なレビュー
- エフォートレベルが medium の場合: 標準的なコード品質レビュー
- エフォートレベルが low の場合: 主要な問題のみ素早くチェック

実践例 ​

エフォートに応じたドキュメント生成 ​

markdown
<!-- .claude/skills/generate-docs.md -->
---
description: エフォートレベル対応のドキュメント生成
---

現在のエフォートレベルは ${CLAUDE_EFFORT} です。

このコードのドキュメントを生成してください。

{% if CLAUDE_EFFORT == "high" %}
- すべての公開 API の詳細な JSDoc コメント
- 使用例のコードスニペット
- パフォーマンス特性の説明
- エラーハンドリングの詳細
{% else %}
- 主要な関数・クラスのみ簡潔にドキュメント化
{% endif %}

ログへのエフォート情報の記録 ​

markdown
<!-- .claude/skills/analyze.md -->
---
description: コード分析（エフォートレベル記録付き）
---

[エフォートレベル: ${CLAUDE_EFFORT}] でコード分析を開始します。

対象コードを分析して以下を報告してください:
1. コード品質
2. 潜在的なバグ
3. 改善提案

CI での動的エフォート設定 ​

bash
# CI 環境では low エフォートで高速チェック
export CLAUDE_EFFORT=low
claude /analyze

# 本番リリース前は high エフォートで徹底チェック
export CLAUDE_EFFORT=high
claude /analyze

注意点 ​

  • ${CLAUDE_EFFORT} はスキルファイルのコンテンツ内でのみ展開されます
  • 展開される値はセッションの現在のエフォート設定に依存します（/model で確認・変更可能）
  • エフォートレベルが設定されていない場合のフォールバック動作を考慮してスキルを設計してください
  • この変数はスキルが呼び出された時点のエフォートレベルを反映します

関連情報 ​