jira-plan 用于根据任务描述或会话上下文创建结构化的 Jira 子任务,供自治智能体执行。它有两种模式:任务模式会调查代码库、提出澄清问题后创建子任务;会话模式则读取已有的 .oh/<session>.md 上下文,跳过调查与提问,直接把选定方案拆解为子任务。
使用前需配置 Jira MCP 服务器,启动时检查 jira_search/jira_search_issues、jira_create_issue、jira_get_issue 等工具是否可用,否则退出并提示未配置。调用方式为 /jira-plan <父议题键> <任务描述或会话名>,例如任务模式 /jira-plan PROJ-123 "Add dark mode support to the dashboard",会话模式 /jira-plan PROJ-123 auth-refactor。系统通过判断 .oh/<参数>.md 是否存在且包含 Solution Space 来识别模式。
创建的子任务自包含、可执行、粒度适中,母议题类型为 Sub-task,描述采用 Jira wiki 标记(h2.、*、{code}),并打上 jira-planned 标签。若拆出多个子任务,会用 Blocks 或 is blocked by 关联依赖。拆分依据包括模块独立、前后端分离、可独立测试、风险不同等;不应拆分的情况包括集成简单、改动紧耦合、整体仍在 2-4 小时内。它不负责实现代码,也不为琐碎改动建任务。完成后必须调用 signal_completion,工具不可用时以 COMPLETION: 格式输出状态。
适用场景为需要把需求或会话方案转化为可追踪 Jira 子任务的规划阶段。限制是依赖 Jira MCP,且会话模式要求会话文件包含 Solution Space,否则报错。