Adaptavist/scriptrunner-skills

Skill de Expressões Jira

Use este skill sempre que precisar escrever, revisar ou converter uma expressão Jira. No ScriptRunner for Jira Cloud, condições e validadores de workflow devem ser implementados como expressões Jira (post-functions permanecem baseadas em Groovy).

Sinais de Ativação

• A tarefa envolve uma condição ou validador de workflow do Jira Cloud.
• O usuário pede uma expressão Jira, ou para converter lógica de workflow Groovy do Data Center para Cloud.
• Você está revisando ou depurando uma expressão que falha ao ser avaliada.

Fluxo de Trabalho

1. Se um subagente jira-expression-generator estiver disponível no seu ambiente, delegue a geração da expressão a ele em vez de usar as referências deste skill diretamente – ele incorpora o mesmo material de referência.
2. Caso contrário, leia references/reference.md por completo antes de escrever qualquer expressão. Jira Expressions não é JavaScript: apenas a sintaxe, métodos e propriedades documentados ali existem, e qualquer outra coisa falha em tempo de execução.
3. Leia references/examples.md para ver padrões de condições e validadores já trabalhados antes de criar os seus próprios.
4. Valide o resultado em relação à referência: uma condição ou validador de workflow deve ser avaliado como booleano, e limites de operações caras se aplicam.

Notas

• Produza apenas o texto bruto da expressão – sem cercas de markdown e sem linhas de dica de linguagem como jira-expression.
• Aplique verificações nulas liberalmente (?., ?? , != null explícito); campos ocultos e campos personalizados ausentes retornam null.
• Ao converter de Groovy do Data Center, preserve a truthiness do Groovy, a ordenação nula e os literais de string exatamente como as regras de tradução da referência descrevem.
• Se a solicitação não puder ser realizada com o DSL de Expressões Jira, diga isso e explique a limitação em vez de inventar sintaxe não documentada.