處理 Jira 客服與管理類請求,包括 login、project、permission、ui_navigation、field_config、issue、doc_summarization、workflow_inspector 與其他 Jira 問題;同時維護 Jira agent 的 skill-based 路由規則、專家工作流、工具呼叫約束與結構化輸出契約。當需要將舊有 @prompts 規則遷移為 skill 資源、執行 Jira specialist 工作流、調整 classify/switch/entity extraction 規則、或預覽/驗證 Jira agent 規則時使用此技能。
將 .agent/skills/jira/ 視為 Jira agent 規則的單一真相來源。這個 skill 同時服務兩種場景:實際處理 Jira 請求,以及維護 prompt-to-skill 遷移後的規則資源。新規則先更新 skill 內資源,不再以 prompts/ 作為主要維護入口。
references/intent-routing.mdreferences/specialist-workflows.mdreferences/schema-descriptions.jsonload_skilljira_querycreate_jira_issuetroubleshooting_tkproject_creatorknowledge_retrieverworkflow_condition_inspector若設定 JIRA_BASE_URL 與 JIRA_API_TOKEN,deepagents runtime 會優先呼叫真實 Jira REST API;未設定時才退回本地 mock / reference 模式。
prompts/templates/classify-guard.config.ts → references/intent-routing.mdprompts/templates/specialist.config.ts → references/specialist-workflows.md 與 references/schema-descriptions.jsonprompts/builders/prompt-loader.ts → scripts/preview-rules.ts 與 scripts/validate-rules.ts.agent/skills/jira/preview-prompts.ts 保留為相容入口,但實作改走 skill 資源prompts/references/intent-routing.mdreferences/specialist-workflows.mdscripts/validate-rules.tsreferences/schema-descriptions.json當回覆 payload 出現以下結構時,將其解讀為「帳號曾因登入失敗次數過多被鎖住,但系統已完成排查並執行解鎖」:
"login": {
"stat": "FIXED",
"meta": {
"username": "alvis.mc.tsao"
},
"flags": [
"LOCK_RESET",
"ACCOUNT_UNLOCKED"
],
"data": {
"active": true,
"currentFailedLoginCount": 0,
"previouslyLocked": true
}
}
判定要點:
"stat": "FIXED" 表示問題已修復flags 含 "LOCK_RESET" 或 "ACCOUNT_UNLOCKED" 表示鎖定狀態已被重置/解除data.active: true、currentFailedLoginCount: 0、previouslyLocked: true 可作為「先前曾被鎖,現在已解鎖」的佐證bun .agent/skills/jira/scripts/preview-rules.ts --list-intents
bun .agent/skills/jira/scripts/preview-rules.ts --routing
bun .agent/skills/jira/scripts/preview-rules.ts --intent=login
bun .agent/skills/jira/scripts/preview-rules.ts --schema
舊指令仍可使用:
bun .agent/skills/jira/preview-prompts.ts --intent=login
bun .agent/skills/jira/scripts/validate-rules.ts