cco-pack について
cco-packは、コーディングタスクに関係するリポジトリ内のファイルを選ぶスキルです。タスクの記述、Gitの変更、プロジェクトの履歴、キーワードを基に順位付けし、コンテキスト予算も考慮します。
主な機能
- 01タスクに応じたファイル順位付け
- 02Git作業ツリーの変更検出
- 03関連箇所のオフセットと範囲の提案
- 04コンテキスト予算に応じた選定
- 05JSON出力モード
活用シーン
- 01タスクで読み込むファイルの特定
- 02現在のGit状態に基づくファイル選定
- 03選定したファイル一覧の自動処理への受け渡し
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ egorfedorov/ claude-context-optimizer --skill cco-packインストール後、Claude Code で/cco-packを入力して読み込まれたか確認します。
詳細
スマートコンテキストパック
ユーザーが /cco-pack を実行するか、「X に必要なファイルは何ですか」と尋ねた場合、推測したりリポジトリ全体を読み込んだりするのではなく、トークン予算を考慮した、厳選されたファイル一覧を作成します。
使用方法
node ${CLAUDE_PLUGIN_ROOT}/src/smart-pack.js "the task description"
説明を付けずに、現在の Git の状態を対象にする場合:
node ${CLAUDE_PLUGIN_ROOT}/src/smart-pack.js
自動化に JSON として渡す場合:
node ${CLAUDE_PLUGIN_ROOT}/src/smart-pack.js --json "..."
ファイルの順位付け方法
優先順位:
- プロンプトで言及されたファイル — 明示的なファイルパス、または認識可能な名前 → 関連度 100
- Git の作業ツリーで変更されたファイル → 85
- このプロジェクトで過去に有用だったファイル(確信度が高く、頻繁に編集されている)→ 最大 70
- タスクとのキーワード一致 → 最大 70
各ファイルについて、パックは offset / limit も提案します。これは、ファイル内の目印(タスクのキーワード付近にある関数やクラスの宣言)を基に、構造上関連するセクションを示します。
トークン予算への配慮
ファイルを追加するとユーザーの実効コンテキスト予算の 25% を超える場合、パックは追加を停止します。予算には設定済みのモデルが反映されます(例:opus-5.5 の場合は 1M のコンテキストウィンドウ全体。Opus では 1M が標準で、プレミアムプランはありません)。
結果の提示
実行後、ユーザーに一覧を提示し、次の操作を提案します:
- 提案された offset/limit で上位 N 個のファイルを読み込む
- セットをテンプレートとして保存する(
/cco-templates create <name>) - より絞り込んだパックにしたい場合は、関連度の低い項目を除外する
コメント
Markdown 対応