compact-prep
Installation
SKILL.md
compact-prep — コンテキスト圧縮前のセッション状態保存
目的
/compact や auto compact は会話履歴を要約に置き換える。要約は「過去の作業ログ」としては妥当でも、
「意思決定の構造」(どの案を採用し、どの案をなぜ却下したか)と「次に何をすべきか」が脱落しやすい。
このスキルは圧縮前にそれらを固定フォーマットの状態ファイルへ退避し、圧縮後のセッションが
却下済みの案を再提案したり、検証前の変更を検証済みと思い込んだりすることを防ぐ。
前提
- Claude Code 専用。 セッション ID の展開(
${CLAUDE_SESSION_ID})と圧縮後の hook 連携が Claude Code の仕組みに依存するため、Codex など他ツールでは Step 1 のハードゲートで中止する。他ツールで同等の運用をする場合は、そのツールのセッション ID 取得手段と hook 相当を別途定義する - 状態ファイルの保存先は
COMPACT_STATE_DIR環境変数、未設定なら~/.claude/compact-state - 圧縮後の自動読み込みは
assets/compact-state-hook.pyを hook として登録することで動く。登録手順はreferences/setup.md - セッション ID は実行環境が提供する変数から取る。Claude Code では
${CLAUDE_SESSION_ID}