SuperAPI AI 工具集

atlassian-readonly-skills

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:为 Jira、Confluence、Bitbucket 提供只读 Python 工具,用于查询与检索数据,不包含创建、更新、删除等写操作;如需写功能应使用 atlassian-skills。

主要能力:Jira 侧支持按 key 获取问题、JQL 搜索、字段查询、工作流转换查询、敏捷看板/冲刺查询、链接类型、工时记录、项目与版本、用户资料;Confluence 侧支持按标题或 ID 获取页面、CQL 搜索、评论与标签查询;Bitbucket 侧支持项目与仓库列表、拉取请求详情与 diff、文件内容、代码搜索、提交列表与详情。所有函数返回扁平化 JSON 字符串,便于解析。

使用方式:支持两种配置。环境变量模式需设置 JIRA_URL、JIRA_USERNAME、JIRA_API_TOKEN(Cloud)或 JIRA_PAT_TOKEN(Data Center),Confluence 与 Bitbucket 同理;PAT 优先于 API Token。Agent 环境可用 AtlassianCredentials 对象直接传参,并通过 check_available_skills 检查可用服务。示例:jira_get_issue(issue_key="PROJ-123", credentials=credentials)。依赖安装:pip install requests python-dotenv。

适用场景:在智能体或脚本中安全读取 Atlassian 数据,用于检索、汇总与分析,避免误改数据。

限制:不提供写操作、直接 API 访问、Webhook 事件处理及批量导入导出;未完整配置凭据的服务不可用;错误类型包括 ConfigurationError、AuthenticationError、ValidationError、NotFoundError、APIError、NetworkError。