convez.ai
SkillAutomaçãoAvançado
lifesystemsufpr

AI Toolkit – Distribuidor de Regras e Skills para IDEs

lifesystemsufpr/ai-toolkit

Escreva regras uma vez, distribua para 3 IDEs automaticamente

Ver no GitHub
InicialPluginScore · de 0 a 100

Kit de automação que centraliza regras de código e skills em markdown neutro e distribui automaticamente para Cursor, Claude Code e GitHub Copilot via adapters específicos. Reduz duplicação de conhecimento e mantém consistência de padrões em múltiplos repositórios e ambientes de desenvolvimento.

Instalação

$npx convez-ai lifesystemsufpr/ai-toolkit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 2 meses
Versão
—
Issues abertas
4
Contribuidores
1

Casos de uso

  • Sincronizar padrões de código entre Cursor, Claude Code e Copilot
  • Gerenciar skills/procedimentos invocáveis para agentes de IA em um único lugar
  • Distribuir regras consistentes em múltiplos repositórios via PR automático
  • Adaptar formato de regra quando uma IDE evolui sem duplicar esforço

Veredito

Ferramenta sólida para orgs que trabalham com múltiplas IDEs de IA e querem evitar duplicação de knowledge base. Exige TypeScript/Node e orquestração via scripts, mas compensa em escala — uso recomendado para equipes que mantêm vários repos e precisam de padrões centralizados.

README

A tradução para o português deste README ainda está na fila.

ai-toolkit

Fonte neutra de regras e skills de IA para a org lifesystemsufpr, com adaptadores gerados automaticamente para Cursor, Claude Code e GitHub Copilot.

Ideia central

Você escreve a regra uma vez, em markdown neutro em source/. O sync.ts gera os arquivos no formato específico de cada IDE, para cada repositório. Quando uma regra muda, muda num lugar só e propaga para os 3 ambientes e os 7 repos.

source/  (fonte da verdade, markdown)  ──sync.ts──▶  build/<repo>/  ──distribute.ts──▶  PR em cada repo

Estrutura

source/
  rules/        Regras de código (markdown com frontmatter)
  skills/       Skills/procedimentos invocáveis por agente
config/
  projects.ts   Mapeia cada repo aos perfis de regra e às IDEs
scripts/
  sync.ts       Gera build/<repo>/ nos formatos de cada IDE
  distribute.ts Abre 1 PR por repo com os arquivos gerados
build/          Saída gerada (não versionar; está no .gitignore)

Formatos gerados por IDE

IDEArquivos
Cursor.cursor/rules/<id>.mdc (com globs e alwaysApply)
Claude CodeCLAUDE.md (regras always inline + escopadas em seções) e .claude/skills/<id>/SKILL.md
GitHub Copilot.github/copilot-instructions.md, .github/instructions/<id>.instructions.md (com applyTo), .github/prompts/<id>.prompt.md

Os formatos de regra/skill de cada IDE evoluem. Toda a lógica de formato está isolada nas funções emitCursor / emitClaude / emitCopilot em scripts/sync.ts. Se um formato mudar, ajuste só ali e rode o sync de novo.

Anatomia de uma regra

---
id: backend-node
title: Backend Node.js
appliesTo: [backend]          # all | ts | backend | frontend | mobile | kotlin
globs: ["src/**/*.ts"]        # alvos de arquivo (Cursor globs / Copilot applyTo)
always: false                 # true = sempre aplicada, independente de arquivo
---

# conteúdo da regra em markdown...

Uma regra entra num repo se appliesTo inclui all ou intersecta os profiles daquele repo em config/projects.ts.

Uso

pnpm install

# Gerar os adaptadores para todos os repos
pnpm sync

# Gerar só para um repo
pnpm sync auth-service

# Distribuir (abre 1 PR por repo). Precisa de PAT com escopo repo.
DRY_RUN=1 pnpm distribute            # simula
GITHUB_TOKEN=ghp_xxx pnpm distribute # para valer

Como adicionar uma regra ou skill

  1. Crie um arquivo em source/rules/ ou source/skills/ com o frontmatter.
  2. Rode pnpm sync e confira o resultado em build/.
  3. Rode pnpm distribute para abrir os PRs.

Como adicionar uma IDE (ex.: Windsurf)

  1. Escreva uma função emitWindsurf(...) em scripts/sync.ts no formato da IDE.
  2. Adicione "windsurf" ao tipo de ides em config/projects.ts e chame a função no loop.
  3. Rode o sync. A fonte neutra não muda.

Integração com os agentes de código

As skills em source/skills/ são consumidas tanto pelo Claude Agent SDK quanto pelo Cursor SDK (ambos suportam skills e MCP). O mesmo conteúdo que orienta o desenvolvedor na IDE orienta o agente headless no pipeline de CI — uma fonte, vários consumidores.

Ver o original no GitHub

Bom para

Relacionados