用途:让智能体以自然语言与 Jira 交互,处理工单的查看、创建、更新、流转、评论、分配及冲刺状态查询等操作,支持 CLI 与 MCP 两种后端。
主要能力:查看工单(jira issue view ISSUE-KEY)、列出我的工单(jira issue list -a$(jira me))、筛选进行中(jira issue list -a$(jira me) -s"In Progress")、创建(jira issue create -tType -s"Summary" -b"Description")、流转(jira issue move ISSUE-KEY "State")、分配与取消分配(jira issue assign ISSUE-KEY $(jira me) / x)、评论(jira issue comment add ISSUE-KEY -b"Comment text")、浏览器打开(jira open ISSUE-KEY)、当前冲刺(jira sprint list --state active)。MCP 后端提供搜索、获取、创建、编辑工单、获取与执行流转、添加评论、账户查询、项目列表等对应工具。
使用方式:先检测后端,运行 which jira,若存在则用 CLI;否则查找 mcp__atlassian__* 工具,有则用 MCP;两者均无则引导安装 jira CLI(brew install ankitpokhrel/jira-cli/jira-cli,配置 jira init)或配置 Atlassian MCP。工单键格式为 [A-Z]+-[0-9]+。
限制与安全:不得在未获取当前状态时流转,工单状态名因项目而异;MCP 分配只能使用账户 ID,需先调用 lookupJiraAccountId;编辑描述前须展示原文,因无撤销;CLI 使用 --no-input 需提供全部必填字段;批量修改须获明确同意,以免触发通知。执行命令前应展示调用并取得确认,修改后验证结果,认证问题需明确告知用户。复杂场景(多行内容、复杂 JQL、链路、冲刺、排错)需加载对应参考文档。