jira-expert

Atlassian Jira 专家

精通 Jira 配置、项目管理、JQL、工作流、自动化与报表，覆盖 Jira 的全部技术与运营事务。

快速开始：最常用操作

本技能中的所有 MCP 示例均使用真实的 Atlassian 远程 MCP 工具（camelCase 形式，以 mcp__atlassian__<toolName> 呈现）。权威工具列表见 project-management/references/atlassian-mcp-tools.md。切勿自行编造工具名称；若列表中没有某项能力，则说明该能力无法通过 MCP 使用。

创建问题（首先调用一次 getAccessibleAtlassianResources 以获取 cloudId）：

mcp__atlassian__createJiraIssue (cloudId, projectKey="MYPROJ", issueTypeName="Story", summary="My new story")

运行 JQL 查询（使用随附脚本根据自然语言构建 JQL，然后执行）：

python3 scripts/jql_query_builder.py "high priority bugs assigned to me"
# → emits validated JQL, e.g.: assignee = currentUser() AND type = Bug AND status != Done

mcp__atlassian__searchJiraIssuesUsingJql (cloudId, jql="project = MYPROJ AND status != Done AND dueDate < now()")

创建项目：无法通过 MCP 完成。请使用 Jira 网页界面（Projects > Create project）或 REST API（POST /rest/api/3/project）。

完整工具参考请见 Atlassian MCP 集成。JQL 函数请见 JQL 函数参考。报表模板请见 报表模板。

---

工作流

创建项目

项目创建无法通过 MCP 完成，请在 Jira 网页界面（Projects > Create project）中或通过 REST API（POST /rest/api/3/project）执行第 2–6 步。创建后，使用 mcp__atlassian__getVisibleJiraProjects 验证可见性，并使用 mcp__atlassian__getJiraProjectIssueTypesMetadata 检查问题类型。

1. 确定项目类型（Scrum、Kanban、缺陷跟踪等）
2. 使用合适的模板创建项目（网页界面 / REST）
3. 配置项目设置：
   • 名称、Key、描述
   • 项目负责人与默认经办人
   • 通知方案
   • 权限方案
4. 设置问题类型与工作流
5. 如有需要，配置自定义字段
6. 创建初始看板/待办事项视图
7. 移交给：Scrum Master 进行团队入职

工作流设计

工作流/方案编辑无法通过 MCP 完成，请在 Jira Settings > Issues > Workflows 中配置。部署前请使用随附的校验器检查反模式。

1. 梳理流程状态（待办 → 进行中 → 完成）
2. 定义流转及其条件
3. 在 Jira 中构建之前检查设计：

   python3 scripts/workflow_validator.py workflow.json --format json
   

   输入：一个包含工作流 states 与 transitions 的 JSON 文件。处理输出：在操作 Jira 之前，修复报告的每一个反模式（死胡同状态、不可达状态、缺失的流转）。
4. 添加验证器、后置函数和条件；配置工作流方案（网页界面）
5. 验证：先部署到测试项目；在关联生产项目之前，确认所有流转、条件和后置函数均按预期运行
6. 将工作流关联到项目
7. 使用示例问题测试工作流：通过 MCP，先对示例问题调用 mcp__atlassian__getTransitionsForJiraIssue，确认预期流转可见，再调用 mcp__atlassian__transitionJiraIssue 逐步走完流程

JQL 查询构建

首先使用随附构建器，它会将自然语言匹配为经过验证的 JQL：

python3 scripts/jql_query_builder.py "high priority bugs assigned to me" --format json
python3 scripts/jql_query_builder.py --patterns   # list all supported query patterns

处理输出：从 JSON 结果中取出 jql 字段（或文本模式下 GENERATED JQL 代码块中的内容），然后使用 mcp__atlassian__searchJiraIssuesUsingJql (cloudId, jql=<generated>) 执行。如果构建器未匹配到任何模式，请参考下方参考手动编写 JQL。

基本结构：field operator value

常用运算符：

• =, !=：等于、不等于
• ~, !~：包含、不包含
• >, <, >=, <=：比较
• in, not in：列表成员判断
• is empty, is not empty：为空、不为空
• was, was in, was not：曾经为、曾经属于、曾经不为
• changed：已变更

实用 JQL 示例：

查找逾期问题：

dueDate < now() AND status != Done

Sprint 燃尽问题：

sprint = 23 AND status changed TO "Done" DURING (startOfSprint(), endOfSprint())

查找陈旧问题：

updated < -30d AND status != Done

跨项目史诗追踪：

"Epic Link" = PROJ-123 ORDER BY rank

速率计算：

sprint in closedSprints() AND resolution = Done

团队容量：

assignee in (user1, user2) AND sprint in openSprints()

仪表盘创建

1. 创建新仪表盘（个人或共享）
2. 添加相关小组件：
   • 筛选结果（基于 JQL）
   • Sprint 燃尽图
   • 速率图
   • 创建与解决对比
   • 饼图（状态分布）
3. 调整布局，确保易读
4. 配置自动刷新
5. 与相应团队共享
6. 移交给：高级 PM 或 Scrum Master 使用

自动化规则

1. 定义触发器（问题创建、字段变更、定时）
2. 添加条件（如适用）
3. 定义操作：
   • 更新字段
   • 发送通知
   • 创建子任务
   • 流转问题
   • 发布评论
4. 使用示例数据测试自动化
5. 启用并监控

高级功能

自定义字段

何时创建：

• 跟踪标准字段之外的数据
• 记录特定流程的信息
• 支持高级报表

字段类型：文本、数值、日期、选择（单选/多选/级联）、用户选择器

配置：

1. 创建自定义字段
2. 配置字段上下文（适用的项目/问题类型）
3. 添加到相应的界面
4. 如有需要，更新搜索模板

问题关联

关联类型：

• 阻塞 / 被阻塞
• 相关
• 重复 / 被重复
• 克隆 / 被克隆
• 史诗-故事关系

最佳实践：

• 使用史诗关联对功能进行分组
• 使用阻塞关联展示依赖关系
• 在评论中记录关联原因

权限与安全

权限方案：

• 浏览项目
• 创建/编辑/删除问题
• 管理项目
• 管理 Sprint

安全级别：

• 定义机密问题的可见性
• 控制对敏感数据的访问
• 审计安全变更

批量操作

批量修改：

1. 使用 JQL 查找目标问题
2. 选择批量修改操作
3. 选择要更新的字段
4. 验证：执行前预览所有变更；确认 JQL 筛选条件只匹配预期的问题，批量编辑很难撤销
5. 执行并确认
6. 监控后台任务

批量流转：

• 将多个问题推进工作流
• 适用于 Sprint 收尾清理
• 需要相应权限
• 验证：运行 JQL 筛选并检查结果，先小批量测试，再大规模应用

JQL 函数参考

提示：将常用查询保存为命名筛选器，而不是临时反复运行复杂的 JQL。性能相关指导请参阅最佳实践。

日期：startOfDay()、endOfDay()、startOfWeek()、endOfWeek()、startOfMonth()、endOfMonth()、startOfYear()、endOfYear()

Sprint：openSprints()、closedSprints()、futureSprints()

用户：currentUser()、membersOf("group")

高级：issueHistory()、linkedIssues()、issuesWithFixVersions()

报表模板

提示：这些 JQL 片段可保存为共享筛选器，或直接接入仪表盘小组件（参见仪表盘创建）。

报表	JQL
Sprint 报告	project = PROJ AND sprint = 23
团队速率	assignee in (team) AND sprint in closedSprints() AND resolution = Done
Bug 趋势	type = Bug AND created >= -30d
阻塞项分析	priority = Blocker AND status != Done

决策框架

何时升级给 Atlassian 管理员：

• 需要新的项目权限方案
• 需要在全组织范围内统一的自定义工作流方案
• 用户开通或注销
• 许可证或计费问题
• 系统级配置变更

何时与 Scrum Master 协作：

• Sprint 看板配置
• 待办事项优先级视图
• 团队专属筛选器
• Sprint 报告需求

何时与高级 PM 协作：

• 组合级报告
• 跨项目仪表盘
• 管理层可视化需求
• 多项目依赖关系

交接协议

来自 Senior PM:

• 项目结构要求
• 工作流与字段需求
• 报告要求
• 集成需求

交给 Senior PM:

• 跨项目指标
• 问题趋势与模式
• 工作流瓶颈
• 数据质量洞察

来自 Scrum Master:

• Sprint 看板配置请求
• 工作流优化需求
• 待办事项筛选要求
• 速度跟踪设置

交给 Scrum Master:

• 已配置的 Sprint 看板
• 速度报告
• 燃尽图
• 团队容量视图

最佳实践

数据质量:

• 通过字段验证规则强制填写必填字段
• 按项目类型统一使用问题键命名约定
• 定期清理过期或孤立的问题

性能:

• 避免在 JQL 中使用前导通配符（对大型文本字段使用 ~ 开销很大）
• 使用已保存的筛选器，而不是临时反复运行复杂的 JQL
• 限制仪表板小工具数量，以缩短页面加载时间
• 对已完成的项目进行归档而非删除，以保留历史记录

治理:

• 记录自定义工作流状态和流转的设计依据
• 在修改前对权限/工作流方案进行版本控制
• 组织范围的方案更新需要经过变更管理评审
• 用户角色变更后执行权限审计

Atlassian MCP 集成

主要工具: Atlassian 远程 MCP 服务（随附 .mcp.json，服务键为 atlassian）。工具以 mcp__atlassian__<toolName> 形式呈现。标准工具列表: project-management/references/atlassian-mcp-tools.md。切勿自行编造工具名称——如果某项能力不在该列表中，请改用 Web UI 或 REST API。

关键操作及示例调用（通过 mcp__atlassian__getAccessibleAtlassianResources 获取一次 cloudId）：

创建问题（先用 getJiraIssueTypeMetaWithFields 检查必填字段）：

mcp__atlassian__createJiraIssue (cloudId, projectKey="MYPROJ", issueTypeName="Story", summary="My new story")

执行 JQL 查询：

mcp__atlassian__searchJiraIssuesUsingJql (cloudId, jql="project = MYPROJ AND status != Done AND dueDate < now()")

更新问题字段：

mcp__atlassian__editJiraIssue (cloudId, issueIdOrKey="MYPROJ-42", fields=<payload — discover via tool schema>)

流转问题（状态变更通过流转完成，而非直接编辑字段）：

mcp__atlassian__getTransitionsForJiraIssue (cloudId, issueIdOrKey="MYPROJ-42")
mcp__atlassian__transitionJiraIssue (cloudId, issueIdOrKey="MYPROJ-42", transition=<id from previous call>)

评论 / 记录工时 / 关联问题：

mcp__atlassian__addCommentToJiraIssue (cloudId, issueIdOrKey="MYPROJ-42", body="...")
mcp__atlassian__addWorklogToJiraIssue (cloudId, issueIdOrKey="MYPROJ-42", timeSpent=<discover via tool schema>)
mcp__atlassian__createIssueLink (cloudId, link type from mcp__atlassian__getIssueLinkTypes)

MCP 不支持，请改用 Web UI 或 REST API：

• 创建项目 → Jira UI Projects > Create project 或 POST /rest/api/3/project
• 创建 Sprint 或配置看板 → Jira Software UI 或 POST /rest/agile/1.0/sprint
• 创建/共享筛选器 → Jira UI Filters > Save as 或 POST /rest/api/3/filter
• 自定义字段、屏幕、工作流/权限方案 → Jira 管理 UI

集成点:

• 为 Senior PM 报告提取指标
• 为 Scrum Master 配置 Sprint 看板
• 为 Confluence Expert 创建文档页面
• 为 Template Creator 提供模板创建支持

相关 Skills

• Confluence Expert (project-management/confluence-expert/) — 文档与 Jira 工作流相辅相成
• Atlassian Admin (project-management/atlassian-admin/) — Jira 项目的权限与用户管理