{"skill":{"slug":"jira-workflow","displayName":"Jira Workflow","summary":"Jira Cloud 项目管理集成。搜索/创建/更新 Issue，切换状态，添加评论，查看项目和看板。通过 MorphixAI 代理安全访问 Jira API。","description":"---\nname: jira-workflow\ndescription: Jira Cloud 项目管理集成。搜索/创建/更新 Issue，切换状态，添加评论，查看项目和看板。通过 MorphixAI 代理安全访问 Jira API。\nmetadata:\n  openclaw:\n    emoji: \"🎫\"\n    requires:\n      env: [MORPHIXAI_API_KEY]\n---\n\n# Jira 项目管理\n\n通过 `mx_jira` 工具管理 Jira Cloud 中的 Issue、项目和工作流。所有操作通过 MorphixAI 代理，无需直接管理 OAuth token。\n\n## 前置条件\n\n1. **安装插件**: `openclaw plugins install openclaw-morphixai`\n2. **获取 API Key**: 访问 [morphix.app/api-keys](https://morphix.app/api-keys) 生成 `mk_xxxxxx` 密钥\n3. **配置环境变量**: `export MORPHIXAI_API_KEY=\"mk_your_key_here\"`\n4. **链接账号**: 访问 [morphix.app/connections](https://morphix.app/connections) 链接 Jira 账号，或通过 `mx_link` 工具链接（app: `jira`）\n\n## 核心操作\n\n### 查看项目列表\n\n```\nmx_jira:\n  action: list_projects\n  max_results: 10\n```\n\n### 搜索 Issue（JQL）\n\n```\nmx_jira:\n  action: search_issues\n  jql: \"project = PROJ AND status != Done ORDER BY updated DESC\"\n  max_results: 10\n```\n\n> **重要：** JQL 必须包含限制条件（如 `project = X`），不能使用无限制查询。\n\n### 查看 Issue 详情\n\n```\nmx_jira:\n  action: get_issue\n  issue_key: \"PROJ-123\"\n```\n\n### 创建 Issue\n\n```\nmx_jira:\n  action: create_issue\n  project: \"PROJ\"\n  summary: \"实现用户登录功能\"\n  issue_type: \"Task\"\n  description: \"实现基于 JWT 的用户登录流程\\n\\n**验收标准：**\\n- 支持邮箱+密码登录\\n- 返回 JWT token\"\n  priority: \"High\"\n  labels: [\"backend\", \"auth\"]\n```\n\n> 描述支持 Markdown 格式，自动转换为 Jira ADF（Atlassian Document Format）。\n\n### 更新 Issue\n\n```\nmx_jira:\n  action: update_issue\n  issue_key: \"PROJ-123\"\n  fields: { \"summary\": \"新标题\", \"priority\": { \"name\": \"High\" } }\n```\n\n### 切换 Issue 状态\n\n```\nmx_jira:\n  action: transition_issue\n  issue_key: \"PROJ-123\"\n  target_status: \"In Progress\"\n```\n\n> 自动查找匹配的 transition，无需手动指定 transition ID。\n> 如果目标状态不可达，会返回所有可用的 transition 列表。\n\n### 查看可用的状态转换\n\n```\nmx_jira:\n  action: get_transitions\n  issue_key: \"PROJ-123\"\n```\n\n### 添加评论\n\n```\nmx_jira:\n  action: add_comment\n  issue_key: \"PROJ-123\"\n  body: \"代码已提交到 feature 分支，请 review。\\n\\n**变更内容：**\\n- 添加了登录 API\\n- 增加了单元测试\"\n```\n\n> 评论内容支持 Markdown，自动转换为 ADF。\n\n## 常见工作流\n\n### 每日 Standup — 查看我的待办\n\n```\n1. mx_jira: get_myself  → 获取当前用户 accountId\n2. mx_jira: search_issues\n   jql: \"assignee = <accountId> AND status != Done ORDER BY priority DESC, updated DESC\"\n```\n\n### 创建 Issue 并开始工作\n\n```\n1. mx_jira: create_issue → 获取 issue_key\n2. mx_jira: transition_issue, target_status: \"In Progress\"\n3. mx_jira: add_comment, body: \"开始开发\"\n```\n\n### 完成 Issue\n\n```\n1. mx_jira: add_comment, body: \"开发完成，PR: <url>\"\n2. mx_jira: transition_issue, target_status: \"Done\"\n```\n\n## 注意事项\n\n- Jira API v3 使用 ADF 格式，本工具自动转换 Markdown/纯文本，无需手动构建 ADF JSON\n- JQL 查询必须包含 `project = X` 等限制条件\n- `transition_issue` 只能转换到当前状态可达的目标状态\n- `account_id` 参数通常省略，工具自动检测已链接的 Jira 账号\n","tags":{"latest":"0.1.1"},"stats":{"comments":0,"downloads":731,"installsAllTime":1,"installsCurrent":1,"stars":0,"versions":2},"createdAt":1772677651178,"updatedAt":1778491726627},"latestVersion":{"version":"0.1.1","createdAt":1772786463131,"changelog":"- 增加了详细的前置条件说明，包括插件安装、API Key 获取、环境变量配置和账号链接步骤\n- 提供了官方链接以获取 API 密钥和链接 Jira 账号\n- 原有功能与使用示例保持一致，未做其他变更","license":null},"metadata":{"setup":[{"key":"MORPHIXAI_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"paul-leo","userId":"s1752kcbgt0ajgbfqwd4y5vb3n83kvp4","displayName":"Paul Leo","image":"https://avatars.githubusercontent.com/u/55380315?v=4"},"moderation":null}