CommunityEscrita e Ediçãogithub.com

noppu-labs/ai-toolkit

Kit de ferramentas para desenvolvimento agentivo de aplicações Laravel e React

O que é ai-toolkit?

Este skill fornece um conjunto de ferramentas e fluxos de trabalho para desenvolvedores que usam agentes de IA (como Claude Code, Cursor ou Codex) para construir e manter aplicações Laravel e React. Ele automatiza a sincronização de skills 'vendorizados' (copiados de repositórios upstream) com suas versões originais, garantindo que as personalizações locais sejam preservadas durante as atualizações. O skill suporta estados como `up-to-date`, `local`, `upstream-updated`, `locally-modified` e `diverged`, com comandos específicos para cada situação. Inclui um guia detalhado para resolução manual de conflitos em skills divergentes, incentivando a leitura completa de ambas as versões antes de qualquer edição e o uso de comandos como `diff`, `seed` e `accept` para manter o controle de versões.

Funciona com~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add noppu-labs/ai-toolkit

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Sincronizar skills vendorizados com upstream

Pré-requisitos: CLI gh autenticada. Execute tudo a partir da raiz do repositório.

Fluxo de trabalho

  1. Execute node scripts/skills-sync.mjs status. Estados e o que fazer:

    • up-to-date — nada a fazer.
    • local — skill próprio, sem upstream; nada a sincronizar.
    • upstream-updated — avanço rápido seguro: node scripts/skills-sync.mjs pull <plugin>/<skill>.
    • locally-modified — editamos desde a última linha de base. Se as edições forem intencionais, node scripts/skills-sync.mjs accept <plugin>/<skill>.
    • diverged — ambos os lados mudaram: mesclar manualmente (seção abaixo).
    • fetch-error (...) — upstream inacessível ou movido; verifique source/skillPath no skills-lock.json do plugin em relação ao repositório upstream.
  2. Após todas as alterações: node scripts/skills-sync.mjs verify, depois faça commit com uma mensagem que liste quais skills foram puxados ou mesclados e de quais commits upstream.

Mesclagem manual para skills divergentes

Nunca sobrescreva cegamente um skill divergente — pull --force descarta nossas personalizações.

  1. node scripts/skills-sync.mjs diff <plugin>/<skill> — diff completo, vendorizado → upstream.
  2. Identifique quais diferenças são personalizações INTENCIONAIS nossas (git log -p -- <plugin>/skills/<skill> mostra como a cópia vendorizada evoluiu) versus melhorias genuínas do upstream.
  3. Edite os arquivos vendorizados para incorporar as melhorias do upstream preservando cada personalização local. Leia ambas as versões completamente antes de editar.
  4. Refaça a linha de base de AMBOS os lados: node scripts/skills-sync.mjs seed <plugin>/<skill> (accept apenas refaz a linha de base do hash vendorizado e deixaria o skill permanentemente marcado como atualizado pelo upstream).

Habilidades Relacionadas