Przejdź do treści
Biblioteka skilli
AI i agenci · Pisanie

document-handoff

/document-handoff

Tworzy szczegółową dokumentację przekazania przed operacją /compact, żeby nowy agent ze świeżym kontekstem mógł płynnie kontynuować pracę, z opcjami --output i --linear-issue.

Repozytorium
claude-plugins ↗
Licencja
MIT
Ostatnia zmiana repozytorium
15.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 15.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Tworzy szczegółową dokumentację przekazania przed operacją /compact, żeby nowy agent ze świeżym kontekstem mógł płynnie kontynuować pracę, z opcjami --output i --linear-issue.

Wyzwalacze z opisu

prepare a handoffdocument before compactcontext is getting too largeI need to hand this offcreate a handoff documentend of session notesdocument the current state for tomorrow
Oryginalny opis (EN)

Creates comprehensive handoff documentation before a /compact operation, enabling a new agent with fresh context to seamlessly continue the work. Activate when the user says "prepare a handoff", "document before compact", "context is getting too large", "I need to hand this off", "create a handoff document", "end of session notes", or "document the current state for tomorrow". Supports --output and --linear-issue options.

Jak działa

  1. When to Use
  2. Parameters
  3. Workflow
  4. Quality Standards
  5. Handoff + Compact Sequence
  6. Additional Resources
Sekcje z nagłówków SKILL.md, w oryginale · 124 linii, 566 słów
Podgląd SKILL.md
---
name: document-handoff
description: >
  Creates comprehensive handoff documentation before a /compact operation,
  enabling a new agent with fresh context to seamlessly continue the work.
  Activate when the user says "prepare a handoff", "document before compact",
  "context is getting too large", "I need to hand this off", "create a handoff
  document", "end of session notes", or "document the current state for
  tomorrow". Supports --output and --linear-issue options.
---

# Document Handoff

Create a self-contained handoff document that gives a fresh agent everything it
needs to continue without any prior context.

## When to Use

**Use when:**
- Context window is approaching its limit and `/compact` is necessary
- Handing off to another developer or agent
- Interrupting a complex task mid-way
- Ending a working session and resuming the next day
- Multiple failed attempts have accumulated useful learning

**Skip when:**
- The task will finish in the next five minutes
- Only research was done — no implementation changes
- The task is trivial and the context is minimal

## Parameters

| Parameter | Default | Description |
|---|---|---|
| `[task-name]` | derived from git branch | Name for the handoff document |
| `--output <dir>` | `.claude/handoffs/` | Output directory |
| `--linear-issue <ID>` | — | Pull issue details from Linear (e.g. `TF-177`) |

## Workflow

### Step 1 — Gather information automatically

**Git status:**
```bash
git branch --show-current
git status --short
git log --oneline -5
git diff --stat HEAD
```

**TODO/FIXME in code:**
```bash
grep -rn "TODO\|FIXME\|HACK\|XXX" --include="*.py" --include="*.ts" \
  --include="*.java" . 2>/dev/null | head -20
```

**Linear issue (if `--linear-issue` is specified):**
Use `mcp__linear__get_issue` to retrieve title, description, status, comments.

### Step 2 — Structure the document

| Section | Content |
|---|---|
| **Original Task** | What was the goal? What definition of done was agreed? |
| **Already Completed** | Concrete changes made — file paths, commit hashes, PR numbers |
| **Failed Attempts** | What was tried, what failed, and the exact reason why |
| **Current State** | Git branch, uncommitted files, environment specifics, running services |
| **Next Steps** | Prioritised list with specific file paths and line numbers where relevant |
| **Important References** | Key files, docs, code patterns, external resources |
| **For the Next Agent** | 2–3 sentence executive summary: pick this up and do X next |

### Step 3 — Save the document

**Output path:**
```
.claude/handoffs/YYYY-MM-DD_<task-slug>.md
```

Examples:
- `.claude/handoffs/2026-05-08_auth-refactor.md`
- `.claude/handoffs/2026-05-08_rbac-regression-fix.md`

Create the directory if it does not exist: `mkdir -p .claude/handoffs/`

### Step 4 — Output summary

After saving:
1. Display the full path to the handoff file
2. Highlight the **top 3 next steps** in order
3. Print the continuation instruction:

```
To continue after /compact:
  "Please read .claude/handoffs/YYYY-MM-DD_<task-slug>.md and continue with the next steps."
```

## Quality Standards

A good handoff document is:

**Self-explanatory** — the next agent needs no prior knowledge. Every relevant
file path includes a line number. No implicit assumptions.

**Actionable** — "Modify line 123 in `src/auth/service.py`" not "adjust the
auth code". Next steps are prioritised and have clear acceptance criteria.

**Complete** — both successful *and* failed attempts are documented. Error
messages are quoted verbatim, not paraphrased. Dependencies and external
factors that affect the task are noted.

**Safe** — no API keys, passwords, tokens, or credentials. If any were
encountered, note their *location* (environment variable name or file path),
not their values.

## Handoff + Compact Sequence

```bash
# 1. Create the handoff
/project-management:document-handoff "My Task Name"

# 2. Compact the context
/compact

# 3. In the new session, load and continue
# "Please read .claude/handoffs/2026-05-08_my-task-name.md
#  and continue with the next steps."
```

## Additional Resources

- **`../references/document-handoff/templates.md`** — Full and minimal handoff templates
- **`../references/document-handoff/examples.md`** — Annotated real-world examples
- **`../references/document-handoff/best-practices.md`** — Effective handoff patterns and common mistakes

Wersje

W bazie nie ma innych skilli o nazwie document-handoff.

Migawka bazy z 13.11.2026 · wersja paczki 5c20deaf9e94 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 86handoff
    Pisze lub aktualizuje plik HANDOFF.md, aby nowy agent mógł kontynuować pracę bez utraty kontekstu.
  • 90handoff
    Pisze dokument przekazania, by inny agent lub nowa sesja mogła kontynuować pracę bez ponownego tłumaczenia.
  • 100handoff
    Kompaktuje sesję do dokumentu przekazania, który zawiera tylko następny przydatny kontekst, żeby inny agent lub świeża sesja kontynuowała pracę zamiast używać /compact.
  • 95handoff
    Zamienia bieżącą rozmowę w dokument przekazania dla innego agenta, gdy kończy się kontekst lub użytkownik chce świeżego agenta.
  • 100session-handoff
    Pakuje kontekst bieżącej sesji, by inny agent mógł kontynuować pracę bez zaczynania od zera.
  • 90handoff
    Streszcza bieżącą rozmowę w dokument przekazania dla innego agenta, notatkę kontynuacji lub skompaktowany kontekst, który pozwala świeżemu agentowi kontynuować pracę.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.