Comandos com argumentos: de fixos a flexiveis

De um comando fixo a um flexivel

O comando simples da aula anterior tem um limite: ele sempre faz exatamente a mesma coisa. Um comando de revisão fixo revisa, mas não sabe revisar o que. Os argumentos resolvem isso. Um argumento e um dado que você passa logo depois do nome do comando, e que o comando usa para se adaptar. Com isso, um único comando de revisão passa a servir para qualquer arquivo: você chama o comando e diz, ali na hora, qual arquivo quer revisar. O comando deixa de ser uma foto fixa e vira um molde que você preenche a cada uso.

A mágica acontece por meio de espaços reservados no texto do comando, marcas que o Claude Code troca pelo que você passar. Ha dois tipos úteis. Um deles representa todos os argumentos de uma vez: onde ele estiver no texto, entra tudo que você digitou depois do nome do comando. Os outros pegam um argumento específico pela posição, o primeiro, o segundo, e assim por diante, o que serve quando o comando espera mais de um dado em ordem, como um arquivo e um formato. Você escreve o texto do comando com esses espaços, e eles se preenchem sozinhos quando o comando roda.

Um comando, vários casos

O ganho dos argumentos e a reutilizacao. Em vez de criar um comando de revisão para cada arquivo, o que seria absurdo, você cria um só, com um espaço reservado no lugar do arquivo, e o usa para todos. O mesmo vale para um comando de resumo que recebe o tema, um de gerar teste que recebe a função, um de explicar que recebe o trecho. Um punhado de comandos flexiveis cobre um leque enorme de tarefas, porque cada um se molda ao dado que você passa. E a diferença entre ter uma ferramenta para cada parafuso e ter uma chave que se ajusta a todos.

Revise o arquivo indicado a seguir procurando problemas de segurança e clareza.
Arquivo: ARGUMENTOS
Explique cada achado e sugira a correção, sem alterar nada ainda.

Um comando de revisao flexivel: o espaco reservado recebe o arquivo que voce indicar ao chamar.

Quando o comando espera mais de um dado, os espaços reservados por posição entram em cena. Imagine um comando de gerar documento que recebe o tema e o tamanho: o primeiro argumento vira o tema, o segundo vira o tamanho, cada um no seu espaço. Ao chamar, você passa os dois em ordem. Um detalhe útil: valores com mais de uma palavra costumam precisar de aspas para contarem como um argumento só, senao cada palavra viraria um argumento separado. E um cuidado pequeno que evita confusao quando os seus argumentos tem espaços no meio.

Uma dica para não esquecer o que passar

Um comando com argumentos e poderoso, mas tem um risco: esquecer o que ele espera. Você cria um comando de revisão que recebe um arquivo e, semanas depois, não lembra se era o arquivo, o nome da função ou outra coisa. Para isso existe a dica de argumento, um texto curto que você configura no próprio comando indicando o que passar, e que aparece quando você vai chama-lo no menu. E como a etiqueta de um campo de formulário: ao digitar o comando, você vê algo como o nome do arquivo e já sabe o que preencher, sem precisar abrir o arquivo do comando para lembrar.

Com argumentos e dicas, os seus comandos ficam ao mesmo tempo flexiveis e fáceis de usar, um combo poderoso. Você já consegue automatizar tarefas recorrentes que variam por um ou dois dados, que são a maioria. A última aula do módulo mostra como levar os comandos mais longe, deixando que eles rodem checagens no seu terminal e leiam arquivos por conta própria, e faz a ponte com um tema maior: os comandos personalizados fazem parte de um sistema mais amplo, o das skills, que ganha um módulo só para ele. Você esta, sem perceber, dando os primeiros passos nesse sistema.