chunyun1998-sudo/session-handoff

Gera documentos de handoff de sessão para que uma nova sessão de IA possa assumir perfeitamente.

O que é session-handoff?

Esta skill gera automaticamente um documento de handoff de sessão em Markdown estruturado, projetado para que uma nova IA ou desenvolvedor humano possa continuar o trabalho a partir de onde a sessão anterior parou, sem perda de contexto. Ela é acionada por comandos como "handoff de sessão", "resumo de sessão" ou "gerar handoff", e funciona em qualquer plataforma que suporte skills (como Claude Code, Cursor ou Codex). A skill escaneia o diretório de trabalho, lê as regras do usuário (user_rules) para capturar preferências e perfil, revisa o histórico da conversa, extrai um nome de tópico (2-6 palavras em chinês), e organiza o conteúdo em 8 seções obrigatórias: resumo da sessão, perfil atualizado do usuário, trabalho concluído, progresso atual, problemas não resolvidos, regras e restrições, guia de continuação, e apêndice opcional com trechos da conversa. O arquivo gerado segue o formato "会话交接文档_Tópico_AAAAMMDD_vN.md" e é salvo na raiz do workspace, com versionamento automático caso já exista um documento com a mesma data e tópico.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add chunyun1998-sudo/session-handoff

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Session Handoff — Geração de Documento de Handoff de Sessão

Quando Chamar

Quando Chunyun (ou qualquer usuário) disser as seguintes palavras-chave, esta Skill deve ser chamada imediatamente:

  • 「handoff de sessão」
  • 「organizar sessão」
  • 「documento de handoff」
  • 「fazer handoff」
  • 「session handoff」
  • 「handoff」
  • 「gerar handoff」
  • 「resumo da sessão」
  • Qualquer expressão que indique que "a sessão atual está terminando e a próxima pessoa/AI precisa saber o que aconteceu"

Objetivo

Gerar um documento de handoff estruturado em Markdown e salvá-lo no diretório raiz do workspace. O documento deve garantir que uma IA ou humano completamente alheio ao contexto anterior possa assumir com precisão após a leitura.

Especificações de Saída

Formato do Nome do Arquivo

会话交接文档_NomeDoTópico_AAAAMMDD_vN.md
  • NomeDoTópico = Núcleo da tarefa ou tópico extraído do contexto da sessão, sugerido 2-6 palavras em chinês, removendo caracteres especiais como dois-pontos, travessões, etc., com palavras separadas por underline. Se não for possível extrair um tópico claro, use SemClassificação
  • AAAAMMDD = Data do dia
  • vN = Número da versão, começando em v1. Se já existir no workspace um documento com a mesma data e tópico, incremente o número da versão

8 Seções Obrigatórias

#SeçãoConteúdo Obrigatório
1Resumo da SessãoObjetivo da sessão, período, lista de principais resultados
2Perfil Mais Recente do UsuárioExtraído de user_rules; se não houver regras, inferir a partir do diálogo e anotar como "Inferido"
3Trabalho ConcluídoO que foi feito exatamente, quais arquivos foram produzidos (com caminhos e nomes de arquivo), dados ou resultados chave
4Progresso AtualAté onde se chegou, o que foi confirmado, o que precisa ser avançado
5Problemas Não ResolvidosPontos de bloqueio, decisões pendentes, conteúdo que precisa de mais pesquisa, dívida técnica remanescente
6Regras e RestriçõesLimites imutáveis confirmados nesta sessão (padrões de nomenclatura, palavras proibidas na escrita, limitações de ferramentas, etc.)
7Guia de Continuação para Nova SessãoQual deve ser a primeira ação no próximo passo, por onde começar, quais cuidados tomar
8Apêndice da Conversa Original (Opcional)Trechos ou citações chave da conversa, para ajudar a nova IA a entender o contexto

Requisitos de Redação

  1. Priorizar informações do usuário: Se em user_rules houver informações de perfil de Chunyun (profissão, preferências, ecossistema de ferramentas, normas de escrita, etc.), citá-las integralmente na Seção 2, sem omitir nada
  2. Caminhos de arquivo completos: Todos os arquivos de saída mencionados devem incluir o caminho completo relativo ao workspace
  3. Marcar exceções claramente: Se alguma informação foi obtida por inferência (em vez de comunicação explícita do usuário), anotar ao lado com "🤖 Inferido"
  4. Idioma segue o usuário: O documento de handoff deve usar o idioma que Chunyun está utilizando atualmente

Fluxo de Trabalho

Usuário aciona (ex.: "Me ajude a fazer um handoff de sessão")
  ↓
① Escanear a lista de arquivos no diretório raiz do workspace
② Ler `user_rules` para obter perfil e preferências fixas
③ Revisar o contexto da conversa atual, extrair informações chave
④ Extrair o nome do tópico da sessão (2-6 palavras em chinês, para o nome do arquivo)
⑤ Organizar o conteúdo conforme as 8 seções acima
⑥ Salvar no workspace seguindo a regra de nomenclatura
  ↓
Informar ao usuário que o documento foi gerado e fornecer o link do arquivo

Exemplo de Uso

Usuário diz: "Me ajude a fazer um handoff de sessão"

A IA deve:

  1. Chamar imediatamente esta Skill
  2. Escanear os arquivos do workspace
  3. Revisar o contexto da conversa
  4. Extrair o nome do tópico, ex.: otimização_de_artigo_longo_wechat
  5. Gerar 会话交接文档_otimização_de_artigo_longo_wechat_20260719_v1.md
  6. Responder: "Chunyun, o documento de handoff foi gerado: [link]"

Usuário diz: "Organize o progresso atual para a próxima pessoa assumir"

A IA também aciona esta Skill e gera o documento de handoff padrão.

Habilidades Relacionadas