SuperAPI AI 工具集

jira-agile

办公与效率

查看项目

更新于 10-13 15:22

技能介绍

用途

jira-agile 技能用于管理 Jira Agile 看板和冲刺,覆盖列出看板、管理冲刺(创建、启动、结束)、在冲刺之间移动 Issue 以及获取冲刺 Issue 等操作。

主要能力

  • 列出 Scrum/Kanban 看板(支持按类型、项目 key/ID 过滤,支持分页)
  • 获取指定看板的冲刺列表(可按状态过滤 future/active/closed)
  • 获取指定冲刺的 Issue(支持 maxResults、startAt 分页)
  • 将 Issue 移入冲刺(支持 rankBeforeIssue、rankAfterIssue 排序选项)
  • 创建冲刺(可指定 name、boardId、startDate、endDate、goal)
  • 启动冲刺与结束冲刺(切换 state 为 active 或 closed)

使用方式

相关资料给出了实现模式:

  1. 创建 Agile 客户端扩展:在继承的 JiraClient 上新增 agileRequest 方法,请求地址以 ${this.baseUrl}/rest/agile/1.0 为前缀。示例代码使用 fetch,并合并 headers。若响应不 ok,则抛出包含状态码和错误 JSON 的异常。

  2. 在 TypeScript 中定义了 Board、BoardsResponse、Sprint、SprintIssue、CreateSprintInput 等接口,并给出 listBoards、getBoardSprints、getSprintIssues、moveIssuesToSprint、createSprint、startSprint、endSprint 等函数的示例实现。

  3. 资料同时提供 curl 示例,包括 List Boards、Get Board Sprints、Move Issues to Sprint、Create Sprint 等调用方式,使用 Basic 认证(email:token 的 base64 编码)。

适用场景

  • 需要在工具或脚本中列出 Jira 看板并查看其冲刺时
  • 需要创建、启动或结束冲刺时
  • 需要批量把 Issue 加入冲刺或在冲刺之间移动时
  • 需要读取某个冲刺下的 Issue 列表时

限制与注意事项

  • 必须先具备已认证的 JiraClient(参见 jira-auth 技能),并拥有看板/冲刺管理权限。
  • 使用 Agile API 路径 /rest/agile/1.0/,而不是 /rest/api/3/(常见错误之一)。
  • 不能向已关闭的冲刺添加 Issue;Kanban 看板没有冲刺;冲刺 ID 与看板相关。
  • 资料中未提供收费、价格或平台可用性信息。