🎯 Casos de Uso Reais

SKILL.md Simplificado

---
name: code-reviewer
description: Reviews code changes for quality,
  bugs, and best practices. Use when user asks
  to review, check, or analyze code changes,
  pull requests, or diffs.
allowed-tools: Read, Bash(git:*), Grep
---

# Code Reviewer

## Quando Usar
- Usuario pede review de PR/MR
- Usuario quer feedback sobre mudancas
- Verificacao pre-commit

## Processo
1. Use `git diff` para obter mudancas
2. Analise cada arquivo modificado
3. Identifique:
   - Bugs potenciais
   - Violacoes de estilo
   - Codigo duplicado
   - Faltas de teste
4. Forneca feedback estruturado

## Formato de Output
```
## Review Summary
- Files changed: X
- Issues found: Y

## Critical Issues
[lista]

## Suggestions
[lista]

## Approved: Yes/No
```

Estrutura da Skill

document-generator/
├── SKILL.md
├── scripts/
│   ├── generate_docx.py
│   ├── generate_xlsx.py
│   └── generate_pptx.py
├── templates/
│   ├── report_template.docx
│   └── presentation_template.pptx
└── examples/
    └── sample_output.docx

Instrucoes da Skill

## Processo TDD

Quando usuario pede para implementar feature:

### Fase RED
1. Pergunte qual comportamento desejado
2. Escreva teste que verifica o comportamento
3. Execute teste - DEVE FALHAR
4. Mostre: "Teste falha como esperado"

### Fase GREEN
5. Implemente codigo MINIMO para passar
6. Execute teste - DEVE PASSAR
7. Mostre: "Teste passa!"

### Fase REFACTOR
8. Identifique melhorias no codigo
9. Refatore mantendo testes passando
10. Execute testes apos cada mudanca

### Regras
- NUNCA escreva codigo antes do teste
- Implementacao minima sempre
- Um comportamento por vez

Exemplo de Interacao

def test_soma():
    assert soma(2, 3) == 5  # RED - vai falhar

def soma(a, b):
    return a + b  # GREEN - minimo para passar

Estrutura da Skill

brand-identity/
├── SKILL.md
├── brand/
│   ├── colors.json       # paleta de cores
│   ├── typography.json   # fontes e tamanhos
│   └── voice.md          # tom de voz
├── templates/
│   ├── email.md
│   ├── social-post.md
│   └── presentation.md
└── examples/
    ├── good-examples/
    └── bad-examples/

Exemplo: colors.json

{
  "primary": {
    "main": "#2563EB",
    "light": "#60A5FA",
    "dark": "#1E40AF"
  },
  "secondary": {
    "main": "#10B981"
  },
  "usage": {
    "headers": "primary.main",
    "cta_buttons": "secondary.main",
    "body_text": "#374151"
  }
}

Exemplo: GitHub Actions Gerado

name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm test

Estrutura da Knowledge Base

.knowledge/
├── architecture/
│   ├── overview.md
│   ├── decisions/
│   │   ├── 001-use-typescript.md
│   │   └── 002-api-structure.md
│   └── diagrams/
├── api/
│   ├── endpoints.md
│   └── schemas/
├── conventions/
│   ├── code-style.md
│   └── git-workflow.md
└── troubleshooting/
    ├── common-errors.md
    └── debugging-guide.md