Skip to content

v2.3.2 — Sintaxe @Parameter(name = ...) + clarificação opcional/obrigatório

Choose a tag to compare

View all tags
@omartelo omartelo released this 10 May 03:17
· 77 commits to main since this release
v2.3.2
a6ea632
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Resumo

Patch corrige sintaxe da anotação @Parameter documentada nos skills repository e macros. Em homologação, agente gerou repository com @Parameter(\"nome\") (forma posicional) e tomou erro de compilação.

Bug corrigido

JAPE exige @Parameter(name = \"...\") com name = explícito. A forma posicional @Parameter(\"...\") causa erro de compilação.

Bônus: agente colocava @Parameter em todos os parâmetros, mesmo quando o nome do parâmetro Java casava com :nome da clause SQL — onde a annotation é opcional (vinculação automática).

Mudanças

Skill repository (SKILL.md)

  • Reescrita da regra de uso de @Parameter (seção 3.1):
    • Opcional quando nome do parâmetro Java casa com :nome da clause
    • Obrigatório quando nomes diferem
    • Sintaxe correta: @Parameter(name = \"...\") — sempre com name = explícito
    • Forma posicional @Parameter(\"...\") causa erro de compilação
  • Removido @Parameter(\"X\") desnecessário de 11+ exemplos (findByModeloNativo, buscarDescricaoPorCodigo, reajustarPrecoPorGrupo, excluirLogsExpirados, findByNomeParceiro, descontoOuZero, listarAtivos, findByPlacaStartingWith, findByCliente, findResumoPorStatus, deleteRascunhosAntigos)
  • Mantido o exemplo findByPeriodo (com dataInicio/dataFim ≠ inicio/fim) usando @Parameter(name = \"...\") — caso canônico onde a annotation é necessária
  • Frontmatter description: @Param → @Parameter(name = \"...\") (alinha com sintaxe JAPE real, não Spring Data)
  • Comentário inline corrigido: "Nomes do método != :nome" → "Nome do parâmetro Java != :nome" (review Copilot)

Skill macros (SKILL.md)

  • Mesmo fix em 2 exemplos (findByNome, descontoOrZero)

Bump 2.3.1 → 2.3.2

  • plugins/addon-studio/.claude-plugin/plugin.json
  • plugins/addon-studio/.codex-plugin/plugin.json
  • .claude-plugin/marketplace.json

Validação

  • skills-ref validate ✓ em ambas as skills
  • 2 comentários do review do Copilot endereçados antes do merge

Sequência

v1.6.4 → v2.0.0 → v2.1.0 → v2.2.0 → v2.2.1 → v2.3.0 → v2.3.1 → v2.3.2

PR

#18 #18

Assets 2
Loading