SuperAPI AI 工具集

lisa-jira-sync

部署与运维

查看项目

更新于 10-15 20:13

技能介绍

用途:把当前计划进度同步到 JIRA 工单。调用形式为 Sync current plan progress to JIRA ticket: $ARGUMENTS;无参数时,从 plans/ 目录中最近修改的 .md 计划文件里查找工单 URL。可选参数 pr_url=<url> 指定实时 PR,merge_sha=<sha> 在合并后提供。所有 Atlassian 操作必须经由 lisa-atlassian-access,不得直接调用 MCP 工具或 acli。

主要能力与流程:

  1. 识别工单与上下文:解析工单 ID,通过 Skill 调用 lisa-atlassian-access,operation: read-ticket,key: <TICKET-ID> 获取工单状态;依据是否存在计划文件、工作分支、进行中任务、开放 PR、PR 是否合并,判断当前里程碑(Plan created、Implementation in progress、PR ready、PR merged)。
  2. 收集更新内容:按里程碑准备计划摘要、任务完成情况与阻塞项、PR 链接与测试结果、或最终摘要。
  3. 发布更新:发评论前先检查是否已有同一里程碑评论以避免重复(幂等);如无,则通过 operation: comment key: <TICKET-ID> body: "..." 添加评论,并视情况更新字段。 3b. 确保 PR 反向链接:当参数含 pr_url 时,优先使用 JIRA 开发链接或远程链接;不可用或无法验证时,创建以 [lisa-pr-link] 开头的受管评论,含里程碑与合并 SHA,并保持幂等。
  4. 建议状态流转:Plan created 建议 configured jira.workflow.claimed;PR ready 建议 jira.workflow.review;PR merged 建议对应环境的 jira.workflow.done。仅限配置工作流中列出的状态,未配置则只评论不流转。
  5. 父工单状态汇总(--rollup):按子工单(Epic→Story→Sub-task)汇总推导父状态;有阻塞则 Blocked,否则按 in-progress < dev < staging < production 环境阶梯取最不先进的环境状态,仅当解析结果为生产 Done 时做终态处理。本仓库 deploy.branches 仅声明 production: main,故生命周期为 Ready → In Progress → Code Review → Done。递归自底向上评估,不将父工单设为 build-ready 状态。无法解析则不猜测,只评论建议。

限制:永不自动流转工单状态,需用户确认;唯一例外是显式 --rollup 的父工单推导。重复运行同一里程碑不应产生重复评论。评论使用 JIRA markdown。工单到 PR 的链接在缺少原生集成或无法验证时才用评论兜底,且必须幂等。