SuperAPI AI 工具集

connect-ai-jira

数据与分析

查看项目

更新于 10-15 20:11

技能介绍

用途:该技能为通过 CData Connect AI 查询 Jira 数据提供 Jira 专属指引,构建在 connect-ai-base 技能之上,后者负责发现流程、错误恢复、SQL 方言与查询命名约定。使用前必须先定位并阅读 connect-ai-base 技能;若当前环境未加载、未启用或未安装,应立即停止任务,告知用户需先安装并启用该技能。本技能替代 Jira 驱动的 getInstructions,不要调用它,识别 Jira 连接后直接进行模式发现(getTables / getColumns)。

主要能力:Jira 为单模式驱动,模式名为 Jira。核心表包括 Issues(摘要、类型、经办人、报告人、状态、优先级)、Projects、Users、Comments、Worklogs、IssueTransitions、IssueTypes、Attachments。问题分三层级:顶层(如 Epic)、中层(Bug、Story、Task)、底层(Sub-task),用 ParentKey 查找层级关系。支持常见查询模式,如近期创建问题、按开发人员统计问题数、按类型与状态统计、未关闭缺陷、临近到期问题、Epic 下问题、未分配问题、评论活动、按用户统计工时等。支持写入:INSERT 创建问题、UPDATE 更新问题、INSERT 添加评论。存储过程包括 ChangeIssueStatus(需先查 IssueTransitions 获取 TransitionId)、ArchiveIssues / UnarchiveIssues、DownloadAttachment(云端省略 FileLocation 与 FileStream,返回 base64 的 FileData)、CreateCustomField。UploadAttachment 不可作为存储过程调用,需由工具包的文件传输工具处理,若无此类工具则视为不可用。

使用方式:先通过 getCatalogs 识别 Jira 连接,再查 Projects 定位项目,查询 Issues 并探索列,最后用类型、状态、日期等字段过滤。示例:SELECT * FROM [YourConnection].[Jira].[Issues] LIMIT 10。写入被阻止时,可能连接未启用写访问,需引导用户到 Connect AI 连接设置中开启。

限制与约定:Key 用于人类可读引用,Id 用于内部操作与连接;优先用 StatusName 过滤,除非处理转换;ProjectKey 比 ProjectName 更稳定;Updated 字段因自动更新而不稳定,时间分析宜用 Created;TimeSpentSeconds 需除以 3600 得小时;自定义字段需连接启用 IncludeCustomFields = true,用户可能需重启 Claude;枚举选项应查专用表而非 SELECT DISTINCT;可选字段可能为 NULL;大型实例必须加日期过滤以免超时;执行状态转换前先查 IssueTransitions;部分任务需用存储过程而非 SQL,可用 getProcedures 发现。2025 年 Jira UI 将 Issues 更名为 Work Items,但 API 与数据模型仍用 Issues。