SuperAPI AI 工具集

jira-pm

通用与其它

查看项目

更新于 10-16 07:24

技能介绍

用途:在智能体上下文中集成Jira,用于项目待办管理、冲刺规划、需求跟踪与开发期问题跟踪。无独立工具脚本,通过智能体上下文调用。

必需配置:JIRA_URL(Jira实例基础URL)、JIRA_API_TOKEN(在Jira账户设置的“安全-API令牌”生成)、JIRA_USER_EMAIL(与令牌关联的邮箱)。可选:JIRA_DEFAULT_PROJECT(默认项目键)、JIRA_API_VERSION(默认3)。

主要能力:问题类——search(JQL搜索)、get-issue、create-issue(需确认)、update-issue(需确认)、transition(需确认);项目类——list-projects、project-info;冲刺类——active-sprint、sprint-issues;评论类——get-comments、add-comment。常用流程:列项目→项目信息→创建问题→加评论;获取活跃冲刺→列冲刺问题→更新状态→加评论;用JQL定向搜索→取详情→更新。

使用限制与注意:创建问题必须包含summary、issuetype、project三个字段,否则返回400;改状态必须走POST /issue/{key}/transitions,不可用PUT /issue更新字段绕过工作流;搜索必须用JQL而非拉取全部问题本地过滤;创建前先用JQL查重;字段ID需动态获取,勿硬编码;Jira Cloud限流约每分钟300次请求,遇429需指数退避并检查Retry-After。

错误处理涵盖认证失败、限流、无效输入与网络错误。建议缓存项目、问题类型与流转元数据,批量调用,创建前验证项目与问题类型。上下文优化支持懒加载、字段选择、缓存与分页,据称比加载完整Jira MCP服务器节省90%以上上下文。

记忆协议要求:开始前读取.claude/context/memory/learnings.md,完成后将新模式、发现的问题、决策分别写入对应记忆文件。

API端点涉及/rest/api/3/search、/issue、/issue/{key}/transitions、/project、/rest/agile/1.0/board/{boardId}/sprint、/rest/agile/1.0/sprint/{sprintId}/issue、/issue/{key}/comment等。完整参考见Atlassian官方REST v3文档。费用、托管平台等未在资料中说明。