jira-expressions

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Jira Expressions Skill

Jira Expressions Skill

Use this skill whenever you need to write, review, or convert a Jira expression. On ScriptRunner for Jira Cloud, workflow conditions and validators must be implemented as Jira expressions (post functions remain Groovy-based).
每当需要编写、审查或转换 Jira expression 时,请使用此 skill。在 ScriptRunner for Jira Cloud 上,工作流条件和验证器 必须使用 Jira expressions 实现(post functions 仍基于 Groovy)。

Activation Signals

激活信号

  • The task involves a Jira Cloud workflow condition or validator.
  • The user asks for a Jira expression, or to convert Data Center Groovy workflow logic to Cloud.
  • You are reviewing or debugging an expression that fails to evaluate.
  • 任务涉及 Jira Cloud 工作流条件或验证器。
  • 用户要求提供 Jira expression,或将 Data Center Groovy 工作流逻辑转换为 Cloud。
  • 正在审查或调试求值失败的 expression。

Workflow

工作流程

  1. If a
    jira-expression-generator
    subagent is available in your environment, delegate expression generation to it instead of using this skill's references directly - it embeds the same reference material.
  2. Otherwise, read
    references/reference.md
    in full before writing any expression. Jira Expressions is not JavaScript: only the syntax, methods, and properties documented there exist, and anything else fails at runtime.
  3. Read
    references/examples.md
    for worked condition and validator patterns before inventing your own.
  4. Validate the result against the reference: a workflow condition or validator must evaluate to a boolean, and expensive-operation limits apply.
  1. 如果你的环境中提供了
    jira-expression-generator
    subagent, 请将表达式生成工作委托给它,而不是直接使用此 skill 的参考资料——它嵌入了相同的参考内容。
  2. 否则,在编写任何 expression 之前,完整阅读
    references/reference.md
    。 Jira Expressions 不是 JavaScript:只有该文档中记录的语法、方法和属性才存在, 其他任何内容都会在运行时失败。
  3. 在自行设计之前,阅读
    references/examples.md
    ,了解实战条件和验证器模式。
  4. 根据参考资料验证结果:工作流条件或 验证器必须求值为布尔值,并且适用高开销操作限制。

Notes

注意事项

  • Output raw expression text only - no markdown fences and no language hint lines such as
    jira-expression
    .
  • Apply null checks liberally (
    ?.
    ,
    ?? 
    , explicit
    != null
    ); hidden fields and missing custom fields return
    null
    .
  • When converting from Data Center Groovy, preserve Groovy truthiness, null ordering, and string literals exactly as the reference's translation rules describe.
  • If the request cannot be achieved with the Jira Expressions DSL, say so and explain the limitation instead of inventing undocumented syntax.
  • 仅输出原始 expression 文本——不要使用 markdown 代码围栏,也不要添加
    jira-expression
    等语言提示行。
  • 应充分应用 null 检查(
    ?.
    、
    ?? 
    、显式
    != null
    );隐藏字段和不存在的自定义字段会返回
    null
    。
  • 从 Data Center Groovy 转换时,应严格按照参考资料中的转换规则保留 Groovy 的真值判断、null 顺序和字符串字面量。
  • 如果 Jira Expressions DSL 无法完成请求,应直接说明并解释其限制,而不是编造未记录的语法。