SuperAPI AI 工具集

researching-jira-issues

编程与开发

查看项目

更新于 10-15 20:06

技能介绍

用途:当用户提到某个 Jira 议题键并想深入了解时,用该技能把散落在议题、评论和文档中的信息串联成连贯理解。

主要能力:以 get_issue 获取主议题,默认可展开 renderedFields 与 names,得到 HTML 渲染字段和可读的自定义字段名;提取议题类型、摘要与描述、状态与优先级、经办人与报告人、标签、组件、冲刺等字段,以及提供关键上下文的评论。通过 issuelinks 识别 Blocks/Blocked by、Depends on、Relates to、Clones、Duplicates、Supersedes 等关系,以及父议题、Epic 链接和子任务;若为 Epic/Feature 且子任务为空(下一代项目),用 search_issues 配合 JQL parent = <ISSUE-KEY> 查找子议题。用 get_issue_remote_links 获取关联的 Confluence 页面、GitHub 拉取请求与提交等外部资源。对链接议题按优先级取回:Blocks、Depends on、Parent、Epic Link 优先,子任务与相关议题次之,重复/克隆最低。从 URL 提取 pageId,用 get_confluence_page 获取文档,超 2000 词的页面只总结与议题相关的部分。

使用方式:按六步工作流执行——取主议题、识别所有链接、按深度控制取回链接议题、取回关联 Confluence 文档、优雅处理失败、最后综合呈现。呈现内容包括议题概览、需求与上下文、依赖与关系、工作范围、关键洞察,并展示非空自定义字段。所有信息汇总,而非拼接工具输出。

限制:最多遍历主议题之外 2 层,对高优先级链接才做第三跳;跨项目内联引用仅作为信息提及,除非是正式议题链接否则不遍历;记录已取回的键避免循环引用;超过 10 个子任务时只取前 10 个,其余以紧凑列表概括;每 5 次连续调用后暂停约 1 秒,遇 429 等 10 秒再试;综合超过约 4000 词时压缩低优先级议题为单行;评论默认只显示最近 3 条。抓取失败时记录失败项并继续,最后报告无法获取的内容。