funny910/trista-codex-skills

O que trista-codex-skills faz?

Habilidades nativas do Codex para implementação com escopo definido, revisão somente leitura e verificação baseada em evidências.

Fluxo de Trabalho

1. Solicitação do Usuário: O usuário fornece uma tarefa no prompt, incluindo palavras-chave de gatilho ou instruções.
2. Seleção de Modo: O agente Codex determina o modo (Implementação, Revisão ou Verificação) com base na solicitação do usuário.
3. Execução da Ação: O agente executa a ação apropriada usando ferramentas nativas do Codex (por exemplo, Read, Edit, Bash, Grep).
4. Verificação (Modo de Implementação): Após a implementação, uma verificação baseada em evidências é executada automaticamente.

Modos de Habilidade

1. Implementação com Escopo Definido

• Gatilho: O usuário pede para implementar uma tarefa com escopo específico. Palavras-chave: "implementar", "adicionar", "modificar", "corrigir", etc.
• Comportamento: O agente foca estritamente no escopo definido. Ele usa ferramentas do Codex (Read, Edit, Bash) para fazer as alterações necessárias. Nenhuma modificação não solicitada ou refatoração é permitida.
• Resultado: Código modificado dentro do escopo. Uma verificação baseada em evidências é então iniciada.

2. Revisão Somente Leitura

• Gatilho: O usuário pede para "revisar" ou "auditar" o código. Palavras-chave: "revisar", "revisão de código", "auditar", "verificar", "inspecionar".
• Comportamento: O agente NÃO faz alterações. Ele lê arquivos, executa grep e coleta informações para entender o código. Ele fornece feedback, identifica problemas e sugere melhorias sem tocar no sistema de arquivos.
• Resultado: Um relatório ou lista de descobertas, sem alterações de código.

3. Verificação Baseada em Evidências

• Gatilho: Executado automaticamente após uma Implementação com Escopo Definido ou quando o usuário pede especificamente para "verificar" ou "validar". Palavras-chave: "verificar", "validar", "confirmar".
• Comportamento:
  1. Coleta de Evidências: O agente lê arquivos de código relevantes (modificados e dependentes), verifica erros de sintaxe usando ferramentas, executa testes (se existirem) e verifica casos de borda.
  2. Análise de Plausibilidade: O agente reflete sobre se as alterações fazem sentido dentro da base de código maior, verificando tipos, funções e fluxos de dados.
  3. Relatório: O agente fornece um resumo do que foi alterado, a evidência coletada e uma avaliação de confiança da correção.
• Resultado: Um relatório de verificação com confiança alta, média ou baixa.

Exemplos de Prompt

• Implementar: Adicione uma função para validar e-mails em /src/utils/validation.py
• Revisar: Revise /src/api/handlers.py para possíveis bugs
• Verificar: Verifique a última alteração que você fez em /src/models/user.py

Notas

• Esta skill depende das ferramentas nativas do Codex (Read, Edit, Bash, Grep, etc.).
• A sequência exata de ferramentas usada pode variar dependendo da implementação do Codex.
• Uma forte ênfase é colocada em não fazer suposições não solicitadas ou alterações fora do escopo.
• A Verificação Baseada em Evidências é a chave para garantir que mudanças rápidas não quebrem outras partes do sistema.