Conteúdo DevRel

Quando Usar

Use esta habilidade quando o usuário quiser criar conteúdo técnico para desenvolvedores, incluindo posts de blog, tutoriais e documentação. Frases de gatilho incluem "escreva um post de blog", "artigo técnico", "conteúdo para desenvolvedores", "tutorial", "conteúdo devrel", "blog dev", "escrita técnica" ou "conteúdo para...

Esta habilidade ajuda você a criar conteúdo técnico que os desenvolvedores realmente leem: posts de blog, tutoriais, documentação e peças de liderança de pensamento que constroem confiança e impulsionam a adoção.

Antes de Começar

Carregue o contexto do seu público primeiro. Leia .agents/developer-audience-context.md para entender:

• Para quem você está escrevendo (cargo, senioridade, stack de tecnologia)
• Seus pontos problemáticos (quais problemas ressoam)
• Linguagem literal (como eles descrevem as coisas)
• Voz e tom (quão formal/técnico ser)

Se o arquivo de contexto não existir, execute a habilidade developer-audience-context primeiro.

A Estrutura de Conteúdo DevRel

Fase 1: Pesquisa e Validação

Antes de escrever qualquer coisa, valide se o tópico vale a pena ser escrito.

Sinais de alerta — Não escreva se:

• Você é o único que se importa com este tópico
• 10 artigos idênticos já existem
• O tópico é muito amplo ("Introdução ao JavaScript")
• O tópico é muito restrito (sem volume de busca, sem interesse da comunidade)

Fase 2: Seleção do Tipo de Conteúdo

Escolha o formato certo para o seu objetivo:

Fase 3: Estrutura do Esboço

Use este modelo de esboço:

# [Title that promises specific value]

## Hook (2-3 sentences)
- State the problem or opportunity
- Establish credibility ("We migrated 10,000 repos...")
- Promise what the reader will learn

## Context (optional)
- Brief background if needed
- Link to prerequisites

## The Meat
### Section 1: [First major concept]
- Explanation
- Code example
- Common pitfall

### Section 2: [Second major concept]
- Explanation
- Code example
- Real-world application

### Section 3: [Third major concept]
- Explanation
- Code example
- Advanced tip

## Putting It Together
- Complete example
- Working code

## What's Next
- Links to deeper content
- Call to action (try the product, join Discord, etc.)

Escrevendo Exemplos de Código

Código é o conteúdo. Faça direito.

O Teste Copiar e Colar

Todo exemplo de código deve:

Estrutura do Exemplo de Código

Primeiro, instale as dependências:

\`\`\`bash
npm install sua-biblioteca axios
\`\`\`

Agora crie um arquivo chamado `fetch-data.js`:

\`\`\`javascript
// fetch-data.js
import { Client } from 'sua-biblioteca';
import axios from 'axios';

const client = new Client({
  apiKey: process.env.SUA_CHAVE_API // Use variáveis de ambiente
});

async function fetchUserData(userId) {
  try {
    const user = await client.users.get(userId);
    console.log(`Fetched user: ${user.name}`);
    return user;
  } catch (error) {
    console.error(`Failed to fetch user: ${error.message}`);
    throw error;
  }
}

// Exemplo de uso
fetchUserData('user_123')

…