Community写作与编辑github.com

Adaptavist/scriptrunner-skills

为 ScriptRunner 产品提供智能体技能支持。

scriptrunner-skills 是什么?

此技能专门用于编写、审查或转换 Jira 表达式。在 ScriptRunner for Jira Cloud 中,工作流条件和验证器必须使用 Jira 表达式实现(后处理函数仍基于 Groovy)。该技能提供了详细的参考文档,帮助开发者理解 Jira 表达式的语法、方法和属性,避免将其与 JavaScript 混淆。它支持多种触发场景,包括处理 Jira Cloud 工作流条件或验证器、将 Data Center Groovy 工作流逻辑转换为 Cloud 版本,以及调试表达式。使用流程包括:优先使用可用的 `jira-expression-generator` 子智能体,否则阅读参考文档 `references/reference.md` 和示例 `references/examples.md`,最后根据参考进行结果验证。技能还强调了输出格式、空值检查以及转换规则等关键注意事项。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add Adaptavist/scriptrunner-skills

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Jira 表达式技能

当您需要编写、审查或转换 Jira 表达式时,请使用此技能。在 ScriptRunner for Jira Cloud 中,工作流条件和验证器必须实现为 Jira 表达式(后处理函数仍基于 Groovy)。

触发信号

  • 任务涉及 Jira Cloud 工作流条件或验证器。
  • 用户请求编写 Jira 表达式,或将 Data Center Groovy 工作流逻辑转换为 Cloud。
  • 您正在审查或调试一个无法正常求值的表达式。

工作流程

  1. 如果您的环境中存在 jira-expression-generator 子智能体,请委托它生成表达式,而非直接使用此技能的参考资料——它内置了相同的参考材料。
  2. 否则,在编写任何表达式之前,请完整阅读 references/reference.md。Jira 表达式不是 JavaScript:只有文档中记录的语法、方法和属性才存在,任何其他内容都会在运行时失败。
  3. 在自行编写之前,阅读 references/examples.md,了解现成的条件和验证器模式。
  4. 根据参考验证结果:工作流条件或验证器必须求值为布尔值,并且存在昂贵操作限制。

注意事项

  • 仅输出原始表达式文本——不要使用 markdown 代码块,也不要添加类似 jira-expression 的语言提示行。
  • 大量使用空值检查(?.、?? 、显式的 != null);隐藏字段和缺失的自定义字段返回 null。
  • 从 Data Center Groovy 转换时,请严格按照参考中的转换规则保留 Groovy 的布尔真值性、空值排序和字符串字面量。
  • 如果无法使用 Jira 表达式 DSL 实现请求,请说明情况并解释限制,而不是发明未记录的语法。

相关技能