SuperAPI AI 工具集

jira-project-management

办公与效率

查看项目

更新于 10-13 15:23

技能介绍

用途

本技能用于对 Jira 项目进行系统化管理(项目管理员操作),涵盖项目的增删改查,以及组件、版本、角色、权限和配置管理。适合在自动化脚本或 AI Agent 中通过 Jira REST API 完成项目级维护工作。

主要能力

  • 项目 CRUD:创建、更新、删除(移入回收站,60 天内可恢复)、归档与恢复项目。
  • 项目检索:搜索项目(支持排序、关键词、类型、分类、expand 展开字段),以及获取最近访问的项目。
  • 组件管理:列出、创建、更新、删除组件,并查询组件的关联问题数量。
  • 版本/发布管理:列出、创建、更新、发布、删除版本,查询版本相关问题数量与未解决问题数量。
  • 项目角色:获取项目角色列表、角色详情,向角色添加用户或用户组,移除角色成员。
  • 项目属性:列出、获取、设置、删除项目属性(properties)。
  • 项目校验:校验项目键、获取有效的项目键建议、获取有效的项目名称、获取项目类型。
  • 高层辅助:一键完成项目初始化(含组件与初始版本)、克隆项目结构(组件 + 未发布版本)。

使用方式

技能以 TypeScript 接口与函数示例给出实现模式:

  1. 定义类型:Project、Component、Version、ProjectRole。
  2. 项目 CRUD 操作:如 createProject、updateProject、deleteProject、archiveProject、restoreProject。
  3. 项目列表与搜索:searchProjects、getRecentProjects。
  4. 组件管理:getProjectComponents、createComponent、updateComponent、deleteComponent、getComponentIssueCounts。
  5. 版本管理:getProjectVersions、createVersion、updateVersion、releaseVersion、deleteVersion、getVersionIssueCounts、getUnresolvedIssueCount。
  6. 项目角色:getProjectRoles、getProjectRole、addUserToRole、addGroupToRole、removeActorFromRole。
  7. 项目属性:getProjectProperties、getProjectProperty、setProjectProperty、deleteProjectProperty。
  8. 项目校验:validateProjectKey、getValidProjectKey、getValidProjectName、getProjectTypes。
  9. 高层辅助:setupProject、cloneProjectStructure。

所有函数通过统一的 JiraClient 发起请求,示例中直接给出 API 路径与请求方法。

前置条件

  • 已认证的 JiraClient(参见 jira-auth 技能)。
  • 需要 Jira 管理员或项目管理员权限。
  • 项目键格式:2-10 个大写字母。

适用场景

  • 批量创建或归档 Jira 项目。
  • 项目初始化时同时建立组件和首个版本。
  • 管理发布版本及其关联问题。
  • 配置项目角色与成员(用户或用户组)。
  • 在自动化流程中校验项目键、名称的合法性。

限制

资料未提供关于价格、收费、平台支持范围、性能限制或速率限制等信息,暂未提供。删除项目默认移入回收站并 enableUndo=true,资料说明可恢复期为 60 天。