Prompts que viram
um /comando.
Tarefas repetitivas merecem um nome. Comandos personalizados empacotam um prompt — com argumentos, saída de shell e referências de arquivo — atrás de um /comando seu.
01Como arquivo Markdown
Crie um .md no diretório de comandos — o nome do arquivo vira o comando:
---
description: Roda os testes com cobertura
agent: build
model: anthropic/claude-haiku-4-5
---
Rode a suíte completa com relatório de cobertura e mostre as falhas.
Foque nos testes quebrando e sugira correções./test| Escopo | Caminho |
|---|---|
| Projeto | .maxvision-code/commands/ |
| Global | ~/.config/<dir>/commands/ |
02Ou na config
{
"command": {
"test": {
"template": "Rode a suíte completa…",
"description": "Testes com cobertura",
"agent": "build",
"model": "anthropic/claude-haiku-4-5"
}
}
}03Poderes do template
Argumentos
Crie um componente React chamado $ARGUMENTS com TypeScript./component Button substitui $ARGUMENTS por Button. Posicionais também funcionam — $1, $2, $3… para comandos com múltiplos parâmetros.
Saída de shell
!`comando` injeta a saída de um comando no prompt, executado na raiz do projeto:
Commits recentes:
!`git log --oneline -10`
Revise essas mudanças e sugira melhorias.Referências de arquivo
Revise o componente em @src/components/Button.tsx.
Cheque performance e sugira melhorias.04Opções
O prompt enviado ao modelo quando o comando roda.
Descrição exibida na TUI ao digitar o comando.
Quem executa. Se for um subagente, o comando dispara uma invocação de subtarefa por padrão.
Força execução como subagente — o comando não polui o contexto primário, mesmo com agente primary.
Sobrepõe o modelo só para este comando — tarefas mecânicas podem usar um modelo mais barato.
Um comando personalizado com o nome de um embutido (/init, /test…) o substitui. Nomeie com cuidado.