用途:该技能用于 ScriptRunner for Jira Cloud 中 Jira 表达式(Jira Expressions DSL)的编写、审查与转换,重点覆盖工作流条件和校验器。资料说明,在 ScriptRunner for Jira Cloud 上,工作流条件和校验器必须用 Jira 表达式实现,post function 仍基于 Groovy。
触发场景:任务涉及 Jira Cloud 工作流条件或校验器;用户要求编写 Jira 表达式,或把 Data Center 的 Groovy 工作流逻辑转换到 Cloud;正在审查或调试执行失败的表达式。
使用方式:如果环境中存在 jira-expression-generator 子代理,应把表达式生成委托给它,因为它内置了相同参考材料;否则在编写任何表达式前完整阅读 references/reference.md,因为 Jira Expressions 不是 JavaScript,只有文档中记录的语法、方法和属性存在,其他内容会在运行时失败。编写前还应阅读 references/examples.md 中的条件和校验器示例模式,而不是自行发明。结果需按参考文档校验:工作流条件或校验器必须求值为布尔值,并受昂贵操作限制。
输出与注意事项:只输出原始表达式文本,不要 Markdown 代码围栏,也不要 jira-expression 之类的语言提示行。要大量使用空值检查(?.、??、显式 != null),因为隐藏字段和缺失的自定义字段会返回 null。从 Data Center Groovy 转换时,按参考文档的翻译规则保留 Groovy 真值判断、空值排序和字符串字面量。若需求无法用 Jira Expressions DSL 实现,应说明并解释限制,不要编造未记录的语法。
限制:资料未提供安装命令、具体平台版本要求、收费信息或完整语法清单;这些内容需以 references/reference.md 与 references/examples.md 为准,当前资料暂未提供。