用途
本技能用于对 Jira 项目进行系统化管理(项目管理员操作),涵盖项目的增删改查,以及组件、版本、角色、权限和配置管理。适合在自动化脚本或 AI Agent 中通过 Jira REST API 完成项目级维护工作。
主要能力
- 项目 CRUD:创建、更新、删除(移入回收站,60 天内可恢复)、归档与恢复项目。
- 项目检索:搜索项目(支持排序、关键词、类型、分类、expand 展开字段),以及获取最近访问的项目。
- 组件管理:列出、创建、更新、删除组件,并查询组件的关联问题数量。
- 版本/发布管理:列出、创建、更新、发布、删除版本,查询版本相关问题数量与未解决问题数量。
- 项目角色:获取项目角色列表、角色详情,向角色添加用户或用户组,移除角色成员。
- 项目属性:列出、获取、设置、删除项目属性(properties)。
- 项目校验:校验项目键、获取有效的项目键建议、获取有效的项目名称、获取项目类型。
- 高层辅助:一键完成项目初始化(含组件与初始版本)、克隆项目结构(组件 + 未发布版本)。
使用方式
技能以 TypeScript 接口与函数示例给出实现模式:
- 定义类型:
Project、Component、Version、ProjectRole。 - 项目 CRUD 操作:如
createProject、updateProject、deleteProject、archiveProject、restoreProject。 - 项目列表与搜索:
searchProjects、getRecentProjects。 - 组件管理:
getProjectComponents、createComponent、updateComponent、deleteComponent、getComponentIssueCounts。 - 版本管理:
getProjectVersions、createVersion、updateVersion、releaseVersion、deleteVersion、getVersionIssueCounts、getUnresolvedIssueCount。 - 项目角色:
getProjectRoles、getProjectRole、addUserToRole、addGroupToRole、removeActorFromRole。 - 项目属性:
getProjectProperties、getProjectProperty、setProjectProperty、deleteProjectProperty。 - 项目校验:
validateProjectKey、getValidProjectKey、getValidProjectName、getProjectTypes。 - 高层辅助:
setupProject、cloneProjectStructure。
所有函数通过统一的 JiraClient 发起请求,示例中直接给出 API 路径与请求方法。
前置条件
- 已认证的 JiraClient(参见 jira-auth 技能)。
- 需要 Jira 管理员或项目管理员权限。
- 项目键格式:2-10 个大写字母。
适用场景
- 批量创建或归档 Jira 项目。
- 项目初始化时同时建立组件和首个版本。
- 管理发布版本及其关联问题。
- 配置项目角色与成员(用户或用户组)。
- 在自动化流程中校验项目键、名称的合法性。
限制
资料未提供关于价格、收费、平台支持范围、性能限制或速率限制等信息,暂未提供。删除项目默认移入回收站并 enableUndo=true,资料说明可恢复期为 60 天。