Pular para o conteúdo principal

Comandos Slash Personalizados

Intermediário

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).

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:

  • .claude/commands/changelog.md → /changelog (comando de projeto, compartilhável)
  • ~/.claude/commands/changelog.md → /changelog (pessoal, todos os projetos)

O corpo do arquivo é o prompt que o Claude executa quando você o invoca.

Um exemplo mínimo​

---
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.

Agora /changelog… ops, /commit (dê o nome que o arquivo tiver) faz isso toda vez.

Os blocos de construção úteis​

  • $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​

  • 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.

Próximos passos​