Community寫作與編輯github.com

Adaptavist/scriptrunner-skills

用於 ScriptRunner 產品的代理技能

scriptrunner-skills 是什麼?

此技能專門協助 AI 代理在 ScriptRunner for Jira Cloud 中編寫、審查或轉換 Jira 表達式。它特別適用於處理 Jira Cloud 工作流程條件與驗證器,因為這些必須以 Jira 表達式實作(而後置函數仍基於 Groovy)。該技能提供清晰的啟動訊號,例如當任務涉及 Jira Cloud 工作流程條件或驗證器、使用者要求 Jira 表達式、或需要將 Data Center Groovy 邏輯轉換為 Cloud 版本時,便應啟用此技能。工作流程包括:優先使用 `jira-expression-generator` 子代理(如果可用),否則需完整閱讀 `references/reference.md` 參考文件,因為 Jira 表達式並非 JavaScript,僅使用文件內記錄的語法與屬性;接著閱讀 `references/examples.md` 中的範例,並根據參考文件驗證結果,確保條件或驗證器回傳布林值且未超過昂貴操作限制。此外,技能強調輸出純文字表達式(不加 markdown 框或語言標記)、善用 null 檢查、在從 Data Center Groovy 轉換時保留 Groovy 的 truthiness 與字串字面量,並在無法以 Jira 表達式 DSL 達成需求時明確說明限制。

相容平台~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);隱藏欄位與遺失的自訂欄位會回傳 null。
  • 從 Data Center Groovy 轉換時,請依照參考文件中的轉譯規則,精確保留 Groovy 的 truthiness、null 排序與字串字面量。
  • 如果無法以 Jira 表達式 DSL 達成請求,請明確說明並解釋限制,而非憑空創造未記載的語法。

相關技能