handoff
/handoff
Przekazuje pisemne zlecenie agentowi ACP pracującemu w osobnym worktree, a potem sprawdza jego commity i wyniki testów.
- Autor
- glebis ↗
- Repozytorium
- claude-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 10.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Przekazuje pisemne zlecenie agentowi ACP pracującemu w osobnym worktree, a potem sprawdza jego commity i wyniki testów.
Wyzwalacze z opisu
Oryginalny opis (EN)
Hand a written brief to an ACP agent that works in its own git worktree and herdr workspace, then check its work before anyone merges it. Writes a dated handoff doc, creates a beads epic when the repo has one, cuts a `handoff/<id>-<slug>` branch from the current branch, launches the agent through herdr''s `acp-run` (default `cmd acp`), and later verifies commits, stray changes and the brief''s checks. Use when the user says "hand this off", "create a handoff", "start it in its own worktree", "give this to an agent", "launch an agent on this epic", or wants an epic or multi-step to-do worked on
Jak działa
- Commands
- Workflow
- What the agent is told
- Requirements and limits
Podgląd SKILL.md
--- name: handoff description: 'Hand a written brief to an ACP agent that works in its own git worktree and herdr workspace, then check its work before anyone merges it. Writes a dated handoff doc, creates a beads epic when the repo has one, cuts a `handoff/<id>-<slug>` branch from the current branch, launches the agent through herdr''s `acp-run` (default `cmd acp`), and later verifies commits, stray changes and the brief''s checks. Use when the user says "hand this off", "create a handoff", "start it in its own worktree", "give this to an agent", "launch an agent on this epic", or wants an epic or multi-step to-do worked on away from a shared checkout. Requires git and a running herdr; beads is optional.' --- # Handoff A handoff is a dated doc plus, when the repo uses beads, an epic. The doc is the brief. A session or agent starts only when the user says to start it. `scripts/handoff` does every mechanical step; the agent's job is to write a good doc and report what the script prints. ## Commands ```bash scripts/handoff new "Report importer" # docs/YYYY-MM-DD-report-importer-handoff.md scripts/handoff start DOC # epic + worktree + launch, detached scripts/handoff start DOC --supervise # wait for the agent, then collect scripts/handoff start DOC --here # worktree, branch, brief and epic; no agent scripts/handoff start DOC --agent "codex-acp" # any ACP agent command scripts/handoff status ID # commits, dirty files, agent exit, log tail scripts/handoff collect ID # verify and record the result on the epic scripts/handoff close ID [--discard] # remove the worktree once merged scripts/handoff list ``` Run them from inside the target repository. State is kept in `<git-common-dir>/handoff/<id>/` (`state.json`, `brief.md`, `run.log`), so nothing is added to the working tree. ## Workflow 1. **Write the doc.** Use `handoff new "<title>"` or the project's own convention: look at existing handoff or spec docs first and match their folder and naming. Fill in problem, scope, what is out of scope and "done when". Put verification commands in a fenced block under a heading named `Checks` (or `Verify`): `collect` runs each line in the worktree. 2. **Stop and wait** until the user says to start it. Writing the doc is not consent to launch. 3. **Start.** `handoff start DOC` prints the base branch and commit it cuts from; relay that line, and any note that the source checkout has uncommitted changes the worktree won't have. Without `bd` or a `.beads/` folder the epic is skipped with a one-line note. 4. **Check in** with `handoff status ID`. Don't poll in a loop; use `--supervise` when the user wants to wait for it. 5. **Collect.** `handoff collect ID` checks that the agent finished, the branch has commits, the worktree is clean, nothing new changed in the source checkout, and each brief check passes. It records the result as a comment on the epic and exits non-zero on any failure. 6. **Merge is the user's call.** Report the verdict and the branch name, then stop. 7. **Close** after the merge: `handoff close ID` removes the worktree and workspace, deletes the merged branch and closes the epic. It refuses an unmerged branch unless `--discard`, which removes the worktree but always keeps the branch. ## What the agent is told The doc is sent as the prompt with fixed rules appended: stay in the worktree, commit on the handoff branch with explicit paths only, never merge, rebase, push or open a PR, don't touch files outside the worktree, report blockers instead of working around them, and end with a short report. `acp-run` enforces the path rule for permission requests and file reads and writes. ## Requirements and limits - git, Python 3, a running herdr, and herdr's `acp-run` script. The script looks for `acp-run` on `PATH`, next to this skill in a sibling `herdr` skill, and in the usual skill folders; set `HANDOFF_ACP_RUN` to override. - Only ACP agents. The script never falls back to a TUI agent. - The worktree is cut from committed history. Uncommitted changes, including an uncommitted doc, aren't in it; the brief still reaches the agent because it is passed as a file. - "Nothing changed outside the worktree" compares the source checkout's `git status` with a snapshot from start time. In a checkout shared with other sessions a change there may be theirs, so `collect` names the files instead of guessing.
Pliki w paczce (2)
- SKILL.md 4 KB
- scripts/handoff 17 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · glebis/claude-skills | 100 | MIT |
| lumpen-mya/claude-handoff | 100 | MIT |
| generous-corp/pulp | 100 | MIT |
| Ovid/paad | 100 | MIT |
| Ovid/paad | 100 | MIT |
| Ovid/paad | 100 | MIT |
| webdevnerdstuff/claude-marketplace | 100 | MIT |
| terencebristol/terencebristol-toolkit | 100 | MIT |
| verkyyi/claude-fleet | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki fe066cbc9d57 (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
- 100worktree-handoff
Tworzy worktree dla zadania i zapisuje kontekst przekazania w pliku planu, który trafia do commita na gałęzi. - 100acp-repo-template
Zakłada nowe repozytorium super-repo ACP i stosuje domyślne ustawienia GitHub oraz regułę gałęzi. - 90dispatch
Zleca zadania nowym agentom kodującym, każdemu w osobnym worktree i gałęzi, a potem sprawdza i scala ich wyniki. - 100herdr-code-review
Uruchamia nowego agenta recenzującego w osobnym panelu Herdr, zleca mu pełny przegląd kodu i przekazuje jego raport, gdy użytkownik prosi o review w osobnym agencie. - 95open-workspace
Otwiera osobną kopię projektu w przestrzeni herdr, na przykład do przekazania zadania innemu agentowi lub nowej gałęzi. - 100git-worktree
Pracuje w osobnym worktree, odizolowując pracę agenta od innych agentów w tym samym katalogu roboczym.