cc-skill-strategic-compact

戦略的コンテキストチェックポイント

検証済みのフェーズの後にコンテキストを圧縮し、同じタスクを再開するのに十分な永続的な情報を残します。ツール呼び出しの回数はあくまで目安であり、コンテキストの品質を測ったり、圧縮が安全な時期を判断したりすることはできません。

使用する場面

探索が終了したとき、テスト済みのマイルストーンが達成されたとき、または長い会話に繰り返しや陳腐化した推論が含まれているときに使用します。未解決のツール呼び出しの途中、記録されていない承認判断、または正確な証拠がまだ取得されていない障害の途中では圧縮しないでください。

入力と前提条件

• ユーザーの現在の目的、受け入れ済みの制約、および完了の定義。
• 現在のブランチとソースリビジョン、ローカルの変更、関連する成果物のパス、および実際のチェック結果。
• 実行中のプロセス、保留中のツール呼び出し、承認、または外部のブロッカー。
• ホストがサポートするコンテキスト圧縮の仕組み。このスキルは、すべてのクライアントに /compact が存在することを前提としたり、内部のコンテキストファイルを操作したりしません。

手順

1. フェーズの境界を選びます。探索から実装へ、実装から検証へ、または完了した 1 つのバッチから次へ。未解決の障害については、まずその再現を保存します。
2. タスクの状態をファイルシステムおよび Git と突き合わせます。完了済み、未コミット、計画済み、失敗した作業を区別します。
3. 以下のチェックポイントを作成します。再開に必要な正確なコマンド、結果の要約、パスを含め、コピーしたログや、もはや重要でない破棄済みの仮説は省きます。
4. 次のアクションが実行可能であり、新しいコンテキストがマージを繰り返したり、メッセージを二重に送信したり、制約を失ったり、無関係な作業を上書きしたりしないことを確認します。
5. すでに承認されているプロジェクト成果物にのみ保存するか、会話内でチェックポイントを返します。グローバルメモリやホスト設定を自動的に書き換えないでください。
6. 要求され、利用可能であれば、クライアントがサポートする圧縮コマンドを使用します。再開時には、チェックポイントを読み、続行する前に可変の状態を検証します。

チェックポイントのテンプレート

Objective and done condition:
User constraints and authorization boundaries:
Source revision, branch and local changes:
Completed outcomes with verification:
Outstanding work and known failures:
Running process/tool identifiers:
Artifacts and exact paths needed next:
Next action, expected result and fallback:

具体例

ソース PR はマージされたが正規の同期が保留中である検索機能について、ソースのマージ SHA、正規の PR 番号、および生成が期待されるファイルを保存します。テストは、実際にテストしたリビジョンについてのみ合格として記録します。次のアクションは、正規の PR と更新された main を検証することであり、ソース PR を再度マージすることではありません。ブラウザチェックにまだロック解除されたデスクトップが必要な場合は、独立したコードレビューを続けながら、その条件を可視化しておきます。

期待される結果: 次のコンテキストは未完了の検証を再開し、無関係なローカルの編集を保持し、ソースのマージによる公開を主張しません。

任意のステートレスなリマインダー

bash skills/cc-skill-strategic-compact/suggest-compact.sh 50

このヘルパーは、観測されたツール呼び出し回数と任意のしきい値（デフォルト 50）を受け取り、しきい値の時点と、その後の 25 回ごとにリマインダーを出力します。COMPACT_TOOL_COUNT と COMPACT_THRESHOLD は、明示的な呼び出し側アダプターから指定できます。カウンターを保存せず、トークン使用量を見積もらず、圧縮を実行することもありません。回数が指定されない場合は何も出力せずに終了します。

以前のバージョンでは、無関係なセッションをまたいで共有ユーザー状態のカウンターをインクリメントしていました。そのカウンターは現在は読み書きされません。既存のカスタムラッパーは、セッションの回数を明示的に渡す必要があります。既存の状態ファイルはそのまま残されます。このスキルはフックをインストールしたり編集したりしません。

制限事項

• チェックポイントは記録された証拠を保存するものであり、会話のすべての詳細ではありません。正確なバイト列が重要な場合は、一次成果物を保持してください。
• 回数は呼び出し側が指定する、範囲が制限された非負の十進整数です。リマインダーはコンテキスト容量の測定値ではありません。
• ブランチ、プロセス、リモートのチェックは、チェックポイントの後に変化する可能性があります。要約を現在の真実として扱わず、再検証してください。
• クライアントのコンテキスト管理は異なります。チャットのデータベース、ログ、キャッシュ、プロジェクトファイルを削除して圧縮をシミュレートしないでください。