convez.ai
SkillDesenvolvimento WebAvançado
snk-devcenter

Addon Studio Claude Code

snk-devcenter/addon-studio

21 skills + 6 agents para desenvolvimento Sankhya Addon Studio 2.0

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code com 21 funcionalidades focadas + 6 sub-agents inteligentes que guiam a implementação em projetos Sankhya Addon Studio 2.0 (Wildfly/EJB + SDK Java JAPE). Cobre todo o ciclo: entidades, controllers, repositórios, testes, scripts de banco e troubleshooting.

Instalação

$npx convez-ai snk-devcenter/addon-studio

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
5
Forks
0
Acompanhando
0
Saúde
25%
Último commit
há 6 dias
Versão
v3.5.4
Issues abertas
1
Contribuidores
3

Casos de uso

  • Scaffolding de entidades @JapeEntity com data dictionary automático
  • Geração de controllers REST + DTOs + MapStruct mappers
  • Criação de dbscripts dual MSSQL/Oracle com validação
  • Escrita de testes JUnit 5 + Mockito com mocks automáticos
  • Debug de erros comuns e troubleshooting de projeto
  • Injeção de dependências com Guice DI

Veredito

Skill robusto e bem estruturado para o ecossistema Sankhya, com cobertura completa do stack JAPE/EJB. Requer conhecimento prévio profundo em Java Enterprise, mas automatiza boilerplate e reduz erros em padrões complexos. Implementação madura, mantida oficialmente pelo DevCenter.

README

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

Addon Studio Plugin

Plugin com 21 skills focadas + 6 sub-agents — orienta implementacao em projetos Sankhya Addon Studio 2.0 (Wildfly/EJB + SDK Java JAPE). Mantido pelo setor DevCenter.

Compativel nativamente com Claude Code e OpenAI Codex CLI (padrao aberto Agent Skills / agentskills.io).

Conteudo

.
├── .claude-plugin/
│   └── marketplace.json                            # catalogo Claude Code (raiz)
├── .agents/
│   └── plugins/
│       └── marketplace.json                        # catalogo Codex CLI (raiz)
└── plugins/
    └── addon-studio/
        ├── .claude-plugin/plugin.json              # manifest plugin Claude Code
        ├── .codex-plugin/plugin.json               # manifest plugin Codex CLI
        ├── hooks/hooks.json                        # hook PostToolUse encoding (Claude-only)
        ├── agents/                                 # 6 sub-agents (Claude Code only)
        │   ├── addon-reviewer.md                   # review pre-commit (sonnet)
        │   ├── entity-architect.md                 # modela trio CRUD (sonnet)
        │   ├── controller-designer.md              # @Controller + DTOs + Mapper (sonnet)
        │   ├── test-writer.md                      # JUnit 5 + Mockito 4.11 (sonnet)
        │   ├── troubleshooter.md                   # debug erros comuns (haiku)
        │   └── dbscript-builder.md                 # dbscripts dual MSSQL/Oracle (haiku)
        └── skills/
            ├── addon-studio/                       # overview + regras universais + naming + fluxo CRUD
            │   ├── SKILL.md
            │   ├── agents/openai.yaml              # metadata Codex desta skill
            │   └── assets/ADDON.md                 # template de instrucoes injetado no projeto consumidor
            ├── init/SKILL.md                       # setup: copia ADDON.md pra docs/ + @import no CLAUDE.md
            ├── action-button/SKILL.md              # @ActionButton (AcaoRotinaJava)
            ├── before-load-listener/SKILL.md       # @BeforeLoadListener (FinderListener)
            ├── build/SKILL.md                      # gradle deployAddon
            ├── business-rule/SKILL.md              # @BusinessRule (Regra)
            ├── controller/SKILL.md                 # @Controller REST
            ├── controller-advice/SKILL.md          # @ControllerAdvice + @ExceptionHandler
            ├── data-dictionary/SKILL.md            # XML datadictionary/<TABELA>.xml
            ├── database/SKILL.md                   # dbscripts/V<NNN>-*.xml dual MSSQL/Oracle
            ├── dependency-injection/SKILL.md       # Guice DI
            ├── encoding/SKILL.md                   # ISO-8859-1 conversao
            ├── entity/SKILL.md                     # @JapeEntity
            ├── job/SKILL.md                        # @Job (IJob)
            ├── macros/SKILL.md                     # MacroTranslator SQL macros
            ├── mapstruct/SKILL.md                  # MapStruct mappers
            ├── repository/SKILL.md                 # @Repository / JapeRepository
            ├── retrofit/SKILL.md                   # Retrofit + Moshi + OkHttp (HTTP externo)
            ├── test/SKILL.md                       # JUnit 5 + Mockito 4.11
            ├── type-adapter/SKILL.md               # @GlobalTypeAdapter
            └── value/SKILL.md                      # @Value / ValueType

Layout multi-plugin: o repo serve como marketplace + plugin. Cada plugin futuro vai ganhar pasta propria em plugins/<nome>/. Exigencia do Codex CLI (path local tem que apontar pra subpasta do marketplace root, nao pra raiz).

Cobertura (21 skills)

SkillEscopo
addon-studioOverview, regras universais (Java 8 strict, Lombok, ISO-8859-1), naming <PRX><MOD3><CTX>, fluxo CRUD
initSetup do projeto: copia ADDON.md pra docs/ADDON.md + garante @docs/ADDON.md no CLAUDE.md. Re-rodar = upgrade idempotente
entity@JapeEntity (Lombok, PK simples/composta, relacionamentos)
data-dictionaryXML dicionario de dados
databasedbscripts/V<NNN>-*.xml dual MSSQL/Oracle
repository@Repository, @Criteria, @NativeQuery, @Modifying
retrofitRetrofit + Moshi + OkHttp (deps moduleLib, interface client, wiring Guice, interceptors)
controller@Controller(serviceName SP), DTO + @Valid, @Transactional
controller-advice@ControllerAdvice + @ExceptionHandler, rollback automatico
dependency-injectionGuice (@Component, @CustomModule, Multibinder, @Singleton, Provider<T>)
mapstructcomponentModel=jakarta, injectionStrategy=CONSTRUCTOR, padrao create/merge
testJUnit 5 + Mockito 4.11 (mock estatico, JapeRepository quirks)
action-button@ActionButton (AcaoRotinaJava, @Form, ContextoAcao)
business-rule@BusinessRule (Regra, ContextoRegra, barramento)
before-load-listener@BeforeLoadListener (FinderListener, beforeExecute, filtro transversal no Finder)
job@Job (IJob, onSchedule, CRON, migracao XML)
type-adapter@GlobalTypeAdapter (TypeAdapter, JsonSerializer/JsonDeserializer)
value@Value / ValueType (Provider<T>, SANKHYA_PARAM)
macrosMacroTranslator SQL (dbDate, nullValue, ignorecase, etc.)
encodingISO-8859-1 obrigatorio em .java/.xml/.kt
buildgradle deployAddon

Convencao de nomenclatura (parametrizada por projeto)

Padrao parametrizado por <PRX> (prefixo) + <MOD3> (modulo). Skill detecta padrao existente no projeto; se ausente, pergunta ao dev antes de gerar artefatos.

ArtefatoPadraoExemplo (PRX=TDC, MOD3=XYZ)
Tabela do addon<PRX><MOD3><CTX> UPPERTDCXYZCAB
@JapeEntity(entity = "...")<Prx><Mod><Ctx> PascalTdcXyzCabecalho
Coluna custom em tabela nativa<MOD3>_NOMECAMPO UPPERXYZ_STATUS

Sub-agents (Claude Code only)

Agents sao especialistas com workflow ativo, tools restritas e modelo proprio. Diferente de skills (conhecimento/instrucao textual), agents executam decisao + acao.

AgentModeloEscopo
addon-reviewersonnetReview pre-commit: encoding, Java 8, Lombok, Guice DI, @JapeEntity, anti-patterns. Saida em Blockers/Warnings/Suggestions.
entity-architectsonnetModela trio CRUD end-to-end: XML dicionario + dbscript migration + entidade @JapeEntity Java.
controller-designersonnetDesenha endpoint REST: @Controller + Request/Response DTOs + MapStruct Mapper + (se aplicavel) @ControllerAdvice.
test-writersonnetEscreve JUnit 5 + Mockito 4.11 com quirks de JapeRepository. Roda ./gradlew test pra validar.
troubleshooterhaikuDiagnostica erros: encoding, Guice DI, JPA misturada com JAPE, Java 8 violations, build/deploy.
dbscript-builderhaikuGera dbscripts V<NNN>-*.xml dual MSSQL/Oracle (CREATE_TABLE minimo + ALTER por coluna).

Codex CLI: agents sao feature exclusiva do Claude Code. As 21 skills funcionam em ambos harnesses; os 6 agents sao ignorados pelo Codex CLI (sem perda — usuarios do Codex usam invocacao explicita das skills).

Sem opiniao arquitetural

Skills cobrem regras do SDK e do framework. Organizacao de pacotes, camadas e padroes de design (Clean Arch, Hexagonal, MVC, DDD) sao decisoes do dev/projeto.

Como configurar no projeto consumidor

Skill discovery e semantica — agente so dispara skill quando o prompt do dev casa com algum trigger da description. Em projeto onde o dev pede so "implementa essa spec", agente pode pular o overview e perder regras universais (Java 8 strict, ISO-8859-1, JAPE nao JPA).

Pra forcar discovery + alinhamento, o plugin entrega o arquivo ADDON.md (instrucoes pro agente) e o setup automatizado via a skill init.

Setup em um comando

Na raiz do projeto Sankhya, peca ao agente:

/addon-studio:init

A skill:

  1. Confere que o projeto e mesmo Addon Studio (procura br.com.sankhya.addonstudio em build.gradle/build.gradle.kts).
  2. Copia ADDON.md (fonte canonica: <plugin-root>/skills/addon-studio/assets/ADDON.md) para docs/ADDON.md no projeto.
  3. Cria ou atualiza o CLAUDE.md da raiz inserindo a linha @docs/ADDON.md (idempotente — nao duplica se ja existir, nao mexe em customizacoes do dev).

Resultado:

projeto/
├── docs/
│   └── ADDON.md        # gerado pelo plugin — nao editar
├── CLAUDE.md           # do dev — contem `@docs/ADDON.md` + customizacoes
├── build.gradle
└── ...

Atualizar o ADDON.md

Apos atualizar o plugin (/plugin update addon-studio@snk-devcenter), rode /addon-studio:init de novo. A skill faz overwrite do docs/ADDON.md (versao nova entra) sem tocar no CLAUDE.md do dev.

Customizacoes do projeto

Regras especificas do projeto (override de convencao, padrao de pacotes, etc.) vao no CLAUDE.md da raiz, fora do docs/ADDON.md. O plugin nunca regenera o CLAUDE.md — so insere o @docs/ADDON.md se ausente.

Codex CLI (AGENTS.md)

Codex CLI usa AGENTS.md e nao suporta sintaxe @import nativa. Como workaround temporario:

cp docs/ADDON.md AGENTS.md

(re-rodar quando atualizar o docs/ADDON.md). Setup automatico do AGENTS.md esta no roadmap.

Instalacao

A skill funciona nativamente em Claude Code e em OpenAI Codex CLI. Use o fluxo do harness que voce ja tem instalado.

Claude Code

/plugin marketplace add snk-devcenter/addon-studio
/plugin install addon-studio@snk-devcenter

Apos instalado, skills ficam disponiveis via auto-trigger (descrições específicas) ou invocacao explicita: /addon-studio:entity, /addon-studio:repository, etc. Sub-agents aparecem em /agents e sao auto-invocados conforme contexto (ou explicitamente via comando).

OpenAI Codex CLI

Atencao: o repo snk-devcenter/addon-studio e privado. O Codex CLI nao respeita credenciais gh/git/SSH do usuario ao resolver owner/repo (libgit2 interno ignora credential helpers). Use o fluxo de clone local abaixo.

  1. Clone o repo manualmente (usa seu gh auth ou chave SSH ja configurada):

    mkdir -p ~/.codex/marketplaces
    git clone git@github.com:snk-devcenter/addon-studio.git ~/.codex/marketplaces/addon-studio
    
  2. Adicione o marketplace apontando para o caminho local:

    codex plugin marketplace add ~/.codex/marketplaces/addon-studio
    
  3. Abra a TUI e instale:

    /plugins
    

    Escolha snk-devcenter -> addon-studio -> Install.

Atualizar

Claude Code:

/plugin update addon-studio@snk-devcenter

Codex CLI (atualizar o clone local + recarregar marketplace):

git -C ~/.codex/marketplaces/addon-studio pull
codex plugin marketplace update snk-devcenter

E reinstalar via /plugins se necessario.

Limitacoes por harness

RecursoClaude CodeCodex CLI
Auto-trigger por description da skillsimsim
Hook PostToolUse encoding ISO-8859-1simnao (rodar iconv apos editar — ver skill encoding)
Invocacao explicita por skill/addon-studio:<skill>$addon-studio:<skill>
Sub-agents (agents/*.md)sim (6 agents disponiveis)nao (feature exclusiva Claude Code)
Repo privado via owner/reposim (usa gh/git auth do user)nao (libgit2 interno; usar clone local + path)

Versionamento

Versoes seguem SemVer. Tag git por release: v1.0.0, v1.1.0, etc.

Ver o original no GitHub

Bom para

Relacionados