其他
当用户处理 Jira issue/ticket…
用户提到 Jira issue(如 PROJ-123)、ticket、sprint、backlog,或要求创建/查看/更新/流转 Jira 工单时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 39/100 ×0.15
适用场景
当用户处理 Jira issue/tic特定
解决思路
- 检测后端:运行 `which jira`;若找到,使用 CLI 后端。
- 检测后端:若没有 CLI,查找 `mcp__atlassian__*` 工具;若可用,使用 MCP 后端。
- 检测后端:若两者都不可用,引导用户设置(见无后端部分)。
- 后端选择表:`jira` 命令可用时使用 CLI,参考 `references/commands.md`。
- 后端选择表:Atlassian MCP 工具可用时使用 MCP,参考 `references/mcp.md`。
- 后端选择表:两者都不可用时,引导安装 CLI。
- CLI:查看 issue 用 `jira issue view ISSUE-KEY`。
- CLI:列出我的 issue 用 `jira issue list -a$(jira me)`。
- CLI:查看我的进行中 issue 用 `jira issue list -a$(jira me) -s"In Progress"`。
- CLI:创建 issue 用 `jira issue create -tType -s"Summary" -b"Description"`。
- CLI:移动/流转 issue 用 `jira issue move ISSUE-KEY "State"`。
- CLI:分配给我用 `jira issue assign ISSUE-KEY $(jira me)`。
- CLI:取消分配用 `jira issue assign ISSUE-KEY x`。
- CLI:添加评论用 `jira issue comment add ISSUE-KEY -b"Comment text"`。
- CLI:在浏览器打开 issue 用 `jira open ISSUE-KEY`。
- CLI:查看当前 sprint 用 `jira sprint list --state active`。
- CLI:查看我是谁用 `jira me`。
- MCP:搜索 issue 用 `mcp__atlassian__searchJiraIssuesUsingJql`。
- MCP:查看 issue 用 `mcp__atlassian__getJiraIssue`。
- MCP:创建 issue 用 `mcp__atlassian__createJiraIssue`。
- MCP:更新 issue 用 `mcp__atlassian__editJiraIssue`。
- MCP:获取流转用 `mcp__atlassian__getTransitionsForJiraIssue`。
- MCP:执行流转用 `mcp__atlassian__transitionJiraIssue`。
- MCP:添加评论用 `mcp__atlassian__addCommentToJiraIssue`。
- MCP:用户查找用 `mcp__atlassian__lookupJiraAccountId`。
- MCP:列出项目用 `mcp__atlassian__getVisibleJiraProjects`。
- MCP:完整模式见 `references/mcp.md`。
- 识别触发语句:“create a jira ticket”。
- 识别触发语句:“show me PROJ-123”。
- 识别触发语句:“list my tickets”。
- 识别触发语句:“move ticket to done”。
- 识别触发语句:“what's in the current sprint”。
- 识别 issue key:模式为 `[A-Z]+-[0-9]+`(如 PROJ-123、ABC-1)。
- 用户提到 issue key 时,CLI 用 `jira issue view KEY` 或 `jira open KEY`。
- 用户提到 issue key 时,MCP 用 `mcp__atlassian__jira_get_issue` 并传入 key。
- 创建 ticket:若用户引用代码/ticket/PR,先研究上下文。
- 创建 ticket:起草 ticket 内容。
- 创建 ticket:与用户复核。
- 创建 ticket:用合适的后端创建。
- 更新 ticket:先获取 issue 详情。
- 更新 ticket:检查状态(对进行中的 ticket 要谨慎)。
- 更新 ticket:展示当前值与拟修改值。
- 更新 ticket:更新前获得批准。
- 更新 ticket:添加评论解释修改。
- 操作前问:当前状态是什么?始终先获取 issue,不要假设状态、负责人或字段与用户所想一致。
- 操作前问:还有谁受影响?检查 watchers、linked issues、parent epics;一个简单编辑可能通知 10 个人。
- 操作前问:是否可逆?流转可能单向门,有些工作流需要中间状态;描述编辑无撤销。
- 操作前问:是否有正确标识符?需要 issue keys、transition IDs、account IDs;展示名不能用于分配(MCP)。
- 绝不:未获取当前状态就执行流转;工作流可能需要中间状态,“To Do” → “Done” 若要求先 “In Progress” 可能静默失败。
- 绝不:MCP 中使用展示名分配;只有 account ID 有效,始终先调用 `lookupJiraAccountId`,否则分配静默失败。
- 绝不:不展示原文就编辑描述;Jira 无撤销,用户必须看到被替换的内容。
- 绝不:CLI 中在所有必填字段齐备前使用 `--no-input`;会静默失败且报错难懂,先检查项目必填字段。
- 绝不:假设流转名称是通用的;“Done”、“Closed”、“Complete” 因项目而异,始终先获取可用流转。
- 绝不:未经明确批准批量修改;每个 ticket 变更都会通知 watchers,10 次编辑 = 10 次通知风暴。
- 安全:始终在运行前展示命令/工具调用。
- 安全:修改 ticket 前始终获得批准。
- 安全:编辑时保留原始信息。
- 安全:应用后验证更新。
- 安全:始终清晰暴露认证问题,以便用户解决。
- 无后端时,引导用户选择其一:jira CLI(推荐):https://github.com/ankitpokhrel/jira-cli,安装 `brew install ankitpokhrel/jira-cli/jira-cli`,设置 `jira init`。
- 无后端时,引导用户选择其一:Atlassian MCP:在 MCP 设置中配置 Atlassian 凭据。
- 需要加载 reference:创建含复杂字段或多行内容的 issue。
- 需要加载 reference:构建超出简单过滤器的 JQL 查询。
- 需要加载 reference:排查错误或认证问题。
- 需要加载 reference:处理流转、链接或 sprint。
- 不要加载 reference:简单 view/list 操作(上面的 Quick Reference 已足够)。
- 不要加载 reference:基本状态检查(`jira issue view KEY`)。
- 不要加载 reference:在浏览器打开 issue。
- 任务与是否加载 reference:查看单个 issue 否。
- 任务与是否加载 reference:列出我的 ticket 否。
- 任务与是否加载 reference:带描述创建是(CLI 需要 `/tmp` 模式)。
- 任务与是否加载 reference:流转 issue 是(需要 transition ID 工作流)。
- 任务与是否加载 reference:JQL 搜索 是(复杂查询)。
- 任务与是否加载 reference:链接 issue 是(MCP 限制,需要脚本)。
- References:CLI 模式见 `references/commands.md`。
- References:MCP 模式见 `references/mcp.md`。
适用边界 · 注意事项
- 不适用于非 Jira 的 issue/ticket 系统(如 GitHub Issues、Linear)或没有 Jira/Atlassian 账号与实例访问权限的场景。
- 不适用于缺少 jira CLI 且未配置 Atlassian MCP 的环境;此时应先按无后端部分引导安装/配置,而不是直接操作。
- 不适用于未经用户批准就批量修改 ticket、修改描述或执行不可逆流转的场景。