SuperAPI AI 工具集

jira-resource-validator

部署与运维

查看项目

更新于 10-15 19:56

技能介绍

用途:校验 Jira 配置(.env)中的项目与看板是否真实存在,并在缺失时自动创建,确保 Jira 集成可用。

主要能力:检查 JIRA_PROJECT 是否存在,若不存在则提示选择已有项目或新建;逐项校验 JIRA_BOARDS:数值按看板 ID 校验是否存在,非数值按名称创建新看板;支持 ID 与名称混用(如 101,102,QA,Dashboard);创建后用真实 ID 回写 .env;支持按项目分组的多项目/多看板配置(JIRA_STRATEGY=project-per-team、JIRA_PROJECTS、JIRA_BOARDS_项目键);提供清晰的错误提示(认证失败、权限不足、项目键已占用、网络超时等)。

必要用法:在 .env 中设置 JIRA_API_TOKEN、JIRA_EMAIL、JIRA_DOMAIN、JIRA_STRATEGY、JIRA_PROJECT、JIRA_BOARDS;首次配置或运行 /sw-jira:sync 时自动触发,也可手动执行 npx tsx src/utils/external-resource-validator.ts,或通过技能触发“验证我的 Jira 配置”。看板创建依赖先创建 JQL 过滤器,且创建看板时必须带 location 字段关联到项目,否则看板不会挂到项目下。

适用场景:首次搭建 Jira 集成、.env 配置无效、同步前资源缺失、需要批量创建看板并同步 ID 到配置文件。

限制:需具备 Project Creator 和 Board Creator 权限,凭证错误会返回 401,权限不足返回 403;项目键冲突需换键或选择已有项目;网络/API 异常需重试;文档未说明离线使用、具体定价与平台依赖细节,暂未提供。