Codex use case
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.
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
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.
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.
Related links
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
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
-
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.
-
Envie o prompt inicial.
O prompt informa o nome da habilidade que você quer criar e passa para
$skill-creatora tarefa, o documento, o PR, o comando ou o resultado que deve ser preservado. -
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/skillsficam 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. -
Use a habilidade e depois atualize-a pelo chat.
Acione a nova habilidade
$skill-namena 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-cibaixa 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-conflictsfaz 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-skillorienta 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-commentstransforma 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-prototyperdefine 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
Siga uma meta
Use `/goal` quando o Codex precisar continuar trabalhando por várias interações até atingir...
Crie jogos de navegador
Use o Codex para transformar a descrição do jogo em um plano bem definido e, em seguida, em...
Crie uma CLI que o Codex possa usar
Peça ao Codex que crie uma CLI que ele possa executar de qualquer pasta, combinar com...