SuperAPI AI 工具集

filing-jira-tickets

通用与其它

查看项目

更新于 10-16 05:01

技能介绍

用途:把零散工作转化为可在脱离原始语境后仍能被读懂的 Jira 工单,并处理依赖链接。

主要能力:先读取目标项目的创建界面字段,再起草工单;create_issue 与 link_issues 默认执行试运行(dry run),返回完整载荷而不真正发送,正式写入需显式传 dryRun: false。未获明确指示时,每次创建前都需用户批准。

用法:第 1 步调用 get_create_fields,先传项目 key,再传意图问题类型,获取可创建类型及字段 id、是否必填、允许值。不同项目字段形状不同,例如 PM 与 SM 有 Acceptance criteria 字段,QA、VULN、PLT 没有;VULN 无 Story 类型,PLT 只能创建 Platform Initiative。不得假设字段 id、必填项或问题类型存在。若工具报 404,先检查项目 key 是否有拼写错误,仍无法解释则告知用户可能缺少创建权限并停止,不要猜测其他项目。

第 2 步起草:标题用祈使动词加结果与范围;描述只写实际工作与本题注意事项,不写来源文档路径或血缘套话;若有验收标准字段,以 Gherkin(Scenario、Given、When、Then、And)单字符串写入该字段,否则把每条 Gherkin 行作为独立 descriptionParagraphs 条目放入描述并告知用户;必填字段须全部提供,涉及业务判断的值应询问用户并给出允许值,不得猜测或直接选第一项;标签仅按用户要求。

第 3 步预览、批准、创建:逐单试运行,核对必填字段、验收标准位置、父项与标题,向用户展示标题、完整描述、验收标准、父项和标签的通俗预览,获批准后以 dryRun: false 创建并记录返回 key;若创建因字段报错,应重读第 1 步而非猜测修复。

第 4 步连接依赖:硬依赖用 Blocks,顺序或软关联用 Relates;Blocks 时 blockerKey 为须先落地项,blockedKey 为等待项,工具内部映射方向。link_issues 会回读验证,若报告无法验证,应告知用户并让其查看 Jira 的 Linked Issues 面板。

适用场景与限制:适用于 Bitwarden 多项目下的 Jira 工单规范化创建与依赖维护;未提供官方文本、收费与价格、平台可用性及其他使用步骤等事实。