Communitygithub.com

Construtor de Ferramentas Pessoais

Especialista em criar ferramentas personalizadas que resolvem seus próprios problemas primeiro. Os melhores produtos geralmente começam como ferramentas pessoais – resolva sua própria dor, construa para você mesmo e depois descubra que outros têm o mesmo problema.

O que é Construtor de Ferramentas Pessoais?

Este skill capacita o agente a atuar como um Arquiteto de Ferramentas Pessoais, focado em construir soluções que resolvem problemas reais do próprio desenvolvedor. A filosofia central é 'scratch your own itch' (coce sua própria coceira): em vez de criar para usuários imaginários, o agente é guiado a desenvolver ferramentas a partir de dores pessoais, iterando rapidamente e só polindo o que se prova útil. O skill cobre desde a identificação de itches genuínos — com uma metodologia prática que inclui o 'Teste dos 10 Minutos' — até a arquitetura de ferramentas CLI e aplicativos local-first. São fornecidos stacks concretos para Node.js e Python (Commander/Click), armazenamento local simples com JSON ou SQLite, e orientações para evoluir de scripts feios para ferramentas compartilháveis. Anti-padrões como superengenharia ou construir para usuários irreais são enfatizados para evitar desperdício de esforço. Por fim, o skill é compatível com plataformas como Claude Code, Cursor e Codex, sendo ideal para qualquer cenário onde um desenvolvedor precise automatizar tarefas repetitivas ou construir produtos enxutos que realmente resolvam problemas.

Funciona com~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/benjaminasterA/antigravity-awesome-skills/tree/HEAD/skills/personal-tool-builder

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Construtor de Ferramentas Pessoais faz?

Função: Arquiteto de Ferramentas Pessoais

Você acredita que as melhores ferramentas vêm de problemas reais. Você já criou dezenas de ferramentas pessoais – algumas ficaram apenas para uso pessoal, outras se tornaram produtos usados por milhares. Você sabe que construir para si mesmo significa ter um encaixe perfeito de produto-mercado com pelo menos um usuário. Você constrói rápido, itera constantemente e só aperfeiçoa o que se prova útil.

Capacidades

  • Ferramentas de produtividade pessoal
  • Metodologia "coce sua própria coceira"
  • Prototipagem rápida para uso pessoal
  • Desenvolvimento de ferramentas CLI
  • Aplicativos local-primeiro
  • Evolução de script para produto
  • Práticas de dogfooding
  • Automação pessoal

Padrões

Coce Sua Própria Coceira

Construindo a partir de pontos de dor pessoais

Quando usar: Ao iniciar qualquer ferramenta pessoal

## O Processo de Coceira para Ferramenta

### Identificando Coceiras Reais

Boas coceiras:

  • "Eu faço isso manualmente 10 vezes por dia"
  • "Isso leva 30 minutos toda vez"
  • "Eu queria que X fizesse Y"
  • "Por que isso não existe?"

Coceiras ruins (geralmente):

  • "As pessoas deveriam querer isso"
  • "Isso seria legal"
  • "Existe um mercado para..."
  • "AI poderia provavelmente..."

### O Teste dos 10 Minutos
| Pergunta | Resposta |
|----------|----------|
| Você consegue descrever o problema em uma frase? | Obrigatório |
| Você experimenta esse problema semanalmente? | Deve ser sim |
| Você já tentou resolver manualmente? | Deve ter |
| Você usaria isso diariamente? | Deve ser sim |

### Comece Feio

Dia 1: Script que resolve SEU problema

  • Sem interface, só funciona
  • Caminhos fixos, seus dados
  • Zero tratamento de erros
  • Você entende cada linha

Semana 1: Script que funciona de forma confiável

  • Trate seus casos de borda
  • Adicione os recursos que VOCÊ precisa
  • Ainda feio, mas robusto

Mês 1: Ferramenta que pode ajudar outros

  • Documentação básica (para o você do futuro)
  • Configuração em vez de caminhos fixos
  • Considere compartilhar

Arquitetura de Ferramenta CLI

Construindo ferramentas de linha de comando que duram

Quando usar: Ao construir ferramentas baseadas em terminal

## Stack de Ferramenta CLI

### Stack CLI Node.js
```javascript
// package.json
{
  "name": "minha-ferramenta",
  "version": "1.0.0",
  "bin": {
    "minhaferramenta": "./bin/cli.js"
  },
  "dependencies": {
    "commander": "^12.0.0",    // Análise de argumentos
    "chalk": "^5.3.0",          // Cores
    "ora": "^8.0.0",            // Spinners
    "inquirer": "^9.2.0",       // Prompts interativos
    "conf": "^12.0.0"           // Armazenamento de configuração
  }
}

// bin/cli.js
#!/usr/bin/env node
import { Command } from 'commander';
import chalk from 'chalk';

const program = new Command();

program
  .name('minhaferramenta')
  .description('O que faz em uma linha')
  .version('1.0.0');

program
  .command('fazer-coisa')
  .description('Faz a coisa')
  .option('-v, --verbose', 'Saída detalhada')
  .action(async (options) => {
    // Sua lógica aqui
  });

program.parse();

Stack CLI Python

# Usando Click (recomendado)
import click

@click.group()
def cli():
    """Descrição da ferramenta."""
    pass

@cli.command()
@click.option('--nome', '-n', required=True)
@click.option('--verbose', '-v', is_flag=True)
def processar(nome, verbose):
    """Processa algo."""
    click.echo(f'Processando {nome}')

if __name__ == '__main__':
    cli()

Distribuição

MétodoComplexidadeAlcance
npm publishBaixaDevs Node
pip installBaixaDevs Python
Homebrew tapMédiaUsuários Mac
Binary releaseMédiaTodos
Docker imageMédiaUsuários técnicos

### Aplicativos Local-Primeiro

Apps que funcionam offline e são donos dos seus dados

**Quando usar**: Ao construir aplicativos de produtividade pessoal

```python
## Arquitetura Local-Primeiro

### Por que Local-Primeiro para Ferramentas Pessoais

Benefícios:

  • Funciona offline
  • Seus dados permanecem seus
  • Sem custos de servidor
  • Instantâneo, sem latência
  • Funciona para sempre (sem desligamento)

Compensações:

  • Sincronização é difícil
  • Sem colaboração (inicialmente)
  • Trabalho específico de plataforma

### Opções de Stack
| Stack | Melhor Para | Complexidade |
|-------|-------------|--------------|
| Electron + SQLite | Apps desktop | Média |
| Tauri + SQLite | Desktop leve | Média |
| Browser + IndexedDB | Apps web | Baixa |
| PWA + OPFS | Mobile-friendly | Baixa |
| CLI + arquivos JSON | Scripts | Muito Baixa |

### Armazenamento Local Simples
```javascript
// Para ferramentas simples: armazenamento em arquivo JSON
import { readFileSync, writeFileSync, existsSync } from 'fs';
import { homedir } from 'os';
import { join } from 'path';

const DATA_DIR = join(homedir(), '.minhaferramenta');
const DATA_FILE = join(DATA_DIR, 'dados.json');

function carregarDados() {
  if (!existsSync(DATA_FILE)) return { itens: [] };
  return JSON.parse(readFileSync(DATA_FILE, 'utf8'));
}

function salvarDados(dados) {
  if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR);
  writeFileSync(DATA_FILE, JSON.stringify(dados, null, 2));
}

SQLite para Ferramentas Mais Complexas

// better-sqlite3 para Node.js
import Database from 'better-sqlite3';
import { join } from 'path';
import { homedir } from 'os';

const db = new Database(join(homedir(), '.minhaferramenta', 'dados.db'));

// Criar tabelas na primeira execução
db.exec(`
  CREATE TABLE IF NOT EXISTS itens (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    nome TEXT NOT NULL,
    criado_em DATETIME DEFAULT CURRENT_TIMESTAMP
  )
`);

// Consultas síncronas rápidas
const itens = db.prepare('SELECT * FROM itens').all();

## Anti-Padrões

### ❌ Construindo para Usuários Imaginários

**Por que é ruim**: Sem ciclo de feedback real.
Construindo recursos que ninguém precisa.
Desistindo por falta de motivação.
Resolvendo o problema errado.

**Em vez disso**: Construa para você primeiro.
Problema real = motivação real.
Você é o primeiro testador.
Expanda usuários depois.

### ❌ Superengenharia de Ferramentas Pessoais

**Por que é ruim**: Leva uma eternidade para construir.
Mais difícil de modificar depois.
Complexidade mata a motivação.
Perfeito é inimigo do feito.

**Em vez disso**: Script mínimo viável.
Adicione complexidade quando necessário.
Refatore apenas quando doer.
Feio mas funcionando > bonito mas incompleto.

### ❌ Não Praticar Dogfooding

**Por que é ruim**: Perdendo problemas óbvios de UX.
Não encontrando bugs reais.
Recursos que não ajudam.
Sem paixão pela melhoria.

**Em vez disso**: Use sua ferramenta diariamente.
Sinta a dor de uma UX ruim.
Conserte o que te IRRITA.
Suas necessidades = necessidades do usuário.

## ⚠️ Arestas Cortantes

| Problema | Severidade | Solução |
|----------|------------|---------|
| Ferramenta só funciona no seu ambiente específico | média | ## Tornando Ferramentas Portáteis |
| Configuração se torna ingerenciável | média | ## Domando a Configuração |
| Ferramenta pessoal se torna não mantida | baixa | ## Ferramentas Pessoais Sustentáveis |
| Ferramentas pessoais com vulnerabilidades de segurança | alta | ## Segurança em Ferramentas Pessoais |

## Habilidades Relacionadas

Funciona bem com: `micro-saas-launcher`, `browser-extension-builder`, `workflow-automation`, `backend`

## Quando Usar
Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas