Tutoriais Técnicos

Guia Detalhado

Leia o guia detalhado antes de executar esta habilidade. Ele contém o procedimento completo e o material de referência. Considere seus requisitos de segurança, pré-requisitos e validação como obrigatórios. Para um trabalho focado, carregue as seções relevantes; para um trabalho de ponta a ponta, leia o guia completamente.

Quando Usar

Use esta habilidade quando precisar criar tutoriais técnicos passo a passo, guias rápidos (quickstarts) ou revisões de código (code walkthroughs). Frases de ativação incluem "tutorial", "quickstart", "guia de início rápido", "walkthrough", "passo a passo", "guia como fazer", "guia prático" ou "tutorial de código".

Esta habilidade ajuda você a criar tutoriais passo a passo que realmente funcionam. Abrange o tratamento de pré-requisitos, complexidade progressiva, seções de solução de problemas e a criação daqueles momentos satisfatórios de "funcionou!".

Tratamento de Pré-requisitos

A Seção de Pré-requisitos

Seja explícito. Não faça os desenvolvedores adivinharem o que eles precisam.

## Prerequisites

Before starting, make sure you have:

| Requirement | Version | Check Command |
|-------------|---------|---------------|
| Node.js | 18+ | `node --version` |
| npm | 9+ | `npm --version` |
| Git | Any | `git --version` |

You should also be comfortable with:
- Basic JavaScript (variables, functions, async/await)
- Command line basics (cd, mkdir, running commands)
- REST API concepts (HTTP methods, JSON)

**New to any of these?** Check out [link to prerequisite tutorial].

Seção de Configuração do Ambiente

Torne a configuração à prova de falhas:

## Setting Up Your Environment

### 1. Create Project Directory

\`\`\`bash
mkdir my-awesome-project
cd my-awesome-project
\`\`\`

### 2. Initialize the Project

\`\`\`bash
npm init -y
\`\`\`

You should see output like:
\`\`\`json
{
  "name": "my-awesome-project",
  "version": "1.0.0",
  ...
}
\`\`\`

### 3. Install Dependencies

\`\`\`bash
npm install express dotenv
\`\`\`

### 4. Verify Installation

\`\`\`bash
node -e "require('express'); console.log('Express installed!')"
\`\`\`

Expected output: `Express installed!`

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente à sua origem a montante (upstream) e ao contexto do projeto local.
• Verifique comandos, código gerado, dependências, credenciais e comportamento de serviços externos antes de aplicar alterações.
• Não trate exemplos como substitutos para testes específicos do ambiente, revisão de segurança ou aprovação do usuário para ações destrutivas ou custosas.