Registro de Notas de Sessão (Codex-SessionNotes-Skill)

Registrar Nota de Desenvolvimento

Visão Geral

Use esta habilidade apenas quando a mensagem do usuário incluir explicitamente a invocação literal $log-dev-note.

A habilidade transforma o contexto atual da sessão do Codex em um registro de engenharia conciso e o retorna em um formato limpo e pronto para cópia manual.

Contrato de Acionamento

• Acionar apenas no comando literal $log-dev-note.
• Não acionar por correspondência semântica, paráfrases ou solicitações gerais de anotações.
• Tratar qualquer texto não vazio após $log-dev-note na mesma linha como uma substituição opcional de título.
• Ignorar completamente esta habilidade quando o comando estiver ausente.

Exemplos:

• $log-dev-note
• $log-dev-note Construiu Habilidade de Registro OneNote v1

Entradas

Use estas entradas para cada invocação:

• o contexto completo da conversa atual do Codex para esta sessão
• o timestamp atual do sistema do ambiente ativo
• a substituição opcional de título fornecida pelo usuário, se presente após $log-dev-note

Prefira o contexto recente da sessão ao identificar o tópico principal, mas use a conversa completa para capturar decisões ou restrições importantes anteriores.

Saída

O destino padrão é apenas a resposta da conversa.

Regras de execução:

1. Gerar uma nova nota para cada invocação.
2. Retornar o título final e o corpo da nota em um formato limpo e pronto para cópia.
3. Não tentar automação de navegador, gravações de API ou integração com área de transferência.
4. Não fabricar quaisquer efeitos colaterais externos. A habilidade apenas gera o texto da nota.

Regras de Título

O título da nota deve usar exatamente este formato:

[AAAA-MM-DD] – <título>

Regras de construção do título:

• Usar a data atual do sistema para AAAA-MM-DD.
• Se o usuário forneceu uma substituição de título, usá-la textualmente após o travessão.
• Caso contrário, gerar um título descritivo específico baseado no tópico principal ou marco da sessão.
• Favorecer marcos concretos como Construiu Habilidade de Registro OneNote v1 em vez de títulos vagos como Trabalhou no projeto.
• Se um nome de projeto for óbvio a partir do contexto, inclua-o quando melhorar a especificidade.

Estrutura da Nota

Formatar o corpo da nota usando exatamente estes cabeçalhos no estilo markdown:

Resumo

Progresso Realizado

Decisões Chave

Estado Atual

Perguntas em Aberto / Problemas

Próximos Passos

Contexto Relevante

Regras das seções:

• Resumo: 2 a 4 frases resumindo o resultado significativo da sessão.
• Progresso Realizado: itens de lista para funcionalidades implementadas, mudanças importantes, decisões tomadas e problemas resolvidos.
• Decisões Chave: itens de lista com a decisão e breve justificativa.
• Estado Atual: itens de lista descrevendo o que é verdadeiro no final da sessão.
• Perguntas em Aberto / Problemas: itens de lista para problemas não resolvidos, riscos, bloqueadores ou ambiguidades.
• Próximos Passos: itens de lista para ações de acompanhamento imediatas e prioridades de curto prazo.
• Contexto Relevante: itens de lista para restrições, suposições, notas de arquitetura, limitações de ferramentas ou detalhes de ambiente que importam posteriormente.

Regras de Conteúdo

• Visar aproximadamente 150 a 400 palavras no total.
• Manter a nota concisa, específica e focada em documentação.
• Usar marcadores sempre que possível fora do Resumo.
• Resumir de forma inteligente; não reafirmar a conversa textualmente.
• Priorizar progresso, decisões, bloqueadores e estado atual em vez de discussão incidental.
• Ignorar conversas informais e idas e vindas irrelevantes.
• Se pouco progresso foi feito, registrar o que foi tentado e por que parou.
• Se múltiplos tópicos foram discutidos, focar no objetivo principal e agrupar itens secundários apenas se eles importarem materialmente.
• Se o contexto for ambíguo, inferir o foco principal mais provável a partir das mensagens mais recentes de alto sinal.

Melhorias opcionais quando claramente suportadas pelo contexto:

• adicionar tags de palavras-chave concisas como AI, Backend, Frontend, Habilidade Codex ou um nome de projeto
• incluir uma duração da sessão se timestamps estiverem disponíveis
• mencionar o repositório, serviço ou nome da funcionalidade quando isso melhorar materialmente a legibilidade futura

Fluxo de Trabalho de Geração

1. Confirmar que a invocação é o comando literal $log-dev-note.
2. Analisar qualquer texto posterior como a substituição opcional de título.
3. Revisar o contexto atual da sessão e identificar o objetivo principal do projeto, progresso significativo, decisões, bloqueadores e próximos passos.
4. Gerar o título da nota usando o formato de data exigido.
5. Rascunhar a nota usando os cabeçalhos de seção exatos e a estrutura concisa com muitos marcadores.
6. Retornar a nota diretamente na resposta para cópia manual.

Casos Extremos

• Se a sessão tiver pouca informação útil, criar uma nota mínima que declare explicitamente o progresso limitado.
• Se a nota estivesse vazia de outra forma, incluir pelo menos o objetivo tentado, o estado atual e o próximo passo.

Formato da Resposta

Após gerar a nota, responder brevemente com:

• o título final da nota
• o conteúdo gerado da nota