mcpField
J
jira

jira

github.com/davila7生产力33.0k1.2k 次安装1 天前更新
代码仓库

关于 jira

面向通过自然语言处理 Jira 任务的用户，可使用 jira CLI 或 Atlassian MCP 工具执行操作。技能会先检查可用后端，并要求在修改前核对状态、展示变更并取得批准。

主要功能

  1. 01检测并选择 CLI 或 MCP 后端
  2. 02查看、搜索和创建工单
  3. 03更新工单状态与负责人
  4. 04添加评论并查询冲刺
  5. 05修改前检查并取得批准

适用场景

  1. 01查看指定 Jira 工单
  2. 02列出个人任务或当前冲刺
  3. 03经确认后创建或更新工单

MCP 相关

可在检测到 Atlassian MCP 工具时使用 MCP 后端，通过相应工具搜索、读取、创建和修改 Jira 工单。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davila7/claude-code-templates --skill jira

安装后在 Claude Code 中输入/jira确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
commands.md
mcp.md

详细介绍

Jira

通过自然语言与 Jira 交互。支持多个后端。

后端检测

先运行此检查，以确定要使用哪个后端：

1. Check if jira CLI is available:
   → Run: which jira
   → If found: USE CLI BACKEND

2. If no CLI, check for Atlassian MCP:
   → Look for mcp__atlassian__* tools
   → If available: USE MCP BACKEND

3. If neither available:
   → GUIDE USER TO SETUP
后端使用时机参考
CLIjira 命令可用references/commands.md
MCPAtlassian MCP 工具可用references/mcp.md
None两者均不可用指引安装 CLI

快速参考（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)
取消分配jira issue assign ISSUE-KEY x
添加评论jira issue comment add ISSUE-KEY -b"Comment text"
在浏览器中打开jira open ISSUE-KEY
当前冲刺jira sprint list --state active
我是谁jira me

快速参考（MCP）

使用 CLI 后端时跳过此部分。

意图MCP 工具
搜索问题mcp__atlassian__searchJiraIssuesUsingJql
查看问题mcp__atlassian__getJiraIssue
创建问题mcp__atlassian__createJiraIssue
更新问题mcp__atlassian__editJiraIssue
获取转换状态mcp__atlassian__getTransitionsForJiraIssue
转换状态mcp__atlassian__transitionJiraIssue
添加评论mcp__atlassian__addCommentToJiraIssue
查询用户mcp__atlassian__lookupJiraAccountId
列出项目mcp__atlassian__getVisibleJiraProjects

完整的 MCP 用法请参阅 references/mcp.md。

触发语句

  • “创建 Jira 工单”
  • “给我看看 PROJ-123”
  • “列出我的工单”
  • “将工单移至已完成”
  • “当前冲刺中有哪些内容”

问题键检测

问题键遵循以下格式：[A-Z]+-[0-9]+（例如，PROJ-123、ABC-1）。

当用户在对话中提及问题键时：

  • CLI： jira issue view KEY 或 jira open KEY
  • MCP： 使用问题键调用 mcp__atlassian__jira_get_issue

工作流

创建工单：

  1. 如果用户提到了代码、工单或 PR，先调研相关背景
  2. 起草工单内容
  3. 与用户确认
  4. 使用适当的后端创建工单

更新工单：

  1. 先获取问题详情
  2. 检查状态（对进行中的工单要谨慎）
  3. 展示当前内容与拟议更改
  4. 更新前获得批准
  5. 添加评论说明更改内容

执行任何操作前

先问自己：

  1. 当前状态是什么？ — 始终先获取问题信息。不要假设状态、经办人或字段与用户认为的一致。

  2. 还会影响谁？ — 检查关注者、关联问题和父级史诗。“简单编辑”也可能通知 10 个人。

  3. 此操作可撤销吗？ — 状态转换可能设有单向关卡。某些工作流需要经过中间状态。描述编辑无法撤销。

  4. 标识符是否正确？ — 检查问题键、转换 ID 和账户 ID。分配时不能使用显示名称（MCP）。

绝不

  • 绝不在获取当前状态前进行转换 — 工作流可能要求先经过中间状态。从“To Do”直接转到“Done”可能会在需要先转到“In Progress”时静默失败。

  • 绝不使用显示名称进行分配（MCP） — 只有账户 ID 才有效。务必先调用 lookupJiraAccountId，否则分配会静默失败。

  • 绝不在展示原始内容前编辑描述 — Jira 不支持撤销。用户必须先看到将要替换的内容。

  • 绝不在未填写所有必填字段时使用 --no-input（CLI） — 这会静默失败，并显示含糊的错误。请先检查项目的必填字段。

  • 绝不假设转换名称通用 — “Done”、“Closed”和“Complete”会因项目而异。务必先获取可用的转换。

  • 绝不在未经明确批准的情况下批量修改 — 每次更改工单都会通知关注者。修改 10 项 = 发送 10 轮通知。

安全

  • 执行前务必展示命令／工具调用
  • 修改工单前务必征得批准
  • 编辑时保留原始信息
  • 应用更改后务必验证
  • 务必清楚说明身份验证问题，以便用户解决

没有可用的后端

如果 CLI 和 MCP 都不可用，请引导用户：

To use Jira, you need one of:

1. **jira CLI** (recommended):
   https://github.com/ankitpokhrel/jira-cli

   Install: brew install ankitpokhrel/jira-cli/jira-cli
   Setup:   jira init

2. **Atlassian MCP**:
   Configure in your MCP settings with Atlassian credentials.

深入了解

在以下情况下加载参考资料：

  • 创建带有复杂字段或多行内容的问题
  • 构建超出简单筛选范围的 JQL 查询
  • 排查错误或身份验证问题
  • 处理状态转换、关联或冲刺

在以下情况下不要加载参考资料：

  • 简单的查看／列表操作（上方的快速参考已足够）
  • 基本状态检查（jira issue view KEY）
  • 在浏览器中打开问题
任务是否加载参考资料？
查看单个问题否
列出我的工单否
创建带描述的问题是 — CLI 需要 /tmp 模式
转换问题状态是 — 需要转换 ID 工作流
JQL 搜索是 — 用于复杂查询
关联问题是 — MCP 有限制，需要使用脚本

参考资料：

  • CLI 模式：references/commands.md
  • MCP 模式：references/mcp.md

评论

支持 Markdown