核心操作

查看项目列表

mx_jira:
action: list_projects
max_results: 10

搜索 Issue（JQL）

mx_jira:
action: search_issues
jql: project = PROJ AND status != Done ORDER BY updated DESC
max_results: 10

重要： JQL 必须包含限制条件（如 project = X），不能使用无限制查询。

查看 Issue 详情

mx_jira:
action: get_issue
issue_key: PROJ-123

创建 Issue

mx_jira:
action: create_issue
project: PROJ
summary: 实现用户登录功能
issue_type: Task
description: 实现基于 JWT 的用户登录流程\n\n验收标准：\n- 支持邮箱+密码登录\n- 返回 JWT token
priority: High
labels: [backend, auth]

描述支持 Markdown 格式，自动转换为 Jira ADF（Atlassian Document Format）。

更新 Issue

mx_jira:
action: update_issue
issue_key: PROJ-123
fields: { summary: 新标题, priority: { name: High } }

切换 Issue 状态

mx_jira:
action: transition_issue
issue_key: PROJ-123
target_status: In Progress

自动查找匹配的 transition，无需手动指定 transition ID。
如果目标状态不可达，会返回所有可用的 transition 列表。

查看可用的状态转换

mx_jira:
action: get_transitions
issue_key: PROJ-123

添加评论

mx_jira:
action: add_comment
issue_key: PROJ-123
body: 代码已提交到 feature 分支，请 review。\n\n变更内容：\n- 添加了登录 API\n- 增加了单元测试

评论内容支持 Markdown，自动转换为 ADF。

常见工作流

每日 Standup — 查看我的待办

1. 1. mxjira: getmyself → 获取当前用户 accountId
2. mxjira: searchissues