SuperAPI AI 工具集

jira-issues

办公与效率

查看项目

更新于 10-13 15:23

技能介绍

用途:在 Jira Cloud 中创建、读取、更新和删除问题(issue),管理问题字段、状态流转与元数据。适用于 Story、Task、Bug、Epic 等类型的问题管理。

主要能力:

  • 创建新问题(Story、Task、Bug、Epic)
  • 读取问题详情
  • 更新问题字段(如 summary、description、assignee 等)
  • 删除问题(可选择删除子任务)
  • 支持批量创建问题(采用分批 Promise.all 方式)
  • 支持通过 issue type 定义必填字段,并处理描述字段的 ADF(Atlassian Document Format)格式

使用方式: 该技能基于 Jira REST API v3,通过 JiraClient 发起请求。需要先完成认证(见 jira-auth 技能),并具备项目访问权限以及目标项目的问题类型 ID。

实现模式包括:

  • 定义 JiraIssue 与 CreateIssueInput 等 TypeScript 接口
  • 提供 createIssue、getIssue、updateIssue、deleteIssue、bulkCreateIssues 等异步函数
  • 给出 curl 示例,涵盖创建、获取、更新、删除问题
  • 附有 API 端点汇总表(操作、方法、路径)

适用场景:

  • 在自动化流程或脚本中批量创建、更新、删除 Jira 问题
  • 需要以编程方式读取问题详情并提取字段信息
  • 需要按照 Jira 要求以 ADF 格式填写富文本描述
  • 需要按问题类型管理必填字段(如 Story 的 project.key、summary、issuetype.name)

限制与注意事项:

  • 需要已认证的 JiraClient
  • 需要项目访问权限
  • 需要目标项目的问题类型 ID
  • 描述必须使用 ADF 格式,不能使用纯文本
  • assignee 必须使用 account ID,不能使用邮箱
  • 创建请求必须包含 project key
  • 使用的问题类型名必须在项目中存在
  • 暂未提供关于收费、价格、平台支持、效果或使用步骤的更多信息