用途:该技能用于搜索与分析 Jira 工单、Sprint 和项目分析数据,适用于用户询问工单、缺陷、迭代跟踪或工程任务的场景。
连接与认证:Base URL 为 $JIRA_BASE_URL(例如 https://yourorg.atlassian.net)。认证使用 Basic auth,值为 Base64($JIRA_USER_EMAIL:$JIRA_API_TOKEN)。所需环境变量为 JIRA_BASE_URL、JIRA_USER_EMAIL、JIRA_API_TOKEN。内置 10 分钟内存缓存,最多 100 条。使用的 API 版本为 REST API v3(/rest/api/3)和 Agile API(/rest/agile/1.0)。
主要能力:服务端库文件为 server/lib/jira.ts,导出函数包括 searchIssues(jql, fields?, maxResults?)(按 JQL 搜索)、getIssue(issueKey)(获取单个工单详情)、getProjects()(列出所有项目)、getStatuses(projectKey?)(列出状态,可按项目)、getBoards()(列出敏捷看板)、getSprints(boardId)(列出看板的 Sprint)、getAnalytics(projects, days)(聚合工单分析)。对应 API 路由包括 GET /api/jira/search、/api/jira/issue、/api/jira/projects、/api/jira/statuses、/api/jira/boards、/api/jira/sprints、/api/jira/analytics。
使用方式:可通过仪表盘 /adhoc/jira 查看 Jira Tickets 面板,含 Overview、Search 和 Sprints 标签。脚本用法示例:pnpm action jira-search --jql="summary ~ SSO ORDER BY created DESC" --fields=key,summary,status,assignee;分析用法:pnpm action jira-analytics --days=30,或 pnpm action jira-analytics --projects=ENG,PROD --days=30。
限制与注意事项:旧的 /rest/api/3/search 端点已被 Atlassian 移除(返回 410),必须改用 /rest/api/3/search/jql。重复检测可用 JQL:project = X AND summary ~ "keyword" ORDER BY created DESC。工单应始终使用 markdown 链接,例如 ENG-1234。getStatuses 传入 projectKey 时返回问题类型条目数组,代码会扁平化嵌套状态。getAnalytics 会运行多次搜索查询并在客户端聚合。收费标准与平台限制资料中暂未提供。