compress-session

joshuacook 的头像作者 joshuacook

将会话对话压缩为系统内存的结构化摘要。当用户说"压缩"、"压缩会话"或完成重要工作后激活。捕获git提交无法保留的决策、构建的工具、突破和上下文。

📖 中文导读:将会话对话压缩为系统内存的结构化摘要。当用户说"压缩"、"压缩会话"或完成重要工作后激活。捕获git提交无法保留的决策、构建的工具、突破和上下文。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: compress-session description: Compress session conversation into structured summary for system memory. Activate when user says "compress", "compress session", or after significant work. Captures decisions, tools built, breakthroughs, and context that git commits can't preserve. allowed-tools: Read, Write, Bash

Compress Session

Compress active session into structured summary. Capture decisions, tools built, breakthroughs - the "why" and "how" that git commits don't preserve.

When to Activate

  • User says: "compress", "compress session"
  • After significant milestones
  • Every ~10 messages in long sessions
  • Before ending major work

Process

1. Determine Sequence Number

ls -t inbox/session-summaries/$(date +%Y-%m-%d)*.md 2>/dev/null | head -1
  • If files exist: increment (seq2, seq3...)
  • If none: this is seq1

2. Review Conversation

Identify signal vs. noise:

  • INCLUDE: Decisions, tools built, breakthroughs, key quotes, context
  • SKIP: Pleasantries, process discussion without outcome, redundant info

3. Write Summary

Create: inbox/session-summaries/YYYY-MM-DD-HHMM-seqN.md

# Session Capture: YYYY-MM-DD [Sequence N]

**Time:** [Start] - [Current]
**Roles Active:** [List or "general"]
**Messages:** [Approximate range]
**Branch:** [git branch]

---

## Context

[1-3 sentence narrative of what happened this sequence]

---

## Decisions Made

- [Decision 1]
  - Reason: [Why]
- [Decision 2]

---

## Tools/Workflows Built

- **[Name]:** [Description and purpose]

[Or: None this sequence]

---

## Breakthroughs/Insights

- [Insight] - [Significance]

---

## Key Quotes

- "[Quote]" ([Context])

---

## Files Created/Modified

[From git status]
- New: [files]
- Modified: [files]

---

## Next Steps

- [What's coming]

---

**Session compressed. Sequence [N] captured.**

4. Confirm

Session compressed. Sequence [N] captured.
Stored: inbox/session-summaries/YYYY-MM-DD-HHMM-seqN.md

What to Include

  • Decisions affecting work/strategy/direction
  • Tools/workflows built or planned
  • Breakthroughs (creative, technical, conceptual)
  • Context explaining why decisions were made
  • Key quotes revealing intent

What to Skip

  • Conversational filler
  • Detailed implementation (git shows that)
  • Process discussion without decision
  • Speculation that didn't become action

Tone

  • Concise, structured
  • Bullet points over paragraphs
  • Searchable and scannable
  • Neutral observation