Comandos Slash Personalizados
Um comando slash personalizado empacota um prompt que você fica redigitando em um único /palavra. Defina-o uma vez; reutilize-o para sempre (e compartilhe-o com sua equipe).
- Explicar o que é um comando slash personalizado e por que ele supera redigitar um prompt
- Criar um comando colocando um arquivo Markdown no diretório certo
- Distinguir comandos de projeto dos pessoais pela sua localização
- Usar os blocos de construção: $ARGUMENTS, saída de bash incorporada, referências de arquivo e frontmatter
- Escolher entre um comando slash, uma skill e um subagente para uma dada tarefa
Como funcionam
Um comando é apenas um arquivo Markdown. Coloque-o no seu diretório de comandos e o nome do arquivo se torna o comando. O corpo do arquivo é o prompt que o Claude executa quando você o invoca.
A localização do arquivo decide o seu escopo:
- Salve-o em .claude/commands/changelog.md → /changelog. Ele vive no repositório, então toda a equipe o recebe.
- Salve-o em ~/.claude/commands/changelog.md → /changelog. Ele acompanha você em todos os projetos da sua máquina.
- Digite a /palavra no Claude Code. O corpo do arquivo se torna o prompt que o Claude executa.
- O nome do arquivo — não o frontmatter — se torna o nome do comando. changelog.md é sempre /changelog.
Um exemplo mínimo
Aqui está um arquivo de comando completo. O frontmatter contém a description; tudo abaixo dele é o prompt.
commit.md — redigir um Conventional Commit
--- description: Draft a Conventional Commit message from the staged diff --- Look at the staged changes with `git diff --cached` and write a single Conventional Commit message (feat/fix/docs/refactor/chore). Output only the message, no preamble.
Salve isso como commit.md e /commit faz isso toda vez. (Dê a ele o nome que o arquivo tiver — o mesmo corpo salvo como changelog.md seria /changelog.)
Os blocos de construção úteis
Quatro ingredientes transformam um prompt estático em um comando flexível:
| Bloco de construção | O que faz |
|---|---|
$ARGUMENTS | Injeta o que o usuário digitou após o comando. /review src/auth.ts → o caminho cai no seu prompt. |
| Execute bash e incorpore a saída | Os comandos podem incluir a saída de shell (por exemplo, o diff atual) para que o Claude aja sobre o estado ao vivo. |
| Referencie arquivos | Aponte para arquivos para incluir seu conteúdo. |
| Frontmatter | description (exibida no menu) e outras opções. |
Veja a documentação oficial para a sintaxe exata de argumentos, bash e referências de arquivo.
Comandos que vale a pena copiar
Um conjunto inicial fica na nossa Biblioteca de Comandos Slash: mensagem de commit, descrição de PR, revisão de código, changelog, scaffold de um componente.
Comando vs skill vs subagente
Três formas de empacotar trabalho — a diferença está em quem o aciona e quão isolado ele roda:
- Comando slash — você aciona um fluxo de trabalho conhecido sob demanda.
- Skill — o Claude carrega expertise automaticamente quando relevante.
- Subagente — delega uma parte do trabalho a um agente isolado.