jira-mcp 是一个用于通过 AI 代理创建 Jira 工单的技能，依赖于当前运行环境中已配置的 Atlassian MCP 工具（mcp__atlassian__* 系列）。其核心用途是帮助用户以结构化、可验证的方式新建 Jira 问题，同时避免误操作和重复创建。
一、主要能力 该技能覆盖新建 Story、Task、Bug、Sub-task 或其他 Jira 问题类型；发现项目与问题类型；检查必填字段；按 Jira 账户 ID 查找经办人；起草并确认摘要、描述、验收标准、标签、组件、优先级、父级、修复版本和自定义字段；创建后验证工单。需要注意的是，该技能不负责编辑、状态流转、评论、分配、关联或登记工时等操作，这些应路由到其他 Jira 操作技能。
二、使用方式 使用前需收集必要输入：项目键（除非可从上下文明确解析）、问题类型、摘要或足够起草摘要的上下文、描述或足够起草描述的上下文。根据情况还可收集验收标准、复现步骤、预期与实际行为、环境、链接、父级问题、经办人、优先级、标签、组件、修复版本、截止日期和自定义字段。技能不会虚构缺失的业务需求，仅询问创建工单所必需或会实质改变含义的信息。
工具调用顺序为：先通过 mcp__atlassian__getAccessibleAtlassianResources 解析 cloudId；使用 mcp__atlassian__getVisibleJiraProjects 验证或查找项目（检查创建权限时 action 设为 "create"）；通过 mcp__atlassian__getJiraProjectIssueTypesMetadata 列出项目可用问题类型；通过 mcp__atlassian__getJiraIssueTypeMetaWithFields 检查必填字段（先使用 requiredFieldsOnly: true）；需要分配时通过 mcp__atlassian__lookupJiraAccountId 查找经办人账户 ID；必要时通过 mcp__atlassian__searchJiraIssuesUsingJql 检查可能重复的工单；确认后调用 mcp__atlassian__createJiraIssue 创建；最后通过 mcp__atlassian__getJiraIssue 验证创建的工单。技能明确禁止使用硬编码别名或猜测元数据返回的 ID。
Cloud ID 解析方面，如果用户提供 Atlassian URL，可尝试其主机名作为 cloudId；若未知或失败，则调用 getAccessibleAtlassianResources，并在后续调用中复用解析出的 cloud ID。认证、站点选择和权限错误应直接呈现，但不暴露凭证或令牌。
项目与问题类型验证方面，需解析项目键，多项目匹配时让用户选择，不可静默按名称选择；获取项目问题类型并精确匹配用户请求的类型；若用户只说“ticket”或“Jira issue”且上下文不明确，应询问类型；获取必填字段并依据元数据识别必填自定义字段、父级要求和有效值，不因元数据中存在可选字段就发送可选字段。
起草规则要求工单紧凑且可执行：摘要清晰陈述结果或缺陷，不添加源材料中没有的事实；Story/Task 描述包含上下文、目标、范围、约束和验收标准（若提供）；Bug 描述包含实际行为、预期行为、复现步骤、环境、影响和证据（若提供）；保留用户提供的验收标准，不将假设转化为验收标准；精确保留 URL 和问题键；保留用户术语和标识符；除非明确需要 Atlassian Document Format，否则使用 Markdown 内容并传递 contentFormat: "markdown"。
构建创建载荷时需准备 cloudId、projectKey、issueTypeName、summary、description、contentFormat（通常为 markdown）、parent（仅用于有效子任务或明确请求的父级关系）、assignee_account_id（仅在账户查找后使用），以及 additional_fields（用于优先级、标签、组件、修复版本、截止日期和自定义字段）。自定义字段使用精确的元数据 ID 和有效值，不传递经办人显示名称，不在创建时应用状态流转（除非用户明确请求且 API 支持）。
重复检查在用户要求、请求来源于重复来源或摘要与现有工单高度相似时执行：构建限定项目和独特摘要短语的窄 JQL 查询，使用 searchResultMode: "issues"、最小字段列表和 responseContentFormat: "markdown" 搜索，展示可能匹配项并询问继续、更新现有工单还是取消。重复搜索不能证明不存在重复，因为 Jira 搜索可能不完整或对短语敏感。
创建前预览需包含项目与问题类型、摘要、描述与验收标准、经办人、父级、优先级、标签、组件、修复版本和自定义字段，以及任何推断值、未解决假设或可能重复项。获得确认后方可创建；缺少必需信息时应询问而非创建部分工单；批量请求需列出每张工单并获取完整范围的明确批准。
创建与验证方面，批准后调用一次 createJiraIssue，若返回明确的问题键或 ID，则调用 getJiraIssue 验证摘要、类型、描述、状态、经办人和重要字段。若创建失败且结果不明确，不要立即重试，先按精确项目和摘要搜索以避免重复。报告创建的问题键、可用 URL、最终状态以及 Jira 拒绝或默认设置的字段。
三、适用场景 适用于需要以 AI 代理辅助创建 Jira 工单的团队，特别是要求工单内容忠实于源材料、创建前需人工确认、需检查必填字段和避免重复的场景。也适用于需要批量创建前明确审批的流程。
四、限制 该技能仅处理新建工单，不处理编辑、状态流转、评论、分配、关联或工时登记。它依赖当前运行环境中可用的 mcp__atlassian__* 工具。不会猜测 cloud ID、账户 ID、自定义字段 ID 或必填字段值。不会将假设转化为需求或验收标准。不会暴露凭证、令牌或秘密。若请求操作不是创建工单，应停止并路由到正确的 Jira 技能。