用途
jira-plan 是一个 AI 智能体技能（Skill），用于读取 Jira 工单并产出结构化、可执行的实施计划，供智能体随后按待办清单执行。它同时支持 Feature/Story（功能/故事）工单和 Bug（缺陷）工单，并会根据工单类型自动切换分析方式。
触发方式包括用户主动调用 /jira-plan，或请求为某个 Jira 工单制定实施策略。典型请求如“为 PROJ-001 规划实施”“读取工单 PROJ-123 并创建计划”“jira-plan for [Ticket ID]”，也支持其他语言表述。
主要能力
工单信息提取。 技能会先查找可用的 Jira 站点/问题工具，解析目标站点与工单并复用已验证的上下文；仅在存在多个可能站点时询问用户。通过已配置的连接器获取工单内容；若连接器不可用，则基于用户提供的工单内容工作，并标注缺失的信息，不编造需求。提取字段包括：问题类型（Story、Task、Bug、Sub-task 等）、摘要、完整描述、验收标准（AC，适用于功能/故事工单）、复现步骤与预期/实际结果（适用于缺陷工单）、优先级与标签、相关关联工单或父史诗。
代码与仓库分析。 在最终确定计划前，检查仓库说明、相关实现、调用方、数据模式和测试，并记录具体路径与证据。若无法访问仓库，则将提议的文件与技术选择标记为暂定。对于影响用户界面的工单（缺陷工单同样适用），会读取设计系统相关技能（若已安装），并检查仓库实际的 UI 实现与文档，记录支撑计划的路径；仅使用有项目证据支持的组件、变体和令牌，不假设存在设计文档、设计工具或外部集成。
按工单类型分析。 功能/故事/任务工单：从描述和 AC 中识别功能需求，拆解为 API、数据模型、UI、测试等实施步骤，列出依赖、未知项与风险，并评估每步复杂度（低/中/高）。缺陷工单：区分已确认观察与假设，先规划复现和能证伪怀疑原因的关键检查（如检查配置、路由、选择器、集成或仓库细节），再选择修复方式；识别可能受影响的代码区域，定义修复策略，并列出回归风险与需验证的相关区域。
计划输出模板。 功能/故事计划包含：标题与类型、优先级、概述、验收标准分解表、实施步骤（带复杂度）、可能受影响的文件/模块、依赖与风险、完成定义（DoD）。缺陷修复计划包含：问题摘要、根因分析（已确认证据、假设及区分二者的下一步检查）、修复策略、实施步骤、需排查的文件/模块、回归检查、完成定义。当工单影响用户界面时，两类模板均可附加“UI 与设计系统”小节，涵盖受影响的界面或流程、现有组件与令牌、状态与交互要求、未决缺口或例外。
待办与交付。 如果存在任务/规划工具则使用之，否则返回 Markdown 清单；按依赖关系和风险排序，并将验证纳入相应实施步骤，在真正开始执行前保持待办项为待定状态。仅规划请求会直接返回计划而不启动实施；若用户已同时请求规划与实施，则在展示计划后继续执行，不重复索要许可，只就实质影响范围或行为的未决问题提问。
使用方式
通过 /jira-plan 或自然语言请求触发，指向具体工单 ID。技能依赖 Jira 连接器获取工单；若不可用，可由用户粘贴工单内容。计划过程会读取代码仓库；若仓库不可访问，相关文件与技术选择将被标记为暂定。最终以 Markdown 格式输出计划与待办清单。
适用场景
适用于需要把 Jira 功能或缺陷工单转化为可执行实施步骤的研发工作流，尤其是希望在编码前明确验收标准映射、受影响文件、依赖风险与回归验证范围的场景，也适合作为智能体编码前的规划阶段。
限制
该技能不会向 Jira 写回内容。实施完成后，可用时需显式调用 jira-cr 或 jira-bug；若单独安装，则提供基于证据的本地摘要，仅在用户要求发布时才使用可用的 Jira 工具。缺少验收标准或描述会使计划变为暂定，此时仅询问解决实质性歧义所必需的信息。对于子任务，应保留其依赖关系和边界，不自动纳入无关的关联工作。本资料未提供收费、价格或具体平台兼容性信息。