mcpField
C
chat-compactor

chat-compactor

github.com/mavscuiエージェントワークフロー19388 回インストール34 週間前に更新
リポジトリ

chat-compactor について

Chat Compactor は、会話履歴を次の AI エージェントセッション向けの構造化された引き継ぎ記録にまとめるスキルです。決定、成果、失敗した方法、ファイル変更、障害、未完了の作業を簡潔な Markdown ファイルに記録します。

主な機能

  1. 01決定事項と成果の抽出
  2. 02失敗した方法と障害の記録
  3. 03ファイルとプロジェクト状態の整理
  4. 04構造化された Markdown 引き継ぎの生成
  5. 05プロジェクト内の場所への要約保存

活用シーン

  1. 01セッション間で進行中の作業を引き継ぐ
  2. 02デバッグでの行き詰まりを保存する
  3. 03コンテキスト切り替え前に作業を要約する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mavscui/agent-skills-hunter --skill chat-compactor

インストール後、Claude Code で/chat-compactorを入力して読み込まれたか確認します。

詳細

Chat Compactor

セッションをまたいで AI エージェントが継続しやすいよう最適化された、構造化サマリーを生成します。

これが必要な理由

人が書いたサマリーや場当たり的な AI サマリーでは、重要なコンテキストが失われます。

  • 判断の根拠が失われます（Y ではなく X を選んだ理由）
  • 行き詰まった試みが忘れられます（エージェントが失敗した方法を再び試します）
  • 暗黙知が記録されません（ファイルの場所、命名規則、注意点）
  • 状態が不明確です（完了したこと、保留中のこと、ブロックされていること）

このスキルは、次のセッションを円滑に始められるよう、エージェント向けに最適化された引き継ぎドキュメントを作成します。

出力形式

次の構造の Markdown ファイルを生成します。

# Session: [Brief Title]
Date: [YYYY-MM-DD]
Duration: ~[X] messages

## Context Snapshot
[1-2 sentences: What project/task, what state it's in right now]

## What Was Accomplished
- [Concrete outcome 1]
- [Concrete outcome 2]

## Key Decisions & Rationale
| Decision | Why | Alternatives Rejected |
|----------|-----|----------------------|
| [Choice] | [Reason] | [What didn't work and why] |

## Current State
- **Working**: [files/features that are functional]
- **Broken/Blocked**: [what's not working and why]
- **Modified files**: [list with brief note on changes]

## Dead Ends (Don't Retry)
- ❌ [Approach that failed] — [why it failed]

## Next Steps (Prioritized)
1. [ ] [Most important next action]
2. [ ] [Second priority]

## Environment & Gotchas
- [Any setup notes, versions, quirks discovered]

## Key Code/Commands Reference
[Only if there are non-obvious commands or snippets the next session needs]

ワークフロー

  1. 会話を確認し、判断、結果、失敗、ファイルの変更、ブロッカーを把握します
  2. **「引き継ぎのタイミング」**を特定します。新しいエージェントが続けるには何が必要でしょうか？
  3. 上記の形式を使用して、構造化サマリーを生成します
  4. ファイルをプロジェクトのルート、または /home/claude/sessions/ に session-[topic]-[date].md として保存します

要約のトリガー

次の場合にこのスキルを実行します。

  • ユーザーが「compact」「wrap up」「save session」「summarize for next time」と言った場合
  • コンテキストウィンドウの容量の約 50% を超え、タスクが進行中の場合
  • 大きなコンテキストの切り替えの前
  • デバッグまたは実装セッションの終了時

品質基準

優れた要約は次のとおりです。

  • 一覧性が高い：次のエージェントが 30 秒以内に状況を把握できます
  • 実行に移せる：曖昧な要約ではなく、明確な次の手順が示されています
  • 抜け漏れがない：行き詰まった試みを記録し、再調査を防ぎます
  • 簡潔：無駄がなく、すべての行に価値があります

避けるべきパターン

次のようなことは避けます。

  • 物語のような文章（「まず X を試し、次に Y、そして Z を試しました……」）
  • 重複するコンテキスト（コードコメントにある内容を繰り返さない）
  • 曖昧な要約（「機能開発が順調に進みました」）
  • 失敗の記録漏れ（最も価値のある情報です！）

トリガーと応答の例

ユーザー：「そろそろ切り上げて、このセッションを要約しましょう」

エージェント：

  1. 会話を確認し、重要な判断、結果、失敗を把握します
  2. 上記の形式に沿って、構造化された Markdown を生成します
  3. session-[topic]-[date].md に保存します
  4. 「セッションを session-auth-refactor-2025-01-06.md に要約しました。次回に備えて準備できています。」と確認します。

コメント

Markdown 対応