【要約】ユーザーの一言で 10.8k tokens 削減できた話 ── Built-in と衝突したので skill 名を退けた話 ── [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者がClaude CodeのラッパーであるC3を利用する際、特定のルールファイルが全セッションで自動ロードされる問題に直面した。これにより、エージェントの役割に関わらず不要なトークンが消費され続けていた。
- ・
.claude/rules/配下のファイルが、全セッションで全文自動ロードされる仕様。 - ・合計約10.8k tokens が、無関係なセッションでも常駐し、コンテキストを圧迫。
- ・公式の
paths指定によるスコープ限定は、ロードタイミングの遅延を保証しない。
// Approach
開発者は、ファイルの配置場所を変更することで、ロード機構そのものを制御する手法を採用した。また、公式アップデートによる名前衝突に対しても、構造的な回避策を講じた。
- ・
.claude/rules/から.claude/skills/<name>/references/へファイルを移動。 - ・「必要時Read」が保証されているディレクトリへ配置し、遅延ロードを実現。
- ・公式コマンドとの衝突を避けるため、skill名を
/review-phaseへリネーム。 - ・
c3 updateの制約を補完するため、廃止パスを警告する機構を導入。
// Result
適切な配置変更により、期待通り約10.8k tokens の常駐コンテキスト削減を達成した。これにより、AIの応答精度とコストの両面が改善された。
- ・Memory files 合計が 15.7k から 4.9k tokens へ減少。
- ・公式アップデートによる名前衝突を回避し、フレームワークの安定性を確保。
- ・
DEPRECATED_PATHSにより、利用者の手動クリーンアップを支援。
Senior Engineer Insight
> AIエージェント運用において、コンテキスト管理はコストと精度の両面に直結する。本件は「仕様の意図」と「実装の挙動」の乖離を、
/context による実測で解決した点が極めて実践的である。AIの提案を鵜呑みにせず、実機の状態を提示して議論を確定させるプロセスは、あらゆるエンジニアリングにおいて普遍的な価値がある。また、公式の進化に追従するラッパー開発では、名前衝突を避けるための命名規則と、古い資産を警告する仕組みが不可欠である。