cf-x/project-handoff-skill

Handoff de Projeto

Crie um instantâneo atual que permita que um novo agente continue o trabalho sem a conversa. Não limpe a conversa por conta própria.

1. Resolver o destino

Determine o destino do handoff antes de escrever:

1. Prefira um diretório explícito fornecido com a invocação. Normalize-o e verifique se ele existe.
2. Caso contrário, infira candidatos a partir de diretórios e arquivos realmente discutidos, lidos, criados ou editados nesta sessão.
3. Trate o diretório de trabalho atual, a raiz do workspace do Codex, a raiz do controle de versão e marcadores de projeto como README.md, AGENTS.md, package.json ou pyproject.toml apenas como sinais. Nenhum deles é autoritativo por si só, e um projeto não precisa usar Git.
4. Prossiga sem perguntar apenas quando um candidato for claramente apoiado pelas evidências da sessão.
5. Se o destino estiver ausente ou ambíguo, mostre os candidatos prováveis e faça uma pergunta concisa: HANDOFF.md 要写到哪个目录？ Não adivinhe.

Se vários projetos independentes foram alterados, prefira um HANDOFF.md separado para cada um e confirme seus destinos antes de escrever.

2. Inspecionar o estado real

Após resolver cada diretório de destino:

• Revise o trabalho relevante da sessão e inspecione a estrutura do destino, instruções, documentação chave, arquivos de implementação e saídas.
• Se o controle de versão existir, inspecione seu status e as alterações relevantes. Se não existir, continue sem tratar isso como um erro.
• Use evidências de teste ou validação existentes. Execute apenas verificações leves e seguras quando útil; não instale dependências ou faça alterações não relacionadas no projeto.
• Leia um HANDOFF.md existente antes de atualizá-lo. Mantenha informações ainda válidas, substitua status desatualizados e mova o trabalho recém-concluído para fora da seção de trabalho restante.

Não confie apenas na memória da conversa quando evidências do sistema de arquivos estiverem disponíveis.

3. Escrever HANDOFF.md

Crie ou atualize <destino-confirmado>/HANDOFF.md como um documento conciso de estado atual com estas seções:

# Project Handoff

> Atualizado em: AAAA-MM-DD
> Destino: /caminho/absoluto/confirmado

## Estado e estrutura atuais

## Casos concluídos

## Decisões e convenções

## Trabalho restante e próximo passo exato

## Armadilhas e becos sem saída

## Validação, riscos e perguntas em aberto

Aplique estas regras:

• Forneça resultados concretos para casos concluídos e caminhos de arquivo ou diretório relativos ao projeto.
• Registre decisões, escolhas técnicas, convenções de estilo ou nomenclatura e suas razões. Inclua locais de evidência quando útil.
• Torne o trabalho restante acionável: prioridade, arquivo ou comando inicial exato, bloqueadores e a condição para conclusão.
• Registre abordagens que falharam e por que falharam para que o próximo agente não as repita.
• Informe testes ou verificações executados e seus resultados. Diga explicitamente o que não foi verificado.
• Distinga fatos observados de alegações e inferências da sessão. Marque incertezas como 待确认; nunca invente conclusões, decisões ou resultados de teste.
• Use datas absolutas, prosa concisa e caminhos em vez de narração no estilo de transcrição.
• Nunca inclua credenciais, tokens, informações pessoais privadas, conteúdo de arquivos de ambiente ou logs brutos grandes.
• Mantenha o arquivo como o instantâneo de handoff mais recente, em vez de um histórico somente para anexação.

Modifique apenas o HANDOFF.md pretendido, a menos que o usuário solicite explicitamente outras alterações.

4. Verificar e relatar

Releia o arquivo finalizado e confirme que:

• ele está no diretório confirmado;
• cada seção obrigatória está presente;
• a próxima ação é específica o suficiente para que um novo agente comece imediatamente;
• alegações, caminhos, datas e status de validação concordam com as evidências disponíveis;
• nenhuma informação sensível foi copiada para o documento.

Relate o caminho escrito, um breve resumo e qualquer incerteza não resolvida. Pare aí para que o usuário possa revisar o handoff antes de executar manualmente /clear.