Skills: Ligação e Invocação de Ferramentas

// Exemplo de configuração de servidor MCP
{
  "mcpServers": {
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://..."
      }
    },
    "browser": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-browser"]
    }
  }
}

Análise de requisitos da tarefa → Determinar ferramentas necessárias → Ligar apenas as ferramentas necessárias

Exemplo:
┌──────────────────────┬──────────────────────────────┐
│ Tarefa               │ Ferramentas ligadas           │
├──────────────────────┼──────────────────────────────┤
│ Revisão somente leitura│ Read, Grep, Glob            │
│ Correção de código    │ Read, Edit, Bash              │
│ Refatoração de projeto│ Read, Write, Edit, Bash, Grep│
│ Deploy automático total│ Todas as ferramentas + MCP   │
└──────────────────────┴──────────────────────────────┘

## Regras de uso do Bash

Comandos permitidos:
- git status, git diff, git log
- npm test, pytest, go test
- ruff check, eslint, prettier
- docker ps, kubectl get

Comandos proibidos:
- rm -rf / (exclusão perigosa)
- curl | bash (execução de script remoto)
- Exportação de variáveis de ambiente contendo segredos
- Comandos que modificam configuração do sistema

# Ineficiente: ler um por um
1. Read src/main.py
2. Read src/utils.py
3. Read src/config.py

# Eficiente: usar Glob para determinar o escopo primeiro, depois leitura direcionada
1. Glob "src/**/*.py" → Obter lista de arquivos
2. Read arquivos-chave (entrada principal, configuração, funções utilitárias)

# Ineficiente: ler todos os arquivos às cegas
1. Read todos os arquivos .py (50+ arquivos)

# Eficiente: buscar para localizar primeiro
1. Grep "class.*View" → Encontrar todas as classes view
2. Grep "TODO|FIXME|HACK" → Encontrar dívida técnica
3. Read apenas arquivos que precisam de inspeção mais profunda a partir dos resultados da busca

---
name: tech-debt-scanner
description: "Scanner de dívida técnica, detectando TODO/FIXME/HACK e code smells"
triggers:
  - keyword: "tech-debt"
tools:
  - Grep
  - Glob
  - Read
---

# Skill de Scanner de Dívida Técnica

## Fluxo de execução
1. Use Grep para buscar comentários TODO, FIXME, HACK
2. Use Grep para buscar padrões de code smell (funções longas demais, aninhamento profundo)
3. Use Read para inspecionar detalhadamente problemas de alta prioridade
4. Exiba a lista de dívida técnica ordenada por prioridade

---
name: lint-fix
description: "Corrigir automaticamente problemas de estilo de código"
triggers:
  - keyword: "lint-fix|corrigir estilo"
tools:
  - Read
  - Bash
  - Edit
---

# Skill de Correção de Estilo de Código

## Fluxo de execução
1. Use Bash para executar o linter (seleção automática com base no tipo de projeto)
2. Analise a saída do linter
3. Para problemas com correção automática, execute linter --fix
4. Para problemas que exigem correção manual, use Edit para corrigir um a um
5. Use Bash para executar o linter novamente para verificação

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Read(*)",
      "Grep(*)",
      "Glob(*)",
      "Edit(src/**)",
      "Bash(npm test,pytest,git *)"
    ],
    "deny": [
      "Write(.env*)",
      "Bash(rm *)",
      "Bash(curl *)"
    ]
  }
}

# Limitar o escopo de uso de ferramentas no frontmatter do Skill
tools:
  - Read
  - Edit:
      paths: ["src/**", "tests/**"]
  - Bash:
      commands: ["pytest", "ruff check"]