For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme
Codex

Codex use case

Salve fluxos de trabalho como habilidades

Crie uma habilidade que o Codex possa usar sempre que você repetir uma tarefa.

Difficulty Easy
Time horizon 5m

Transforme um chat em que o Codex já resolveu uma tarefa, regras de revisão, comandos de teste, listas de verificação de lançamento, convenções de design, exemplos de texto ou scripts específicos de um repositório em uma habilidade que o Codex possa usar em tarefas futuras.

Best for

  • Fluxos de trabalho já documentados que você quer que o Codex volte a usar.
  • Equipes que preferem reutilizar uma habilidade a colar um prompt longo em cada chat.

Contents

    ← All use cases

    Salve fluxos de trabalho como habilidades

    Crie uma habilidade que o Codex possa usar sempre que você repetir uma tarefa.

    Transforme um chat em que o Codex já resolveu uma tarefa, regras de revisão, comandos de teste, listas de verificação de lançamento, convenções de design, exemplos de texto ou scripts específicos de um repositório em uma habilidade que o Codex possa usar em tarefas futuras.

    Easy
    5m

    Transforme um chat em que o Codex já resolveu uma tarefa, regras de revisão, comandos de teste, listas de verificação de lançamento, convenções de design, exemplos de texto ou scripts específicos de um repositório em uma habilidade que o Codex possa usar em tarefas futuras.

    Easy
    5m

    Best for

    • Fluxos de trabalho já documentados que você quer que o Codex volte a usar.
    • Equipes que preferem reutilizar uma habilidade a colar um prompt longo em cada chat.

    Skills & Plugins

    • Reúna informações sobre o fluxo de trabalho, crie a estrutura inicial da habilidade, mantenha as instruções principais concisas e valide o resultado.
    Skill Why use it
    Skill Creator Reúna informações sobre o fluxo de trabalho, crie a estrutura inicial da habilidade, mantenha as instruções principais concisas e valide o resultado.

    Starter prompt

    Use $skill-creator para criar uma habilidade do Codex que [corrija falhas nas verificações do Buildkite em um PR do GitHub / transforme anotações sobre um PR em comentários de revisão nas linhas de código correspondentes / escreva nossas notas de versão com base nos PRs integrados] Use estas fontes para criar a habilidade: - Exemplo que funcionou: [diga "use este chat", inclua o link de um PR já integrado ou cole uma boa resposta do Codex] - Fonte: [cole uma conversa do Slack, um link para a revisão de um PR, a URL de um guia operacional, a URL da documentação ou um chamado] - Repositório: [caminho do repositório, se a habilidade depender de um repositório específico] - Scripts ou comandos para reutilizar: [comando de teste], [comando de pré-visualização], [script para buscar logs], [comando de lançamento] - Exemplo de bom resultado: [cole uma atualização do Slack, uma entrada do registro de alterações, um comentário de revisão, um chamado ou uma resposta final que sirva de modelo para tarefas futuras]
    Use $skill-creator para criar uma habilidade do Codex que [corrija falhas nas verificações do Buildkite em um PR do GitHub / transforme anotações sobre um PR em comentários de revisão nas linhas de código correspondentes / escreva nossas notas de versão com base nos PRs integrados] Use estas fontes para criar a habilidade: - Exemplo que funcionou: [diga "use este chat", inclua o link de um PR já integrado ou cole uma boa resposta do Codex] - Fonte: [cole uma conversa do Slack, um link para a revisão de um PR, a URL de um guia operacional, a URL da documentação ou um chamado] - Repositório: [caminho do repositório, se a habilidade depender de um repositório específico] - Scripts ou comandos para reutilizar: [comando de teste], [comando de pré-visualização], [script para buscar logs], [comando de lançamento] - Exemplo de bom resultado: [cole uma atualização do Slack, uma entrada do registro de alterações, um comentário de revisão, um chamado ou uma resposta final que sirva de modelo para tarefas futuras]

    Crie uma habilidade que o Codex possa usar sempre que precisar

    Use habilidades para dar ao Codex instruções, recursos e scripts reutilizáveis para tarefas recorrentes. Uma habilidade pode guardar a tarefa, o documento, o comando ou o exemplo que ajudou o Codex a entregar um bom resultado da primeira vez.

    Comece com um exemplo que já funcionou. Pode ser um chat em que o Codex aplicou os commits de um PR com cherry-pick, uma lista de verificação de lançamento do Notion, um conjunto de comentários úteis em PRs ou uma conversa no Slack que explica como fazer um lançamento.

    Como usar

    1. Adicione o contexto que o Codex deve usar.

      No próprio chat do Codex que você quer preservar, cole a conversa do Slack ou o link da documentação e acrescente a regra, o comando ou o exemplo que o Codex deve lembrar.

    2. Envie o prompt inicial.

      O prompt informa o nome da habilidade que você quer criar e passa para $skill-creator a tarefa, o documento, o PR, o comando ou o resultado que deve ser preservado.

    3. Deixe o Codex criar e validar a habilidade.

      O resultado deve definir o nome $skill-name, descrever quando a habilidade deve ser acionada e guardar as instruções reutilizáveis no local adequado.

      As habilidades em ~/.codex/skills ficam disponíveis em qualquer repositório. Você pode incluir as habilidades do repositório atual em um commit para que outras pessoas da equipe também possam usá-las.

    4. Use a habilidade e depois atualize-a pelo chat.

      Acione a nova habilidade $skill-name na próxima vez que trabalhar em um PR, um alerta, uma revisão, uma nota de versão ou uma tarefa de design. Se ela usar o comando de teste errado, ignorar uma regra de revisão, pular uma etapa do guia de procedimentos ou escrever um rascunho que você não enviaria, peça ao Codex que incorpore a correção à habilidade.

    Forneça material de referência

    Passe para $skill-creator o material que explica como a habilidade deve funcionar.

    O que você tem O que adicionar
    Um fluxo de trabalho de um chat do Codex que você quer preservar No mesmo chat, diga use this chat. O Codex pode usar o contexto do chat, os comandos, as edições e o feedback como ponto de partida.
    Documentação ou um guia de procedimentos Cole a lista de verificação de lançamento, compartilhe o link do guia de resposta a incidentes, anexe o PDF da API ou indique ao Codex onde está o guia em Markdown no repositório.
    Uma conversa da equipe Cole a conversa do Slack em que alguém explicou um alerta, compartilhe o link da revisão de PR com as regras de frontend ou anexe a conversa com o suporte que explica o problema do cliente.
    Scripts ou comandos que a habilidade deve reutilizar Adicione o comando de teste, o comando de pré-visualização, o script de lançamento, o script de coleta de logs ou o comando auxiliar local que o Codex deve executar em tarefas futuras.
    Um bom resultado Adicione um exemplo que sirva de modelo para tarefas futuras, como um PR já integrado, a entrada final do histórico de alterações, um comunicado de lançamento aprovado, um chamado resolvido, uma captura de tela que mostre o antes e o depois ou a resposta final do Codex.

    Se o material estiver no Slack, Linear, GitHub, Notion ou Sentry, conecte a ferramenta ao Codex com um plugin, mencione a ferramenta no prompt inicial ou cole o trecho relevante no chat.

    O que o Codex cria

    A maioria das habilidades começa com um arquivo SKILL.md. O $skill-creator pode adicionar referências mais detalhadas, scripts ou recursos quando o fluxo de trabalho exigir.

    • my-skill/
      • SKILL.md Required: instructions and metadata
      • references/ Optional: longer docs
      • scripts/ Optional: repeatable commands
      • assets/ Optional: templates and starter files

    Habilidades que você pode criar

    Use o mesmo padrão quando tarefas futuras exigirem consultar o mesmo guia de procedimentos, usar a mesma CLI, seguir os mesmos critérios de revisão, redigir o mesmo tipo de informe para a equipe ou testar o mesmo fluxo no navegador. Veja alguns exemplos.

    • $buildkite-fix-ci baixa os logs dos jobs que falharam, diagnostica o erro e propõe a menor alteração de código capaz de corrigi-lo.
    • $fix-merge-conflicts faz checkout de um PR do GitHub, atualiza o PR com as mudanças da branch base, resolve os conflitos e fornece o comando exato para fazer push.
    • $frontend-skill orienta o Codex a seguir suas preferências de interface, usar os componentes existentes, verificar o resultado a cada rodada com capturas de tela, respeitar suas escolhas de recursos visuais e fazer os ajustes finais no navegador.
    • $pr-review-comments transforma anotações de revisão em comentários concisos nas linhas correspondentes do código, com o tom adequado e links do GitHub.
    • $web-game-prototyper define o escopo do primeiro ciclo jogável, escolhe os recursos do jogo, ajusta a resposta do jogo às ações de quem joga, faz capturas de tela e refina o jogo no navegador.

    Related use cases