SuperAPI AI 工具集

make-jira-from-spec

设计与创作

查看项目

更新于 10-16 03:11

技能介绍

用途:把规格变更转成 Jira 工作项。读取当前会话或 PR 中 .ai/spec/ 的规格差异,头脑风暴拆解,创建或更新 Epic 和 Story,再对每项做估算与风险评估。

主要能力:

  • 从 PR URL 或当前会话(含各仓库未跟踪的新规格文件)收集 .ai/spec/ 变更。
  • 多 PR 重叠检测:同一规格文件出现在多个 PR 时,先标记并让用户选择基线,不静默取舍。
  • 用 superpowers:brainstorming 生成工作拆解,要求每个实现 Story 都有对应测试 Story 或测试 AC;若存在无测试覆盖的实现 Story,不进入下一步。
  • 解析父级:不在 Feature Request 下创建 Story;Story 必须在 Epic 下,缺 Epic 时搜索或让用户选择。
  • 搜索父级下已有 Jira 项,匹配后区分更新或新建。
  • 展示计划并等待用户确认,测试列可为 AC、#N、covers #N、waived、—、NONE。
  • 执行时先解析 cloudId,创建 Epic 再创建实现 Story、测试 Story,并强制将新建项流转到 Refinement(transition ID 31)并验证,失败重试一次后报错。
  • 更新已有项时保留未改内容,合并新 AC 与继承标签。
  • 描述使用 markdown,含 User Story、Description、Acceptance Criteria、Testing、Spec Reference;Epic 省略 User Story,改用 Overview 与 Scope。
  • 对全部项运行 /estimate-story、/estimate-risk、/estimate-epic;超过 5 SP 的 Story 用头脑风暴拆分,每个子 Story 目标 ≤ 3 SP,仅当拆出 ≥ 3 个具有独立关注点的 Story 时才新建兄弟 Epic。
  • 若起点是 Feature Request,最后在其上发布汇总评论(用裸 issue key)。

使用方式:/make-jira-from-spec [PR URL...] 或 /make-jira-from-spec OLS-1234,参数可组合。默认项目键 OLS,Cloud ID redhat.atlassian.net,内容格式 markdown,SP、Risk Score、Epic Size 使用指定自定义字段。

适用场景:规格驱动开发中,把跨仓库的规格变更系统化落成 Jira Epic/Story,并保证测试覆盖与估算。

限制:需接入 Jira 与 gh CLI;创建前必须获得用户明确批准;存在测试缺口时仅可 approve-with-gaps;未提供 Jira 凭据、权限或失败处理等细节。