用途:jira-plan 用于把任务描述或已有会话上下文拆解为结构化的 Jira 子任务,供自主智能体执行。
主要能力:支持两种模式。任务模式会先调研代码库、提出澄清问题,再创建子任务;会话模式读取 .oh/<session>.md 中的 Solution Space 等上下文,跳过调研与提问,直接拆解。子任务包含 Goal、Context、Acceptance Criteria、Trade-offs Accepted、Notes 等字段,并统一打上 jira-planned 标签,必要时用 Blocks 链接依赖。
使用方式:需先配置 Jira MCP 服务器,并确认存在 jira_search、jira_create_issue、jira_get_issue 等工具,否则退出并提示未配置。调用示例:/jira-plan PROJ-123 "Add dark mode support to the dashboard"(任务模式);/jira-plan PROJ-123 auth-refactor(会话模式)。第一个参数为父议题键,第二个参数为任务描述或会话名。若 .oh/<arg>.md 存在且含 ## Solution Space 则进入会话模式,否则为任务模式。完成后必须调用 signal_completion 报告结果,不可用时以 COMPLETION: status=... 文本输出。
适用场景:需要把需求或已定方案拆成 1-4 小时粒度、可独立执行的 Jira 子任务时。
限制:仅做规划,不实现代码;不处理琐碎改动;不猜测 Jira 项目配置,需从父议题获取;描述使用 Jira wiki 标记而非 Markdown;会话模式要求会话文件含 Solution Space,否则报错。