Jira 表达式技能
当您需要编写、审查或转换 Jira 表达式时,请使用此技能。在 ScriptRunner for Jira Cloud 中,工作流条件和验证器必须实现为 Jira 表达式(后处理函数仍基于 Groovy)。
触发信号
- 任务涉及 Jira Cloud 工作流条件或验证器。
- 用户请求编写 Jira 表达式,或将 Data Center Groovy 工作流逻辑转换为 Cloud。
- 您正在审查或调试一个无法正常求值的表达式。
工作流程
- 如果您的环境中存在
jira-expression-generator子智能体,请委托它生成表达式,而非直接使用此技能的参考资料——它内置了相同的参考材料。 - 否则,在编写任何表达式之前,请完整阅读
references/reference.md。Jira 表达式不是 JavaScript:只有文档中记录的语法、方法和属性才存在,任何其他内容都会在运行时失败。 - 在自行编写之前,阅读
references/examples.md,了解现成的条件和验证器模式。 - 根据参考验证结果:工作流条件或验证器必须求值为布尔值,并且存在昂贵操作限制。
注意事项
- 仅输出原始表达式文本——不要使用 markdown 代码块,也不要添加类似
jira-expression的语言提示行。 - 大量使用空值检查(
?.、??、显式的!= null);隐藏字段和缺失的自定义字段返回null。 - 从 Data Center Groovy 转换时,请严格按照参考中的转换规则保留 Groovy 的布尔真值性、空值排序和字符串字面量。
- 如果无法使用 Jira 表达式 DSL 实现请求,请说明情况并解释限制,而不是发明未记录的语法。