convez.ai
SkillProdutividadeIntermediário
costrict-plugins-repo

Handoff — Transferência de Contexto entre Agentes

costrict-plugins-repo/alirezarezvani-claude-code-skills-handoff-productivity

Transferência de contexto estruturada entre agentes com segurança integrada

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que compacta conversas em documentos estruturados para passagem de contexto entre agentes. Inclui hooks de SessionStart/End, linter de redação (proteção de segredos), checklist obrigatório e recomendador de skills. Mantém histórico organizado sem poluição no projeto.

Instalação

$npx convez-ai costrict-plugins-repo/alirezarezvani-claude-code-skills-handoff-productivity

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 2 semanas
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Passar contexto de uma sessão para outra sem perder estado
  • Documentar decisões e próximos passos para outro agente retomar
  • Proteger informações sensíveis ao compartilhar handoffs
  • Manter checklist obrigatório de tópicos antes de encerrar sessão

Veredito

Skill bem pensada que resolve um problema real em fluxos multi-agente. A redação estruturada (Estado/Decisão/Drop) + linter de segredos + hooks automáticos elevam a qualidade de handoffs. Depende de disciplina do usuário, mas o checklist obrigatório força boas práticas.

README

A tradução para o português deste README ainda está na fila.

handoff (productivity)

Compact the current conversation into a handoff document for another agent to pick up.

A productivity-shaped handoff skill. Configurable save location (no project clutter), redaction enforcement, SessionStart auto-load, mandatory checklist for the agent. Five sections, three to five recommended skills, references not copies.

Inspired by Matt Pocock's handoff skill (MIT). Matt's seven sentences are preserved verbatim in SKILL.md. The wrapper around them — first-run setup, redaction linter, SessionStart hook, mandatory checklist, skill recommender — is original work in this repo.

Five must-haves shipped in v1.0.0

#FeatureWhy
1SessionStart hook auto-loads the latest handoffWithout this, the file is written but unread. The hook turns the artifact into an actual handoff.
2First-run setup asks where to saveAvoids cluttering project folders. No pre-selected default — user picks explicitly on first run.
3Mandatory checklist (handoff_prompt.md)Forces the agent to classify every topic (State / Decision / drop) rather than free-handing prose.
4Redaction linterOperationalizes Matt's redaction sentence with regex + whitelist marker + strict/warn modes.
5mtime-guarded cleanupAuto-cleanup never deletes a handoff the user edited as a working surface.

v1.1 additions

FeatureWhy
SessionEnd reminder hookPairs with SessionStart. If a session ends without a recent handoff, prints a one-line reminder so the user doesn't lose context for next time. Disable with HANDOFF_SESSIONEND=0.
Self-check script (handoff_self_check.py)Operationalizes the mandatory checklist. Flags empty Goal, State bullets that reference no artifact, missing Open decisions when git is dirty, too few/many Skills, inline content in Artifacts. Runs before the redaction linter.
--refresh flag on the template generatorReuses the most recent handoff instead of creating a new file. Keeps the save location uncluttered when work continues past the original handoff.

Install

This plugin lives at productivity/handoff/. Enable through your plugin manager. On first invocation of /cs:handoff, the skill will prompt:

Run setup now? (Y/n)

  • Y — walks 5 questions and writes ~/.config/handoff/config.json.
  • N — uses defaults this run and never re-prompts (sentinel at ~/.config/handoff/.setup-declined).

Re-configure any time with /cs:handoff-setup.

Slash commands

CommandUse
/cs:handoff [goal]Generate the handoff doc.
/cs:handoff-setup [--project]Configure (or reconfigure) save location, retention, redaction.

Tooling

Stdlib-only Python. No external deps.

ScriptPurpose
scripts/setup.pyFirst-run Q&A. --reconfigure, --project, --decline, --sample.
scripts/config_loader.pyShared helper. --show, --status, --sample.
scripts/handoff_template_generator.pyWrites the 5-section scaffold. --goal, --print-path-only, --sample.
scripts/redaction_linter.pyScans for secrets/PII. --mode strict|warn|off, --json, --sample.
scripts/skill_recommender.pySuggests 3-5 skills. --goal, --scope, --json, --sample.
scripts/cleanup.pymtime-guarded retention cleanup. --dry-run, --json, --sample.

Hooks

hooks/session_start.py (wired via hooks/hooks.json) — on every SessionStart, finds the most recent handoff in the configured save location and surfaces it as <handoff_from_previous_session> data. The next agent reads it as context, not instructions. Disable per-session with HANDOFF_SESSIONSTART=0.

References

FileTopic
references/handoff_prompt.mdThe mandatory checklist the agent walks before writing.
references/handoff_structure.mdThe 5-section template with a worked example.
references/deduplication_discipline.mdMatt's no-duplication rule with concrete do-this-not-that pairs.
references/redaction_checklist.mdRegex patterns + manual review steps + whitelist mechanism.
references/configuration.mdField-by-field config reference.

Distinct from engineering/handoff/

Aspectproductivity/handoff/engineering/handoff/
Primary audienceEnd-of-day session handoff, cross-machine handoffCode/PR handoff
First-run setupYes (5 questions, configurable save location)No (fixed mktemp)
Redaction enforcementYes (linter with strict/warn/off + inline whitelist)No
SessionStart auto-loadYes (hook + retention-aware)No
Mandatory checklistYes (handoff_prompt.md, 6 steps)No
Retention cleanupYes (mtime-guarded)No

Both exist deliberately. The engineering version stays optimized for code/PR contexts. This one is for the broader daily routine.

Inspired by

Matt Pocock's handoff skill (MIT). The seven-sentence body of SKILL.md is Matt's, preserved verbatim. The wrapper is this repo's.

License

MIT.

Ver o original no GitHub

Bom para

Relacionados