Claude Code: do zero à prática · Capítulo 10 de 23 · 6 min
Planejar mudanças e reutilizar um procedimento
Use um plano para revisar decisões e transforme uma tarefa repetida em instruções reutilizáveis.
Este capítulo faz parte do curso gratuito Claude Code: do zero à prática.
Use o modo de planejamento para revisar uma mudança antes de alterar vários arquivos. Depois guarde o roteiro do resumo em uma skill, um procedimento reutilizável.
Planejar uma mudança
Na pasta de treino já há anotações, versões do resumo e um rascunho. Antes de separar esse material em subpastas, entre no modo Plan, ou planejamento, usando o seletor da sessão ou Shift + Tab. Confira o nome mostrado na interface. Escrever apenas “você está em modo de plano” num pedido não é a mesma coisa que selecionar esse modo.
Leia o plano procurando consequências. Se as anotações forem movidas, os pedidos que citam seu nome sem caminho podem precisar de ajuste. Se uma pasta se chamar “aprovados”, alguém precisa dizer quais documentos foram de fato conferidos. Na simulação, uma decisão razoável é manter os arquivos no lugar por enquanto: o volume ainda é pequeno. Planejar também serve para concluir que uma mudança não compensa. Você pode recusar a execução e continuar com a estrutura atual.
O modo de planejamento foi feito para pesquisar e propor mudanças sem editar os arquivos de trabalho antes da aprovação. Ele ainda pode usar ferramentas para explorar e registrar o plano. Ao aprovar, leia qual modo de execução será ativado; escolher uma opção automática muda a necessidade de confirmações posteriores. Para este aprendizado, acompanhe as edições manualmente.
Guardar o procedimento
Uma skill é um conjunto de instruções reutilizáveis. No Claude Code, pode ser um arquivo SKILL.md dentro de uma pasta de skills do projeto. O corpo desse procedimento é carregado quando a skill é usada. Ela é útil quando você repete um roteiro, como transformar anotações em resumo; regras gerais de idioma e preservação continuam no CLAUDE.md.
Volte ao modo Manual e peça ao Claude que crie .claude/skills/resumo-reuniao/SKILL.md com o conteúdo abaixo, sem alterar os outros arquivos. O ponto no começo de .claude faz parte do nome da pasta; o caminho indica uma pasta dentro da outra. A opção disable-model-invocation: true reserva a execução desta skill para quando você a chamar, o que facilita observar o teste.
---
name: resumo-reuniao
description: Prepara um resumo conferível de anotações de reunião, preservando decisões, responsáveis, prazos e condições.
disable-model-invocation: true
---
Leia o arquivo de anotações e use o nome de saída informados pelo usuário.
Se algum dos dois nomes faltar, pergunte antes de gravar.
Separe decisões, pendências e informações em aberto.
Preserve os responsáveis, os prazos e as condições do material.
Não transforme sugestão em decisão nem preencha informação ausente.
Mantenha a identificação de simulação quando ela existir na origem.
Crie somente o arquivo de saída combinado. Se ele existir, pare antes de substituir.
Leia o resultado salvo e compare todos os compromissos com as anotações.
Informe o caminho do arquivo e as divergências encontradas.
Não envie mensagens nem publique o resultado.Confira o arquivo criado. Abra uma nova sessão na mesma pasta e digite o comando abaixo dentro do Claude Code. O nome depois da barra chama a skill; o restante informa entrada e saída. O destino é novo para não substituir o resumo que já foi conferido.
/resumo-reuniao Use notas-reuniao.txt e salve em resumo-reuniao-teste-skill.md.Conferência da skill
Abra o resultado e compare formato, responsáveis e condições com as notas. Confira se os arquivos anteriores foram preservados. Repita com anotações sem prazo e com uma pendência sem responsável: a saída deve indicar o dado ausente.
Escolher outros recursos quando houver necessidade
MCP, sigla de Model Context Protocol, conecta o assistente a ferramentas e fontes de dados externas. Ele entra quando o material necessário está num serviço, e não nos arquivos da pasta. Antes de conectar, identifique a conta e as permissões de leitura ou escrita. Nosso resumo funciona sem conexão externa; adicionar uma não melhora o resultado por si.
Um subagente recebe uma parte do trabalho e devolve o resultado ao agente principal. Use essa divisão para tarefas independentes, como ler dois relatórios separados. Defina quem cuida de cada arquivo e quem reúne os resultados. Em projetos de código, cópias de trabalho chamadas worktrees ajudam a separar as alterações.
Um hook executa uma ação num evento definido, como verificar uma edição antes de ela ocorrer. Quem configura o ambiente deve testar os caminhos permitidos e bloqueados. Por exemplo: uma tentativa de publicar sem aprovação deve ser recusada, enquanto salvar o rascunho continua permitido.
Plugins reúnem recursos como skills, hooks e conexões num pacote. Antes de instalar um, identifique qual tarefa ele resolve, que acessos pede e de onde sai o consumo.
Para encerrar a prática, use a skill numa sessão nova e abra o arquivo produzido. Confira se as decisões, os responsáveis e as condições continuam iguais aos das anotações.
Anotações pessoais (opcional)
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Terminou a leitura?
Você está aqui: capítulo 10 de 23
0 de 23 concluídos
- Próximo · Capítulo 11 de 23 · 5 minEscolher uma tarefa de trabalho para delegar ao ClaudeLer o capítulo 11 sem concluir
Marque como concluído para o capítulo contar no seu painel e no certificado.
- Anterior · Capítulo 9 de 23 · 4 minGuardar as regras do projeto em CLAUDE.mdVoltar para o capítulo 9