Claude Code スキルのコンテキスト消費にまつわる議論を整理する

概要

Claude Codeのスキル運用におけるコンテキスト消費仕様「Progressive Disclosure」を整理し、最新版での実測により外部ファイルの分割が不要であることを検証した記事。

詳細内容

この記事では、Claude Codeのスキルを多数導入した際に発生すると噂されていた「コンテキストの圧迫問題」について、最新バージョン（v2.1.50）を用いて技術的に検証しています。Claude Codeが採用している「Progressive Disclosure（段階的開示）」という仕様に基づき、起動時にはフロントマターのみが、呼び出し時にのみ本文が読み込まれる設計であることを解説。過去のコミュニティで報告されていたバグや、それに対する「ファイルを外部参照へ分割する」というワークアラウンドの効果を実測した結果、最新版では仕様通り動作しており、むしろ分割によるツール呼び出しのオーバーヘッドの方がトークン消費を増大させることが判明しました。結論として、過度なファイル分割は不要であり、YAMLフロントマターの適切な記述と、巨大なスキルのみを必要に応じて分割する標準的なベストプラクティスが推奨されています。

元記事を読む他のサマリーを見る