Skip to content

v2.0.0 — Multi-skill restructure (Agent Skills spec)

Choose a tag to compare

View all tags
@omartelo omartelo released this 09 May 20:16
· 83 commits to main since this release
v2.0.0
8505e57
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

⚠️ Breaking Change

Refator estrutural completo do plugin para alinhamento com a especificação oficial Agent Skills e padrão dominante da comunidade (AWS sample, anthropics/skills).

PR: #12

Mudanças principais

Reestruturação skill monolítica → 18 skills focadas

  • 1 skill addon-studio + 18 references → 18 skills independentes com SKILL.md próprio + frontmatter spec-compliant
  • Skills disponíveis: addon-studio (overview), entity, repository, controller, controller-advice, data-dictionary, database, dependency-injection, mapstruct, test, action-button, business-rule, job, type-adapter, value, macros, encoding, build
  • 5 skills com references/ próprio para deep-dives (mapstruct, database, data-dictionary, entity, controller) — 12 reference files
  • Cada skill tem description específica para trigger granular preciso

Spec compliance

  • Diretório renomeado de instructions/ → references/ (padrão Anthropic)
  • Frontmatter applyTo: removido (convenção Copilot, ignorado pelo Claude Code)
  • Frontmatter agora alinhado à spec: name, description, license, compatibility
  • Validador skills-ref validate: 18× Valid skill ✅

Compat Codex CLI preservada

  • .codex-plugin/, .agents/, agents/openai.yaml mantidos
  • Skills funcionam idênticas em ambos harnesses (Claude Code + Codex CLI)

Quebra de compatibilidade

Item Antes (v1.x) Depois (v2.0.0)
Estrutura 1 skill + 18 references 18 skills focadas
Paths instructions/<nome>-instructions.md skills/<nome>/SKILL.md
Invocação /addon-studio (carrega tudo) /addon-studio (overview); /addon-studio:<skill> (tópico)
Frontmatter applyTo glob Removido — trigger via description

Como atualizar

Claude Code:

/plugin update addon-studio@snk-devcenter

Codex CLI:

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

Após update, /reload-plugins ou reinicia sessão.

Migração de docs/scripts internos

Atualizar qualquer referência:

  • instructions/<nome>-instructions.md → backtick com nome da skill (entity, repository, etc.)
  • Invocação /addon-studio esperando carregar tudo → usar /addon-studio:<skill> pra tópico específico

Comportamento de auto-trigger por contexto (anotações Sankhya, paths) continua funcionando igual.

Assets 2
Loading