AULA 05 MÓDULO 0 engenharia de requisitos ⏱ 50 min

Histórias de Usuário → Prompts e Skills

Uma história bem escrita já é um prompt mal formatado. Aprenda a transformar histórias de usuário em prompts elaborados e skills reutilizáveis de IA.

formato da históriacritérios de aceitehistória → promptchain-of-thoughtskills de IA

Formato da história de usuário

Histórias de usuário descrevem funcionalidades do ponto de vista de quem usa. O formato padrão tem 3 campos: quem, o que e por quê. Cada campo é um dado estruturado.

Como [persona]
quero [ação / funcionalidade]
para [objetivo / valor]
💡
critérios de aceite — Gherkin
Dado que [contexto] / Quando [ação do usuário] / Então [resultado esperado]. Cada critério é um comportamento verificável.

Da história ao prompt elaborado

Uma história bem escrita já contém os elementos de um bom prompt de IA: persona (role), tarefa (instrução), contexto (dado que) e resultado esperado (então). A diferença é apenas o formato.

HISTÓRIA
Como gestor
quero resumo de vendas
para tomar decisões
PROMPT
Você é analista de negócios.
Dado os dados abaixo, gere
resumo em 3 bullets com
variações >10% destacadas.

Quando vira uma skill

Uma história vira skill de IA quando é recorrente, tem critérios claros, persona estável e resultado padronizável. A skill encapsula o comportamento como módulo reutilizável.

🔧
estrutura de uma skill
system prompt (contexto) + instrução principal (ação) + constraints (critérios de aceite) + formato de saída. Exatamente os campos da história, reordenados para a máquina.
javascript
// De história de usuário para skill de IA

// HISTÓRIA ORIGINAL
const historia = {
  como: "revisor de código",
  quero: "analisar pull requests automaticamente",
  para: "garantir que SOLID seja respeitado",
  criterios: [
    "Identificar violações por arquivo",
    "Sugerir refatoração específica",
    "Formato bullet points"
  ]
}

// SKILL GERADA A PARTIR DA HISTÓRIA
const skill = {
  system: "Você é revisor de código especialista em SOLID.",
  instrucao: "Analise o diff abaixo e identifique violações.",
  constraints: [
    "Organize por arquivo",
    "Para cada violação, sugira refatoração",
    "Use bullet points"
  ],
  formato: "## Arquivo\n- Violação: ...\n- Sugestão: ..."
}
quiz · aula 05
Teste seus conhecimentos
0/3 respondidas
QUESTÃO 01
Qual campo da história de usuário mapeia para o 'role' do prompt?
QUESTÃO 02
Uma história vira skill quando é...
QUESTÃO 03
O que é chain-of-thought em prompts?
0/3