SuperAPI AI 工具集

krt-jira-scribe

办公与效率

查看项目

更新于 10-15 21:38

技能介绍

用途:在西班牙语 Jira Server/Data Center 实例中安全地管理工单,包括校验已有全局工单与子任务、判断新工作是否应挂在已有父工单下、记录 PR 反向链接以及处理最终状态流转。由于 Jira 是共享外部系统,未经显式确认不得创建工单、子任务、PR 反向链接、评论或执行状态流转。

主要能力:按项目、类型和摘要搜索候选工单;仅将处于 open 或 in progress 状态的工单视为可复用候选;避免“一父一子”的 Jira 形态,若只有一个父任务和一个子任务且无兄弟任务,应合并为一个独立 Tarea;多 PR 交付时默认提议新建父 Tarea 加每个 PR/工作包一个 Subtarea;新建全局工单默认加入活跃 Sprint(用户明确说 sin sprint 等除外);子任务不单独加入 Sprint。

使用方式:开始前加载 references/safety.md 与 references/jira-api.md。运行时仅使用环境变量,项目本地唯一支持的来源是当前检出目录的 .krt/env/jira-scribe.env,包含 JIRA_HOST、JIRA_API_TOKEN、JIRA_PROJECT_KEY,可选 JIRA_EMAIL、JIRA_BOARD_ID。可用 scripts/setup_jira_env.py 初始化配置,用 scripts/check_jira_env.py --root <consumer-project-root> 检查就绪状态,Jira API 调用须经 scripts/run_with_jira_env.py --root <consumer-project-root> -- <command ...>。API 基址为 /rest/api/2,认证用 Authorization: Bearer $JIRA_API_TOKEN,敏捷 API 为 /rest/agile/1.0。凭据校验须采用双端点策略,不能只依赖 /rest/api/2/myself。

适用场景:西班牙语 Jira 实例中的工单创建与复用、子任务管理、PR 反向链接、状态流转,以及由 krt-release-marshal 发起的自动化后置操作。

限制:仅支持 Jira Server/Data Center;摘要、描述、评论、确认与提示必须使用西班牙语,且自主生成的文本须通过 scripts/check_jira_text.py;JQL 关键字保持英文;状态流转名称须从 API 实际获取,不能假设英文名;不得猜测自定义字段 ID;缺少必需环境变量或项目本地 env 文件时应报错终止;绝不索要凭据,也绝不打印 JIRA_API_TOKEN。