← Voltar ao curso
Nível 1 — Fundamentos · Módulo 1.5 — Skills: ensine seu jeito uma vez só

1.5.3 · A descrição é o gatilho

4 min de vídeo TODOS

Objetivo: ao final, o consultor escreve descrições que acionam na hora certa e não acionam fora dela.

O que você precisa levar desta aula

  1. A descrição tem duas metades: o que a skill faz e quando usar.
  2. Use as palavras que você realmente digita, incluindo sinônimos e abreviações.
  3. Teste com três frases que devem disparar e três que não devem.

Anatomia de uma boa descrição

description: Revisa uma spec funcional antes do envio ao cliente usando o
  checklist da Wayon. Use ao revisar spec, FS, especificação funcional
  ou documento de desenho.
             ╰─────────── o que faz ───────────╯ ╰──── quando usar ────╯

Comparação

Descrição Problema
Checklist de revisão. Estreita e vaga. Não casa com como você pede
Ajuda com documentos. Larga demais. Dispara em e-mail, ata, apresentação
Revisa specs funcionais. Melhor, mas não diz quando usar nem cobre "FS"
Revisa uma spec funcional antes do envio ao cliente usando o checklist da Wayon. Use ao revisar spec, FS, especificação funcional ou documento de desenho. Boa. O que faz, quando usar, e as palavras reais

Inclua as suas palavras de verdade

Antes de escrever a descrição, liste como você pede a coisa no dia a dia. Para revisão de spec, provavelmente:

Todas essas formas precisam encontrar a skill. Se você e seus colegas usam palavras diferentes, coloque as de todos — a skill vai ser usada por eles também.

O erro oposto: descrição larga demais

Uma descrição ampla parece segura ("melhor disparar de mais que de menos") e não é. Consequências:

Sinal de descrição larga: a skill aparece carregada em situações que você não esperava.

O teste de 3 + 3

Antes de considerar a skill pronta, escreva:

Três frases que devem disparar 1. "revisa essa FS antes de eu mandar" 2. "essa spec de interface está completa?" 3. "confere esse documento de desenho de compras"

Três frases que não devem disparar 1. "escreve um e-mail pro cliente sobre o atraso" 2. "resume essa ata" 3. "revisa esse código ABAP"

A descrição está boa quando as três primeiras casam e as três últimas não. Repare na terceira do segundo grupo: "revisa" está lá, mas é revisão de código — se a sua descrição de spec pegar isso, ela está larga.

Quiz — 4 questões

1.Qual descrição funciona melhor para uma skill de revisão de spec funcional?
  • a)Revisa uma spec funcional antes do envio ao cliente usando o checklist da Wayon. Use ao revisar spec, FS, especificação funcional ou documento de desenho.

    Correto. O que faz, quando usar, e as palavras reais.

  • b)Checklist de revisão.

    Não diz o que revisa nem quando usar. Não vai casar com "revisa essa FS".

  • c)Ajuda a revisar documentos técnicos e funcionais de qualquer tipo.

    Larga demais. Vai disparar em revisão de código, de ata e de apresentação.

Ver resposta e por quê
✅a) Correto. O que faz, quando usar, e as palavras reais.
❌b) Não diz o que revisa nem quando usar. Não vai casar com "revisa essa FS".
❌c) Larga demais. Vai disparar em revisão de código, de ata e de apresentação.
2.Sua skill de revisão de spec está sendo carregada quando você pede para revisar código ABAP. O problema é:
  • a)O corpo da skill está genérico

    O corpo não influencia o disparo — ele só entra depois que a skill é acionada.

  • b)Você tem skills demais

    A quantidade não causa disparo errado. A descrição causa.

  • c)A descrição está larga demais e pega "revisar" em contextos que não são dela

    Correto. Estreite a descrição para nomear explicitamente spec funcional.

Ver resposta e por quê
❌a) O corpo não influencia o disparo — ele só entra depois que a skill é acionada.
❌b) A quantidade não causa disparo errado. A descrição causa.
✅c) Correto. Estreite a descrição para nomear explicitamente spec funcional.
3.Você usa "FS" no dia a dia; seu colega usa "spec"; o cliente escreve "documento de desenho". A descrição deve:
  • a)Conter apenas o termo oficial, "especificação funcional"

    Ninguém digita o termo oficial no dia a dia. A skill quase nunca vai disparar.

  • b)Conter as três formas

    Correto. Todas precisam encontrar a skill, e ela vai ser usada pelos seus colegas também.

  • c)Não conter nenhum termo específico, para ser genérica

    Descrição genérica é descrição larga: dispara onde não deve e não dispara onde deve.

Ver resposta e por quê
❌a) Ninguém digita o termo oficial no dia a dia. A skill quase nunca vai disparar.
✅b) Correto. Todas precisam encontrar a skill, e ela vai ser usada pelos seus colegas também.
❌c) Descrição genérica é descrição larga: dispara onde não deve e não dispara onde deve.
4.Qual é o teste mais rápido para saber se a descrição está boa? ---
  • a)Ler em voz alta e ver se soa profissional

    Não tem relação com o mecanismo de disparo.

  • b)Escrever três frases que devem disparar e três que não devem, e conferir

    Correto. Testa os dois erros — estreita demais e larga demais — em dois minutos.

  • c)Pedir para o Claude avaliar a descrição

    Ele pode ajudar a redigir, mas o teste real é confrontar com as frases que você usa de verdade.

Ver resposta e por quê
❌a) Não tem relação com o mecanismo de disparo.
✅b) Correto. Testa os dois erros — estreita demais e larga demais — em dois minutos.
❌c) Ele pode ajudar a redigir, mas o teste real é confrontar com as frases que você usa de verdade.