用途
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)
使用方式
相关资料给出了实现模式:
-
创建 Agile 客户端扩展:在继承的 JiraClient 上新增 agileRequest 方法,请求地址以
${this.baseUrl}/rest/agile/1.0为前缀。示例代码使用 fetch,并合并 headers。若响应不 ok,则抛出包含状态码和错误 JSON 的异常。 -
在 TypeScript 中定义了 Board、BoardsResponse、Sprint、SprintIssue、CreateSprintInput 等接口,并给出 listBoards、getBoardSprints、getSprintIssues、moveIssuesToSprint、createSprint、startSprint、endSprint 等函数的示例实现。
-
资料同时提供 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 与看板相关。
- 资料中未提供收费、价格或平台可用性信息。