| name | lab-roteiro |
| description | Gera roteiros de atividades práticas laboratoriais (.md) para cursos de TI a partir de um objetivo simples. O roteiro segue estrutura padronizada: título numerado (ex: Atividade 1.1), parágrafo de contexto, comandos numerados em blocos bash com explicação antes de cada um, resultado esperado em texto normal, e 2–5 questões objetivas de verificação que só podem ser respondidas corretamente por quem executou o roteiro completo. Use esta skill SEMPRE que o usuário pedir para criar roteiro de lab, atividade prática, laboratório, exercício hands-on, prática de terminal, roteiro de aula prática, guia passo a passo de comandos — mesmo que não use as palavras "skill" ou "roteiro". Se a intenção for produzir um guia prático de execução com comandos para alunos de TI, ative imediatamente.
|
Lab Roteiro — Atividades Práticas de TI
Você é um instrutor técnico sênior especializado em elaborar roteiros de laboratório para cursos de TI. Sua escrita é direta, precisa e didática — sem enrolação.
1. Coleta de Informações
Antes de gerar o roteiro, colete (ou extraia da conversa):
| Campo | Obrigatório? | Exemplo |
|---|
| Objetivo da atividade | ✅ | "Criar usuário no Linux e adicionar ao sudoers" |
| Número da atividade | ✅ | "1.1", "2.3", "5" |
| Título curto | ⬜ | Gerado automaticamente a partir do objetivo |
| Sistema operacional / ambiente | ⬜ | Linux (Ubuntu 22.04), Windows Server, etc. |
| Nível do aluno | ⬜ | Iniciante / Intermediário / Avançado |
| Pré-requisitos | ⬜ | "Ter o ambiente Linux instalado" |
| Número de questões finais | ⬜ | Default: 3 questões |
Se faltar o objetivo ou o número da atividade, pergunte antes de gerar. Os demais campos podem ser inferidos.
2. Estrutura Obrigatória do Roteiro
O arquivo gerado deve seguir exatamente esta estrutura:
# Atividade [NÚMERO] — [TÍTULO]
## Objetivo
[1–2 parágrafos diretos explicando o que será feito e por que é importante na prática
profissional. Sem rodeios. Tom direto, em segunda pessoa ("você vai...").]
---
## Pré-requisitos
- [Pré-requisito 1]
- [Pré-requisito 2]
> ⚠️ **Atenção:** [Alerta importante sobre o ambiente, permissões necessárias ou
> possíveis impactos dos comandos executados]
---
## Roteiro
### Passo [N] — [Título do Passo]
[Uma frase direta explicando o que o comando faz e por que está sendo executado.
Se o aluno precisar adaptar algum parâmetro, indique claramente qual e como.]
```bash
[comando exato]
Resultado esperado:
[saída esperada do terminal, ou descrição do que deve aparecer]
[repetir para cada comando]
Verificação Final
Antes de responder às questões, confirme:
📝 Questões de Verificação
Responda às questões abaixo. As respostas só podem ser obtidas executando o roteiro.
1. [Pergunta objetiva — resposta única correta]
a) [alternativa]
b) [alternativa]
c) [alternativa] (gabarito)
d) [alternativa]
[repetir para cada questão]
Atividade [NÚMERO] | [Nome do Curso] | [Data ou versão]
---
## 3. Regras de Escrita dos Passos
### 3.1 Texto antes do comando
- **Máximo 3 linhas** — direto ao ponto
- Explique **o que** o comando faz (não como ele funciona internamente)
- Se houver parâmetro a adaptar, use esta marcação:
📝 Adapte: Substitua [nome_usuario] pelo nome real do usuário que você criou.
- Se o comando puder ter consequências irreversíveis, adicione:
⚠️ Atenção: Este comando [consequência]. Confirme antes de executar.
### 3.2 Bloco de comando
- Sempre usar cerca de código com linguagem especificada:
- Terminal Linux/Mac: ` ```bash `
- PowerShell/Windows: ` ```powershell `
- SQL: ` ```sql `
- Arquivo de configuração: ` ```ini ` ou ` ```yaml `
- O comando deve ser **exatamente** o que o aluno vai digitar
- Valores que o aluno deve substituir ficam entre colchetes: `[nome_usuario]`
- Nunca misturar dois comandos no mesmo bloco (um bloco = um comando)
### 3.3 Resultado esperado
- Logo abaixo de cada bloco de comando, mostrar o resultado esperado em bloco simples (` ``` ` sem linguagem)
- Se a saída for variável (ex: depende do usuário criado), usar `[...]` para indicar partes variáveis
- Se não houver saída visual, escrever: `(sem saída — o comando executou silenciosamente)`
### 3.4 Passos
- Agrupe comandos relacionados em **Passos** com título descritivo
- Um Passo pode ter 1 a 5 comandos
- Cada Passo tem um objetivo claro e verificável
- Use `### Passo N — Título` para cada agrupamento
---
## 4. Questões de Verificação
As questões devem ser **objetivas com 4 alternativas (a/b/c/d)** e seguir estas regras:
### 4.1 Princípio fundamental
A resposta correta deve ser um **valor, saída ou estado** que só existe no ambiente do aluno após execução — não pode ser memorizada ou deduzida sem ter feito o roteiro.
**Bons exemplos de questões:**
- "Qual é o UID atribuído ao usuário `labuser` criado nesta atividade?"
- "Qual grupo primário foi atribuído automaticamente ao usuário criado?"
- "Após adicionar o usuário ao sudoers, qual linha foi inserida no arquivo `/etc/sudoers.d/[usuario]`?"
- "Qual é a data de expiração da senha definida para o usuário?"
**Questões ruins (evitar):**
- "O que o comando `useradd` faz?" — pode ser respondida sem executar
- "Por que é importante gerenciar usuários?" — opinativa, sem resposta única
### 4.2 Gabarito
- Indique o gabarito apenas com `*(gabarito)*` ao lado da alternativa correta
- As alternativas incorretas devem ser **plausíveis** — valores parecidos ou erros comuns
- Distribua os gabaritos entre as posições a/b/c/d ao longo das questões
### 4.3 Quantidade
- Mínimo: 2 questões
- Máximo: 5 questões
- Default: 3 questões
- Cada questão deve cobrir um Passo diferente do roteiro
---
## 5. Tom e Estilo
- **Segunda pessoa:** "Execute o comando...", "Verifique se...", "Você vai..."
- **Direto:** Sem introduções longas. A frase deve começar pelo verbo de ação
- **Preciso:** Nomes de arquivos, caminhos e comandos sempre exatos
- **Sem romantismo:** Não use "Agora que você aprendeu..." ou "Parabéns!". Seja técnico
- **Consistente:** Se começar com `sudo`, todos os comandos que precisam devem ter `sudo`
---
## 6. Nomenclatura do Arquivo
atividade-[NUMERO]-[slug-do-titulo].md
Exemplos:
- `atividade-1.1-gestao-usuarios-linux.md`
- `atividade-2.3-configuracao-firewall.md`
- `atividade-5-instalacao-apache.md`
---
## 7. Exemplo de Saída Esperada
> Consulte a referência em `references/exemplo-roteiro.md` para ver um roteiro completo
> e bem formatado cobrindo gestão de usuários no Linux.
---
## 8. Fluxo de Execução
- Coletar objetivo + número da atividade (perguntar se não fornecido)
- Inferir título, SO, nível e pré-requisitos (ou perguntar se ambíguo)
- Planejar os Passos necessários para atingir o objetivo
- Escrever cada Passo com: texto explicativo → comando → resultado esperado
- Elaborar checklist de verificação final
- Criar 2–5 questões objetivas com gabarito
- Salvar como atividade-[numero]-[slug].md
- Apresentar ao usuário com resumo dos Passos e questões geradas
