mcpField
C
chat-compactor

chat-compactor

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

chat-compactor について

Chat Compactorは、AIエージェントがセッションをまたいで作業を続けられるよう、構造化された引き継ぎ要約を作るスキルです。開発やデバッグの決定理由、失敗した試行、現在の状態、次の手順をMarkdownファイルに記録します。

主な機能

  1. 01決定、結果、失敗、ブロッカーの抽出
  2. 02完了事項と次のアクションの整理
  3. 03構造化されたMarkdown引き継ぎ文書の生成
  4. 04指定場所へのセッション要約の保存

活用シーン

  1. 01デバッグ終了時に失敗した方法と進捗を記録
  2. 02タスク切り替え前に次のセッション向けの文脈を準備
  3. 03コンテキストウィンドウが限られる際の状態整理

インストール

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

$npx skills add https://github.com/zhanlincui/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 対応