mcpField
P
pp-jira

pp-jira

github.com/mvanhorn生产力2.1k77 次安装今天更新
代码仓库

关于 pp-jira

pp-jira 是通过丰富命令集操作 Jira Cloud 的 Printing Press CLI 技能，涵盖问题、项目、配置和管理功能。README 介绍了 Jira API 命令，但未说明 MCP 接口。

主要功能

  1. 01管理 Jira 应用设置
  2. 02批量处理问题
  3. 03创建和更新项目组件
  4. 04获取附件及其元数据

适用场景

  1. 01批量编辑或转换 Jira 问题状态
  2. 02查看 Jira 审计记录
  3. 03配置项目组件
  4. 04检查问题附件内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-jira

安装后在 Claude Code 中输入/pp-jira确认已加载。

详细介绍

Jira Cloud Platform — Printing Press CLI

前提条件：安装 CLI

此技能通过 jira-pp-cli 二进制文件运行。**调用此技能中的任何命令之前，必须确认 CLI 已安装。**如果尚未安装，请先安装：

  1. 通过 Printing Press 安装程序安装。默认情况下，二进制文件安装在 macOS/Linux 的 $HOME/.local/bin 和 Windows 的 %LOCALAPPDATA%\Programs\PrintingPress\bin： 
    npx -y @mvanhorn/printing-press-library install jira --cli-only
  2. 验证：jira-pp-cli --version
  3. 确保报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接通过 Go 安装（需要 Go 1.26.6 或更高版本）：

go install github.com/mvanhorn/printing-press-library/library/project-management/jira/cmd/jira-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。验证成功前，请勿执行技能命令。

命令参考

announcement-banner — 此资源表示公告横幅。用于获取和更新横幅配置。

  • jira-pp-cli announcement-banner get-banner — 返回当前公告横幅配置。所需权限： Administer Jira...
  • jira-pp-cli announcement-banner set-banner — 更新公告横幅配置。所需权限： Administer Jira [全局...

app — 管理应用

  • jira-pp-cli app get-custom-field-configuration — 返回自定义字段配置的分页列表...
  • jira-pp-cli app get-custom-fields-configurations — 返回自定义字段列表配置的分页列表...
  • jira-pp-cli app update-custom-field-configuration — 更新自定义字段类型[上下文](https://developer.atlassian.com/platform/forge/ma...的配置
  • jira-pp-cli app update-custom-field-value — 更新一个或多个问题上自定义字段的值。应用只能对[自定义...执行此操作
  • jira-pp-cli app update-multiple-custom-field-values — 更新一个或多个问题上一个或多个自定义字段的值。自定义字段与问题的组合应...

application-properties — 管理应用属性

  • jira-pp-cli application-properties get-advanced-settings — 返回可在 Advanced Settings 页面访问的应用属性。要导航到 *Advanced...
  • jira-pp-cli application-properties get-application-property — 返回所有应用属性或某个应用属性。如果为 key 参数指定值，则...
  • jira-pp-cli application-properties set-application-property — 更改应用属性的值。例如，可以将 jira.clone.prefix 的值从...

applicationrole — 管理应用角色

  • jira-pp-cli applicationrole get-all-application-roles — 返回所有应用角色。在 Jira 中，应用角色通过[应用访问权限...
  • jira-pp-cli applicationrole get-application-role — 返回一个应用角色。所需权限： Administer Jira [全局...

atlassian-connect — 管理 Atlassian Connect

  • jira-pp-cli atlassian-connect addon-properties-resource-delete-addon-property-delete — 删除应用的属性。所需权限： 仅密钥与 addonKey 匹配的 Connect 应用……
  • jira-pp-cli atlassian-connect addon-properties-resource-get-addon-properties-get — 获取应用的所有属性。保留键 connect_client_key_019cdff3-8bfb-71fe-9628-875b700aebb8 不……
  • jira-pp-cli atlassian-connect addon-properties-resource-get-addon-property-get — 返回应用属性的键和值。属性键……
  • jira-pp-cli atlassian-connect addon-properties-resource-put-addon-property-put — 设置应用属性的值。使用此资源存储应用的自定义数据。请求的值……
  • jira-pp-cli atlassian-connect app-issue-field-value-update-resource-update-issue-fields-put — 更新一个或多个问题上由 Connect 应用添加的自定义字段的值。最多可更新 200 个自定义……
  • jira-pp-cli atlassian-connect connect-to-forge-migration-fetch-task-resource-fetch-migration-task-get — 返回 Connect 问题字段迁移到 Forge 的详细信息。将 Connect 应用迁移到 Forge 时，[问题……
  • jira-pp-cli atlassian-connect connect-to-forge-migration-task-submission-resource-submit-task-post — 提交请求，触发将 Connect 问题字段迁移到对应的 Forge 自定义字段。迁移时……
  • jira-pp-cli atlassian-connect dynamic-modules-resource-get-modules-get — 返回调用应用动态注册的所有模块。所需权限： 仅……
  • jira-pp-cli atlassian-connect dynamic-modules-resource-register-modules-post — 注册模块列表。所需权限： 只有 Connect 应用可以发出此请求。
  • jira-pp-cli atlassian-connect dynamic-modules-resource-remove-modules-delete — 移除调用应用注册的所有模块或指定模块列表。所需权限： 仅……
  • jira-pp-cli atlassian-connect migration-resource-update-entity-properties-value-put — 更新对象的多个实体属性值，每个请求最多更新 50 项。此操作用于……
  • jira-pp-cli atlassian-connect migration-resource-workflow-rule-search-post — 返回从 Server 迁移到 Cloud 且由调用 Connect 应用拥有的工作流转换规则配置。
  • jira-pp-cli atlassian-connect service-registry-resource-services-get — 获取指定服务注册表的属性。所需权限： 只有 Connect 应用可以……

附件 — 管理附件

  • jira-pp-cli attachment get — 返回附件的元数据。请注意，不会返回附件本身。此操作可以……
  • jira-pp-cli attachment get-content — 返回附件的内容。可以设置 Range 标头，以定义附件中的字节范围……
  • jira-pp-cli attachment get-meta — 返回附件设置，即是否已启用附件以及允许的最大附件大小……
  • jira-pp-cli attachment get-thumbnail — 返回附件的缩略图。如需返回附件内容，请使用[获取附件……
  • jira-pp-cli attachment remove — 从问题中删除附件。此操作可匿名访问。**所需权限……

审计 — 管理审计

  • jira-pp-cli auditing — 返回审计记录列表。可以筛选列表以包含以下项目：* filter 中的每一项都至少有……

头像 — 此资源表示系统头像和自定义头像。使用它可获取系统头像或自定义头像的详细信息、在项目、问题类型或优先级中添加和移除头像，以及获取头像图像。

批量 — 管理批量操作

  • jira-pp-cli bulk get-available-transitions — 使用此 API 获取指定问题可用的转换列表，这些转换可用于批量……
  • jira-pp-cli bulk get-editable-fields — 使用此 API 获取用户可见的字段列表，以执行批量编辑操作。您可以传入单个或……
  • jira-pp-cli bulk get-operation-progress — 使用此 API 获取指定批量操作 taskId 的进度状态。**权限……
  • jira-pp-cli bulk submit-delete — 使用此 API 提交批量删除请求。单次操作最多可删除 1,000 个问题……
  • jira-pp-cli bulk submit-edit — 使用此 API 提交批量编辑请求，并同时编辑多个问题。此操作有相关限制……
  • jira-pp-cli bulk submit-move — 使用此 API 提交批量移动问题请求。单次操作可以将多个问题从多个项目中移出……
  • jira-pp-cli bulk submit-transition — 使用此 API 提交批量转换问题状态的请求。您可以转换多个问题，同时……
  • jira-pp-cli bulk submit-unwatch — 使用此 API 提交批量取消关注请求。单次操作最多可取消关注 1,000 个问题……
  • jira-pp-cli bulk submit-watch — 使用此 API 提交批量关注请求。单次操作最多可关注 1,000 个问题……

changelog — 管理变更日志

  • jira-pp-cli changelog — 批量获取多个问题的变更日志并按字段筛选。返回给定问题的所有变更日志的分页列表……

classification-levels — 此资源表示分类级别。

  • jira-pp-cli classification-levels — 返回所有分类级别。所需权限： 无。

comment — 管理评论

  • jira-pp-cli comment — 返回由评论 ID 列表指定的评论分页列表。此操作可以……

component — 管理组件

  • jira-pp-cli component create — 创建组件。使用组件为项目中的问题提供容器。使用组件提供……
  • jira-pp-cli component delete — 删除组件。此操作可匿名访问。所需权限：……
  • jira-pp-cli component find-for-projects — 返回项目中所有组件的分页列表，包括……
  • jira-pp-cli component get — 返回组件。此操作可匿名访问。所需权限： *浏览……
  • jira-pp-cli component update — 更新组件。请求中包含的所有字段都会被覆盖。如果 leadAccountId 是空字符串（''）……

config — 管理配置

  • jira-pp-cli config associate-projects-to-field-association-schemes — 将项目关联到字段关联方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli config clone-field-association-scheme — 用于将现有字段关联方案克隆为新方案的端点。所需权限：...
  • jira-pp-cli config create-field-association-scheme — 用于创建新字段关联方案的端点。所需权限： 管理 Jira...
  • jira-pp-cli config delete-field-association-scheme — 删除指定的字段关联方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli config get-field-association-scheme-by-id — 用于按 ID 获取字段关联方案的端点。所需权限： *管理...
  • jira-pp-cli config get-field-association-scheme-item-parameters — 获取字段关联方案上的字段关联参数。所需权限：...
  • jira-pp-cli config get-field-association-schemes — 用于获取字段关联方案分页列表的 REST 端点，支持可选筛选。此端点...
  • jira-pp-cli config get-projects-with-field-schemes — 获取使用字段关联方案的项目。这将是一个临时 API，但在从...过渡时很有用
  • jira-pp-cli config remove-field-association-scheme-item-parameters — 移除工作类型的字段关联参数覆盖项。所需权限： *管理...
  • jira-pp-cli config remove-fields-associated-with-schemes — 移除与字段关联方案关联的字段。所需权限： 管理 Jira...
  • jira-pp-cli config search-field-association-scheme-fields — 搜索属于指定字段关联方案的字段。所需权限：...
  • jira-pp-cli config search-field-association-scheme-projects — 用于搜索属于指定字段关联方案的项目的 REST 端点。**所需权限...
  • jira-pp-cli config update-field-association-scheme — 用于更新现有字段关联方案的端点。所需权限： *管理...
  • jira-pp-cli config update-field-association-scheme-item-parameters — 更新字段关联方案中的字段关联项参数。所需权限：...
  • jira-pp-cli config update-fields-associated-with-schemes — 更新与字段关联方案关联的字段。所需权限： 管理 Jira...

configuration — 管理配置

  • jira-pp-cli configuration get — 返回 Jira 中的全局设置。这些设置决定是否...
  • jira-pp-cli configuration get-available-time-tracking-implementations — 返回所有时间跟踪提供程序。默认情况下，Jira 只有一个时间跟踪提供程序：*JIRA 提供的时间...
  • jira-pp-cli configuration get-selected-time-tracking-implementation — 返回当前选定的时间跟踪提供程序。请注意，如果时间跟踪已禁用，则...
  • jira-pp-cli configuration get-shared-time-tracking — 返回时间跟踪设置。包括时间格式、默认时间单位等设置...
  • jira-pp-cli configuration select-time-tracking-implementation — 选择时间跟踪提供程序。所需权限： 管理 Jira [全局...
  • jira-pp-cli configuration set-shared-time-tracking — 设置时间跟踪设置。所需权限： 管理 Jira [全局...

custom-field-option — 管理自定义字段选项

  • jira-pp-cli custom-field-option <id> — 返回自定义字段选项。例如，下拉列表中的选项。请注意，此操作**仅适用于... dashboard — 此资源表示仪表板。可使用它获取仪表板详情，以及获取、创建、更新或移除仪表板中的项目属性和小工具。

  • jira-pp-cli dashboard bulk-edit — 批量编辑仪表板。每次最多可编辑 100 个仪表板……

  • jira-pp-cli dashboard create — 创建仪表板。所需权限： 无。

  • jira-pp-cli dashboard delete — 删除仪表板。所需权限： 无。要删除的仪表板必须由……

  • jira-pp-cli dashboard get — 返回仪表板。此操作可匿名访问。所需权限： 无……

  • jira-pp-cli dashboard get-all — 返回用户拥有或与用户共享的仪表板列表。可筛选列表，仅包含收藏的或……

  • jira-pp-cli dashboard get-all-available-gadgets — 获取可添加到所有仪表板的全部可用小工具列表。所需权限：……

  • jira-pp-cli dashboard get-paginated — 返回分页的仪表板列表。此操作类似于[获取……

  • jira-pp-cli dashboard update — 更新仪表板，并将其所有详情替换为提供的内容。所需权限：……

data-policy — 管理数据策略

  • jira-pp-cli data-policy get-policies — 返回请求中指定项目的数据策略。
  • jira-pp-cli data-policy get-policy — 返回工作区的数据策略。

events — 管理事件

  • jira-pp-cli events — 返回所有问题事件。所需权限： 管理 Jira [全局……

expression — 管理表达式

  • jira-pp-cli expression analyse — 分析并验证 Jira 表达式。作为一项实验性功能，此操作还可以尝试进行类型检查……
  • jira-pp-cli expression evaluate-jira — 此端点目前正在移除。了解详情……
  • jira-pp-cli expression evaluate-jsisjira — 计算 Jira 表达式并返回其值。与 eval 的区别在于，此端点使用……

field — 管理字段

  • jira-pp-cli field create-associations — 将字段与项目关联。字段将与所请求项目中的每种问题类型关联。字段……
  • jira-pp-cli field create-custom — 创建自定义字段。所需权限： 管理 Jira [全局……
  • jira-pp-cli field delete-custom — 删除自定义字段。无论自定义字段是否在回收站中，都会将其删除。请参阅[编辑或删除自定义……
  • jira-pp-cli field get — 根据以下规则返回系统字段和自定义问题字段：* 无法添加到问题中的字段……
  • jira-pp-cli field get-paginated — 返回 Classic Jira 项目的字段分页列表。列表可包含：* 所有字段 *……
  • jira-pp-cli field get-trashed-paginated — 返回回收站中字段的分页列表。列表可限制为字段……
  • jira-pp-cli field remove-associations — 取消一组字段与项目及问题类型上下文的关联。字段将与所有……
  • jira-pp-cli field update-custom — 更新自定义字段。所需权限： 管理 Jira [全局……

fieldconfiguration — 管理字段配置

fieldconfigurationscheme — 管理 fieldconfigurationscheme

filter — 此资源表示筛选器。可使用它获取、创建、更新或删除筛选器，也可配置筛选器的列并设置收藏筛选器。

  • jira-pp-cli filter create — 创建筛选器。筛选器将根据默认共享范围进行共享。...
  • jira-pp-cli filter delete — 删除筛选器。所需权限： 需要有权访问 Jira，但筛选器只能...
  • jira-pp-cli filter get — 返回筛选器。此操作可匿名访问。所需权限： 无，...
  • jira-pp-cli filter get-default-share-scope — 返回用户新建筛选器和仪表板的默认共享设置。**所需权限...
  • jira-pp-cli filter get-favourite — 返回用户可见的收藏筛选器。此操作可匿名访问。...
  • jira-pp-cli filter get-my — 返回用户拥有的筛选器。如果 includeFavourites 为 true，则还会返回用户可见的收藏筛选器...
  • jira-pp-cli filter get-paginated — 返回筛选器的分页列表。使用此操作可获取：* 通过定义 id 指定的筛选器...
  • jira-pp-cli filter set-default-share-scope — 设置用户新建筛选器和仪表板的默认共享范围。所需权限：...
  • jira-pp-cli filter update — 更新筛选器。使用此操作可更新筛选器的名称、描述、JQL 或共享设置。...

forge — 管理 forge

  • jira-pp-cli forge bulk-pin-unpin-projects-async — 将由 Forge 应用添加的问题面板批量固定到多个项目，或从多个项目取消固定。此操作将运行...
  • jira-pp-cli forge delete-app-property — 删除 Forge 应用的属性。所需权限： 仅 Forge 应用可以发起此请求……
  • jira-pp-cli forge get-app-property — 返回 Forge 应用属性的值。所需权限： 仅 Forge 应用可以发起此请求……
  • jira-pp-cli forge get-app-property-keys — 返回 Forge 应用的所有属性键。所需权限： 仅 Forge 应用可以发起此请求……
  • jira-pp-cli forge put-app-property — 设置 Forge 应用属性的值。这些值可以通过 [Jira...

group — 此资源表示用户组。使用它可以获取、创建、查找和删除用户组，以及向用户组添加和移除用户。（[WARNING] Atlassian 标准用户组名称只是默认名称，可以编辑或删除。例如，管理员或 Atlassian 支持人员可以随时删除默认用户组 jira-software-users，或将其重命名为 jsw-users。详情请参阅 https://support.atlassian.com/user-management/docs/create-and-update-groups/。）

  • jira-pp-cli group add-user-to — 将用户添加到用户组。所需权限： 站点管理（即，属于...
  • jira-pp-cli group bulk-get — 返回用户组的分页列表。所需权限： *浏览用户和...
  • jira-pp-cli group create — 创建用户组。所需权限： 站点管理（即，属于 site-admin...
  • jira-pp-cli group get — 此操作已弃用，请改用 group/member。返回用户组中的所有用户……
  • jira-pp-cli group get-users-from — 返回用户组中所有用户的分页列表。请注意，用户按用户名排序，但是...
  • jira-pp-cli group remove — 删除用户组。所需权限： 站点管理（即，属于 site-admin...
  • jira-pp-cli group remove-user-from — 从用户组中移除用户。所需权限： 站点管理（即，属于...

groups — 此资源表示用户组。使用它可以获取、创建、查找和删除用户组，以及向用户组添加和移除用户。（[WARNING] Atlassian 标准用户组名称只是默认名称，可以编辑或删除。例如，管理员或 Atlassian 支持人员可以随时删除默认用户组 jira-software-users，或将其重命名为 jsw-users。详情请参阅 https://support.atlassian.com/user-management/docs/create-and-update-groups/。）

  • jira-pp-cli groups — 返回名称包含查询字符串的用户组列表。可以提供要排除的用户组名称列表...

groupuserpicker — 管理 groupuserpicker

  • jira-pp-cli groupuserpicker — 返回与某个字符串匹配的用户和用户组列表。此字符串用于：* 对于用户，查找不区分大小写的...

instance — 管理实例

  • jira-pp-cli instance — 返回有关 Jira 实例的许可信息。所需权限： 无。

internal — 管理 internal

  • jira-pp-cli internal — 返回一组问题 ID 和工时记录 ID 对的工时记录详情。这是一个用于批量获取...的内部 API。

issue — 此资源表示 Jira 问题。使用它可以：

  • 单独或批量创建或编辑问题。
  • 获取有关创建或编辑问题选项的元数据。
  • 删除问题。
  • 将用户分配给问题。
  • 获取问题变更日志。
  • 发送有关问题的通知。
  • 获取问题可用转换的详情。
  • 转换问题。
  • 归档问题。
  • 取消归档问题。
  • 导出已归档的问题。
  • jira-pp-cli issue archive — 管理员可在单个请求中使用问题 ID/键归档最多 1000 个问题，并返回相关详情……
  • jira-pp-cli issue archive-async — 管理员可在单个请求中使用 JQL 归档最多 100,000 个问题，并返回用于检查状态的 URL……
  • jira-pp-cli issue bulk-delete-property — 从多个问题中删除属性值。可通过筛选条件指定要更新的问题……
  • jira-pp-cli issue bulk-fetch — 返回一组指定问题的详情。最多可请求 100 个问题。每个问题通过其……标识
  • jira-pp-cli issue bulk-set-properties-by — 在问题上设置或更新实体属性值。每个问题最多可指定 10 个实体属性，并且……
  • jira-pp-cli issue bulk-set-properties-list — 在问题上设置或更新实体属性值列表。最多可指定包含 10 个实体属性的列表……
  • jira-pp-cli issue bulk-set-property — 在多个问题上设置属性值。设置的值可以是常量，也可以由 [Jira……
  • jira-pp-cli issue create — 创建问题；如果 Jira 中启用了创建子任务的选项，也可以创建子任务。可以应用转换……
  • jira-pp-cli issue create-bulk — 创建最多 50 个问题；如果 Jira 中启用了创建子任务的选项，也可以创建子任务。可以应用转换……
  • jira-pp-cli issue delete — 删除问题。如果问题有一个或多个子任务，则无法删除。若要删除含子任务的问题，请设置……
  • jira-pp-cli issue edit — 编辑问题。编辑时可以更新问题属性。请注意，问题转换不会……
  • jira-pp-cli issue get — 返回问题详情。问题通过其 ID 或键标识；但如果该标识符与……不匹配
  • jira-pp-cli issue get-create-meta — 返回项目、项目中的问题类型的详情；如果请求，还会返回每种类型的创建屏幕字段……
  • jira-pp-cli issue get-create-meta-type-id — 返回指定项目和问题类型 ID 的一页字段元数据。使用这些信息填写……
  • jira-pp-cli issue get-create-meta-types — 返回指定项目的一页问题类型元数据。使用这些信息填写 [……中的请求
  • jira-pp-cli issue get-is-watching-bulk — 返回指定用户对列表中问题的关注状态详情。如果问题 ID 无效，返回的……
  • jira-pp-cli issue get-limit-report — 返回所有超出或接近每个问题限制的问题。[所需权限：](#permissions) * *浏览……
  • jira-pp-cli issue get-picker-resource — 返回与查询字符串匹配的问题列表。使用此资源可在……时提供自动补全建议
  • jira-pp-cli issue unarchive — 管理员可在单个请求中使用问题 ID/键取消归档最多 1000 个问题，并返回相关详情……

issue-link — 此资源表示问题之间的链接。使用它可获取、创建和删除问题之间的链接。

要使用此资源，站点必须启用问题链接。

  • jira-pp-cli issue-link delete — 删除问题链接。此操作可匿名访问。[所需权限：](#permissions) *……
  • jira-pp-cli issue-link get — 返回问题链接。此操作可匿名访问。[所需权限：](#permissions) *……
  • jira-pp-cli issue-link link-issues — 在两个问题之间创建链接。使用此操作可指明两个问题之间的关系，并可选择……

issue-link-type — 此资源表示问题链接类型。使用它可获取、创建、更新和删除问题链接类型，也可获取所有问题链接类型的列表。

要使用此资源，站点必须启用问题链接。

  • jira-pp-cli issue-link-type create — 创建问题链接类型。使用此操作可创建问题之间建立链接的原因描述。该...
  • jira-pp-cli issue-link-type delete — 删除问题链接类型。使用此操作，站点必须启用[问题...
  • jira-pp-cli issue-link-type get — 返回所有问题链接类型的列表。使用此操作，站点必须启用[问题...
  • jira-pp-cli issue-link-type get-issuelinktype — 返回问题链接类型。使用此操作，站点必须启用[问题...
  • jira-pp-cli issue-link-type update — 更新问题链接类型。使用此操作，站点必须启用[问题...

issues — 此资源表示 Jira 问题。使用它可以：

  • 单独或批量创建、编辑问题。
  • 获取有关创建或编辑问题选项的元数据。
  • 删除问题。
  • 为问题分配用户。
  • 获取问题更改日志。
  • 发送有关问题的通知。
  • 获取问题可用转换的详细信息。
  • 转换问题。
  • 归档问题。
  • 取消归档问题。
  • 导出已归档的问题。
  • jira-pp-cli issues — 允许管理员获取所有已归档问题的详细信息。请求成功后，提交请求的管理员将...

issuesecurityschemes — 管理 issuesecurityschemes

  • jira-pp-cli issuesecurityschemes associate-schemes-to-projects — 将问题安全方案与项目关联，并在必要时将问题的安全级别重新映射到新级别...
  • jira-pp-cli issuesecurityschemes create-issue-security-scheme — 创建包含安全方案级别及其成员的安全方案。最多可创建 100 个安全方案...
  • jira-pp-cli issuesecurityschemes delete-security-scheme — 删除问题安全方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli issuesecurityschemes get-issue-security-scheme — 返回问题安全方案及其安全级别。所需权限： *...
  • jira-pp-cli issuesecurityschemes get-issue-security-schemes — 返回所有问题安全方案。**所需权限...
  • jira-pp-cli issuesecurityschemes get-security-level-members — 返回问题安全级别成员的分页列表。仅包含...
  • jira-pp-cli issuesecurityschemes get-security-levels — 返回问题安全级别的分页列表。仅包含...
  • jira-pp-cli issuesecurityschemes search-projects-using-security-schemes — 返回使用安全方案的项目的分页映射。你可以提供一个...
  • jira-pp-cli issuesecurityschemes search-security-schemes — 返回问题安全方案的分页列表。如果指定项目 ID 参数，则...
  • jira-pp-cli issuesecurityschemes set-default-levels — 为方案设置默认问题安全级别。所需权限： 管理 Jira [全局...
  • jira-pp-cli issuesecurityschemes update-issue-security-scheme — 更新问题安全方案。所需权限： 管理 Jira [全局...

issuetype — 管理 issuetype

  • jira-pp-cli issuetype create-issue-type — 创建问题类型。所需权限： 管理 Jira [全局...
  • jira-pp-cli issuetype delete-issue-type — 删除问题类型。如果问题类型正在使用，则所有相关使用都会更新为替代问题类型...
  • jira-pp-cli issuetype get-issue-all-types — 返回所有问题类型。此操作可匿名访问。所需权限： 问题...
  • jira-pp-cli issuetype get-issue-type — 返回问题类型。此操作可匿名访问。所需权限： *浏览...
  • jira-pp-cli issuetype get-issue-types-for-project — 返回项目的问题类型。此操作可匿名访问。**所需权限...
  • jira-pp-cli issuetype update-issue-type — 更新问题类型。所需权限： 管理 Jira [全局...

issuetypescheme — 管理问题类型方案

  • jira-pp-cli issuetypescheme assign-issue-type-scheme-to-project — 将问题类型方案分配给项目。如果项目中的任何问题所分配的问题类型不在...
  • jira-pp-cli issuetypescheme create-issue-type-scheme — 创建问题类型方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli issuetypescheme delete-issue-type-scheme — 删除问题类型方案。只能删除经典项目使用的问题类型方案。仅问题类型...
  • jira-pp-cli issuetypescheme get-all-issue-type-schemes — 返回问题类型方案的分页列表。仅经典项目中使用的问题类型方案...
  • jira-pp-cli issuetypescheme get-issue-type-scheme-for-projects — 返回问题类型方案的分页列表，并为每个问题类型方案列出...
  • jira-pp-cli issuetypescheme get-issue-type-schemes-mapping — 返回问题类型方案条目的分页列表。仅经典项目中使用的问题类型方案条目...
  • jira-pp-cli issuetypescheme update-issue-type-scheme — 更新问题类型方案。所需权限： 管理 Jira [全局...

issuetypescreenscheme — 管理问题类型屏幕方案

  • jira-pp-cli issuetypescreenscheme assign-issue-type-screen-scheme-to-project — 将问题类型屏幕方案分配给项目。问题类型屏幕方案只能分配给经典...
  • jira-pp-cli issuetypescreenscheme create-issue-type-screen-scheme — 创建问题类型屏幕方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli issuetypescreenscheme delete-issue-type-screen-scheme — 删除问题类型屏幕方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli issuetypescreenscheme get-issue-type-screen-scheme-mappings — 返回问题类型屏幕方案条目的分页列表。仅经典项目中使用的问题类型屏幕方案...
  • jira-pp-cli issuetypescreenscheme get-issue-type-screen-scheme-project-associations — 返回问题类型屏幕方案的分页列表，并为每个问题类型屏幕方案列出...
  • jira-pp-cli issuetypescreenscheme get-issue-type-screen-schemes — 返回问题类型屏幕方案的分页列表。仅经典项目中使用的问题类型屏幕方案...
  • jira-pp-cli issuetypescreenscheme update-issue-type-screen-scheme — 更新问题类型屏幕方案。所需权限： 管理 Jira [全局...

jira-search — 管理 Jira 云平台搜索

  • jira-pp-cli jira-search and-reconsile-issues-using-jql — 使用 JQL 搜索问题。近期更新可能不会立即……
  • jira-pp-cli jira-search and-reconsile-issues-using-jql-post — 使用 JQL 搜索问题。近期更新可能不会立即……
  • jira-pp-cli jira-search count-issues — 提供与 JQL 匹配的问题数量估算。近期……
  • jira-pp-cli jira-search for-issues-using-jql — 此端点目前正在移除。更多详情 搜索……
  • jira-pp-cli jira-search for-issues-using-jql-post — 此端点目前正在移除。更多详情 搜索……

jira-version — 管理 jira cloud platform 版本

  • jira-pp-cli jira-version create — 创建项目版本。此操作可匿名访问。所需权限：……
  • jira-pp-cli jira-version delete — 删除项目版本。已弃用，请改用[删除并替换……
  • jira-pp-cli jira-version get — 返回项目版本。此操作可匿名访问。所需权限：……
  • jira-pp-cli jira-version update — 更新项目版本。此操作可匿名访问。所需权限：……

jira-workflow — 管理 jira cloud platform 工作流

  • jira-pp-cli jira-workflow create-transition-property — 此功能将于 2026 年 6 月 1 日移除；……
  • jira-pp-cli jira-workflow delete-inactive — 删除工作流。如果工作流属于以下情况，则无法删除：* 活动工作流。* 系统工作流。* 已关联……
  • jira-pp-cli jira-workflow delete-transition-property — 此功能将于 2026 年 6 月 1 日移除；……
  • jira-pp-cli jira-workflow delete-transition-rule-configurations — 从一个或多个工作流中删除工作流转换规则。支持以下规则类型：* [后置……
  • jira-pp-cli jira-workflow get-paginated — 此功能将于 2026 年 6 月 1 日移除；……
  • jira-pp-cli jira-workflow get-transition-properties — 此功能将于 2026 年 6 月 1 日移除；……
  • jira-pp-cli jira-workflow get-transition-rule-configurations — 返回包含转换规则的分页工作流列表。可筛选工作流以返回……
  • jira-pp-cli jira-workflow list-history — 返回指定工作流 ID 的工作流历史记录列表。**注意：**存储的工作流数据会在……后过期
  • jira-pp-cli jira-workflow read-from-history — 返回指定工作流 ID 和版本号对应的工作流及相关状态。**注意：**存储的工作流……
  • jira-pp-cli jira-workflow update-transition-property — 此功能将于 2026 年 6 月 1 日移除；……
  • jira-pp-cli jira-workflow update-transition-rule-configurations — 更新工作流转换规则的配置。支持以下规则类型：* [后置……

jql — 此资源表示 JQL 搜索自动补全详情。可使用它获取 JQL 搜索自动补全数据和建议，用于以编程方式构建查询或自定义查询构建器。它还提供以下操作：

  • 将一个或多个包含用户标识符（用户名或用户键）的 JQL 查询转换为包含相应账户 ID 的 JQL 查询。
  • 如果用户无权查看某实体的可读详情，则将一个或多个 JQL 查询中的可读详情转换为 ID。
  • jira-pp-cli jql get-auto-complete — 返回 JQL 搜索的参考数据。这是 [Advanced... 中所提供文档的可下载版本。
  • jira-pp-cli jql get-auto-complete-post — 返回 JQL 搜索的参考数据。这是 [Advanced... 中所提供文档的可下载版本。
  • jira-pp-cli jql get-field-auto-complete-for-query-string — 返回字段的 JQL 搜索自动补全建议。提供以下信息即可获取建议：*...
  • jira-pp-cli jql get-precomputations — 返回函数预计算列表，以及其创建、更新和...时间的信息。
  • jira-pp-cli jql get-precomputations-by-id — 按 ID 返回函数预计算，以及其创建、更新和上次...的信息。
  • jira-pp-cli jql match-issues — 检查一个或多个问题是否会被一个或多个 JQL 查询返回。**权限...
  • jira-pp-cli jql migrate-queries — 将一个或多个包含用户标识符（用户名或用户密钥）的 JQL 查询转换为包含账户...的等效 JQL 查询。
  • jira-pp-cli jql parse-queries — 解析并验证 JQL 查询。验证会在当前用户的上下文中执行。此操作可以...
  • jira-pp-cli jql sanitise-queries — 通过将易读详情转换为 ID，对一个或多个 JQL 查询进行清理，以适用于用户无权...的情况。
  • jira-pp-cli jql update-precomputations — 更新 Forge/Connect 应用创建的函数预计算值。**权限...

label — 此资源表示可用标签。使用它可获取全局标签字段的可用标签。

  • jira-pp-cli label — 返回标签的分页列表。

license — 管理许可证

  • jira-pp-cli license get-approximate-application-count — 返回单个 Jira 许可证的用户账户近似总数。请注意，此信息...
  • jira-pp-cli license get-approximate-count — 返回所有 Jira 许可证中的用户账户近似总数。请注意，此信息会缓存...

mypermissions — 管理 mypermissions

  • jira-pp-cli mypermissions — 返回权限列表，指出用户拥有哪些权限。用户权限的详情可...

mypreferences — 管理 mypreferences

  • jira-pp-cli mypreferences get-locale — 返回用户的区域设置。如果用户未设置语言偏好（这是默认设置），或者此...
  • jira-pp-cli mypreferences get-preference — 返回当前用户某项偏好的值。请注意，这些键已弃用：* jira.user.locale ...
  • jira-pp-cli mypreferences remove-preference — 删除用户的一项偏好设置，以恢复系统定义设置的默认值。请注意，这些键...
  • jira-pp-cli mypreferences set-locale — 已弃用，请使用 [ 更新用户个人资料](https://developer.atlassian.com/cloud/admin/user-management/rest/#api-users-...
  • jira-pp-cli mypreferences set-preference — 为用户创建偏好设置，或通过发送纯文本字符串更新偏好设置的值。例如，...

myself — 此资源表示有关当前用户的信息，例如基本详情、群组成员身份、应用角色、偏好设置和区域设置。使用它可获取、创建、更新和删除（恢复默认值）用户的偏好设置和区域设置。

  • jira-pp-cli myself — 返回当前用户的详情。**所需权限：**访问 Jira 的权限。

notificationscheme — 管理 notificationscheme

  • jira-pp-cli notificationscheme create-notification-scheme — 创建包含通知的通知方案。每个请求最多可创建 1000 条通知....
  • jira-pp-cli notificationscheme delete-notification-scheme — 删除通知方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli notificationscheme get-notification-scheme — 返回一个通知方案，包括事件列表和...
  • jira-pp-cli notificationscheme get-notification-scheme-to-project-mappings — 返回已分配通知方案的项目的分页映射。你可以提供...
  • jira-pp-cli notificationscheme get-notification-schemes — 返回按...排序的通知方案分页列表
  • jira-pp-cli notificationscheme update-notification-scheme — 更新通知方案。所需权限： 管理 Jira [全局...

权限 — 此资源表示权限。使用它可获取所有权限的详细信息，并确定用户是否拥有某些权限。

  • jira-pp-cli permissions get-all — 返回所有权限，包括：* 全局权限。* 项目权限。* 添加的全局权限...
  • jira-pp-cli permissions get-bulk — 返回：* 对于一组全局权限，授予用户的全局权限。* 对于一组项目...
  • jira-pp-cli permissions get-permitted-projects — 返回用户获授一组项目权限的所有项目。可以访问此操作...

权限方案 — 管理权限方案

  • jira-pp-cli permissionscheme create-permission-scheme — 创建新的权限方案。你可以创建权限方案，并选择是否定义一组权限...
  • jira-pp-cli permissionscheme delete-permission-scheme — 删除权限方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli permissionscheme get-all-permission-schemes — 返回所有权限方案。### 关于权限方案和授权 ### 权限方案是一组...
  • jira-pp-cli permissionscheme get-permission-scheme — 返回权限方案。所需权限： 访问 Jira 的权限。
  • jira-pp-cli permissionscheme update-permission-scheme — 更新权限方案。使用此资源时，请注意以下重要事项：* 如果权限...

计划 — 此资源表示计划。使用它可获取、创建、复制、更新、移至回收站和归档计划。

  • jira-pp-cli plans add-atlassian-team — 将现有 Atlassian 团队添加到计划中，并配置其规划设置。**权限...
  • jira-pp-cli plans archive — 归档计划。所需权限： 管理 Jira [全局...
  • jira-pp-cli plans create — 创建计划。所需权限： 管理 Jira [全局...
  • jira-pp-cli plans create-only-team — 创建仅限计划的团队，并配置其规划设置。所需权限：...
  • jira-pp-cli plans delete-only-team — 删除仅限计划的团队及其规划设置。所需权限： 管理 Jira...
  • jira-pp-cli plans duplicate — 复制计划。所需权限： 管理 Jira [全局...
  • jira-pp-cli plans get — 返回计划的分页列表。所需权限： 管理 Jira...
  • jira-pp-cli plans get-atlassian-team — 返回计划中 Atlassian 团队的规划设置。所需权限： *管理...
  • jira-pp-cli plans get-only-team — 返回仅限计划团队的规划设置。所需权限： 管理 Jira [全局...
  • jira-pp-cli plans get-plan — 返回计划。所需权限： 管理 Jira [全局...
  • jira-pp-cli plans get-teams — 返回计划中仅限计划团队和 Atlassian 团队的分页列表。**所需权限...
  • jira-pp-cli plans remove-atlassian-team — 从计划中移除 Atlassian 团队并删除其规划设置。所需权限：...
  • jira-pp-cli plans trash — 将计划移至回收站。所需权限： 管理 Jira [全局...
  • jira-pp-cli plans update — 使用 JSON Patch 更新计划的以下任意详细信息。*...
  • jira-pp-cli plans update-atlassian-team — 使用 [JSON...
  • jira-pp-cli plans update-only-team — 使用 [JSON...

优先级 — 管理优先级

  • jira-pp-cli priority create — 创建问题优先级。请求正文中的 iconUrl 参数将弃用，并于 3 月 16 日...
  • jira-pp-cli priority delete — 删除问题优先级。此操作为异步操作。请按照响应中的 location 链接...
  • jira-pp-cli priority get — 返回问题优先级。所需权限： 有权访问 Jira。
  • jira-pp-cli priority get-priorities — 返回所有问题优先级的列表。所需权限： 有权访问 Jira。
  • jira-pp-cli priority move-priorities — 更改问题优先级的顺序。所需权限： 管理 Jira [全局...
  • jira-pp-cli priority search-priorities — 返回优先级的分页列表。该列表可包含所有优先级，也可包含由...确定的子集
  • jira-pp-cli priority set-default — 设置默认问题优先级。所需权限： 管理 Jira [全局...
  • jira-pp-cli priority update — 更新问题优先级。必须至少定义一个请求正文参数。请求正文中的 iconUrl 参数将弃用...

优先级方案 — 管理优先级方案

  • jira-pp-cli priorityscheme create-priority-scheme — 创建新的优先级方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli priorityscheme delete-priority-scheme — 删除优先级方案。此操作仅适用于没有关联项目的优先级方案。...
  • jira-pp-cli priorityscheme get-available-priorities-by-priority-scheme — 返回可添加到优先级方案的优先级的分页列表。...
  • jira-pp-cli priorityscheme get-priority-schemes — 返回优先级方案的分页列表。所需权限： 具有...
  • jira-pp-cli priorityscheme suggested-priorities-for-mappings — 根据优先级变更或...，返回需要映射的优先级的分页列表。
  • jira-pp-cli priorityscheme update-priority-scheme — 更新优先级方案，包括其详情、其中的优先级列表和项目列表...

project — 此资源表示项目。使用它可以获取、创建、更新和删除项目，还可以获取项目可用的状态和项目的通知方案，并更新项目类型。

  • jira-pp-cli project create — 根据项目类型模板创建项目，如下表所示：| 项目类型键 | 项目...
  • jira-pp-cli project delete — 删除项目。如果项目已归档，则无法删除。要删除已归档的项目，请先恢复项目...
  • jira-pp-cli project get — 返回项目的项目详情。此操作可以...
  • jira-pp-cli project get-accessible-type-by-key — 如果用户有权访问某个项目类型，则返回该类型。...
  • jira-pp-cli project get-all — 返回用户可见的所有项目。已弃用，请改用[获取项目...
  • jira-pp-cli project get-all-accessible-types — 返回具有有效许可证的所有项目类型。
  • jira-pp-cli project get-all-types — 返回所有项目类型，无论实例是否具有有效...
  • jira-pp-cli project get-recent — 返回用户最近查看且仍对其可见的最多 20 个项目的列表。此操作...
  • jira-pp-cli project get-type-by-key — 返回一个项目类型。此操作可匿名访问。...
  • jira-pp-cli project search — 返回用户可见项目的分页列表。此操作可匿名访问。...
  • jira-pp-cli project update — 更新项目的项目详情。所有参数均为可选...

project-category — 管理项目类别

  • jira-pp-cli project-category create — 创建项目类别。所需权限： 管理 Jira [全局...
  • jira-pp-cli project-category get-all-project-categories — 返回所有项目类别。所需权限： 具有访问 Jira 的权限。
  • jira-pp-cli project-category get-by-id — 返回项目类别。所需权限： 具有访问 Jira 的权限。
  • jira-pp-cli project-category remove — 删除项目类别。所需权限： 管理 Jira [全局...
  • jira-pp-cli project-category update — 更新项目类别。所需权限： 管理 Jira [全局...

project-template — 此资源表示项目模板。使用它可以根据自定义模板创建新项目。

  • jira-pp-cli project-template create-project-with-custom-template — 根据请求中提供的自定义模板创建项目。请求正文应包含项目……
  • jira-pp-cli project-template edit-template — 编辑自定义模板。此 API 端点允许你编辑现有的自定义模板。***注意：自定义模板……
  • jira-pp-cli project-template live-template — 获取自定义模板。此 API 端点允许你通过 templateKey 等信息获取实时自定义项目模板的详细信息……
  • jira-pp-cli project-template remove-template — 移除自定义模板。此 API 端点允许你移除指定的自定义模板。***注意：自定义……
  • jira-pp-cli project-template save-template — 保存自定义模板。此 API 端点允许你保存自定义模板。***注意：自定义模板仅……

projects — 此资源代表项目。使用它来获取、创建、更新和删除项目。还可获取项目可用的状态和项目通知方案，并更新项目类型。

  • jira-pp-cli projects — 返回请求的项目和工作类型的字段分页列表。仅包含……

projectvalidate — 管理 projectvalidate

  • jira-pp-cli projectvalidate get-valid-project-key — 验证项目键；如果项目键无效或已被使用，则为项目键生成有效的随机字符串……
  • jira-pp-cli projectvalidate get-valid-project-name — 检查项目名称是否已被使用。如果未被使用，则返回传入的字符串。如果名称已被……
  • jira-pp-cli projectvalidate validate-project-key — 通过确认项目键是有效字符串且未被使用，来验证项目键。**权限……

redact — 管理 redact

  • jira-pp-cli redact get-redaction-status — 获取脱敏作业 ID 的当前状态。jobStatus 的值可能如下：* IN_PROGRESS - ……
  • jira-pp-cli redact redact — 提交脱敏问题字段数据的作业。这将触发对指定字段中数据的脱敏……

resolution — 管理 resolution

  • jira-pp-cli resolution create — 创建问题解决方案。所需权限： 管理 Jira [全局……
  • jira-pp-cli resolution delete — 删除问题解决方案。此操作为异步。请按照响应中的 location 链接……
  • jira-pp-cli resolution get — 返回所有问题解决方案值的列表。所需权限： 访问 Jira 的权限。
  • jira-pp-cli resolution get-id — 返回问题解决方案值。所需权限： 访问 Jira 的权限。
  • jira-pp-cli resolution move — 更改问题解决方案的顺序。所需权限： 管理 Jira [全局……
  • jira-pp-cli resolution search — 返回解决方案的分页列表。该列表可包含所有解决方案，也可包含按……条件筛选的子集
  • jira-pp-cli resolution set-default — 设置默认问题解决方案。所需权限： 管理 Jira [全局……
  • jira-pp-cli resolution update — 更新问题解决方案。所需权限： 管理 Jira [全局……

role — 管理 role

  • jira-pp-cli role create-project — 创建一个没有默认执行者的新项目角色。你可以使用[添加默认...
  • jira-pp-cli role delete-project — 删除项目角色。如果要删除正在使用中的项目角色，则必须指定一个替代项目角色...
  • jira-pp-cli role fully-update-project — 更新项目角色的名称和描述。请求中必须同时包含名称和描述...
  • jira-pp-cli role get-all-project — 获取所有项目角色的列表，其中包含项目角色详情和默认执行者。### 关于项目角色 ###...
  • jira-pp-cli role get-project-by-id — 获取项目角色详情以及与该角色关联的默认执行者。默认执行者列表按...排序
  • jira-pp-cli role partial-update-project — 更新项目角色的名称或描述。不能同时更新名称和描述...

screens — 此资源表示用于记录问题详情的屏幕。可用于：

  • 获取所有屏幕的详情。
  • 获取所有可用于屏幕的字段详情。
  • 创建屏幕。
  • 删除屏幕。
  • 更新屏幕。
  • 向默认屏幕添加字段。
  • jira-pp-cli screens add-field-to-default — 向默认屏幕的默认选项卡添加字段。所需权限： 管理 Jira...
  • jira-pp-cli screens create — 创建一个包含默认字段选项卡的屏幕。所需权限： 管理 Jira [全局...
  • jira-pp-cli screens delete — 删除屏幕。如果屏幕方案、工作流或工作流草稿正在使用某个屏幕，则无法删除该屏幕。仅...
  • jira-pp-cli screens get — 返回所有屏幕或由一个或多个屏幕 ID 指定的屏幕的分页列表...
  • jira-pp-cli screens get-bulk-tabs — 返回一批屏幕的选项卡列表。所需权限： * 管理 Jira...
  • jira-pp-cli screens update — 更新屏幕。只能更新经典项目使用的屏幕。所需权限：...

screenscheme — 管理屏幕方案

  • jira-pp-cli screenscheme create-screen-scheme — 创建屏幕方案。所需权限： 管理 Jira [全局...
  • jira-pp-cli screenscheme delete-screen-scheme — 删除屏幕方案。如果问题类型屏幕方案正在使用某个屏幕方案，则无法删除该屏幕方案。仅...
  • jira-pp-cli screenscheme get-screen-schemes — 返回屏幕方案的分页列表。仅...经典项目使用的屏幕方案
  • jira-pp-cli screenscheme update-screen-scheme — 更新屏幕方案。只能更新经典项目使用的屏幕方案。**所需权限...

securitylevel — 管理安全级别

  • jira-pp-cli securitylevel <id> — 返回问题安全级别的详情。使用[获取问题安全...

server-info — 此资源提供有关 Jira 实例的信息。

  • jira-pp-cli server-info — 返回有关 Jira 实例的信息。此操作可匿名访问...

settings — 管理设置

  • jira-pp-cli settings get-issue-navigator-default-columns — 返回问题导航器的默认列。所需权限： 管理 Jira [全局...
  • jira-pp-cli settings set-issue-navigator-default-columns — 设置问题导航器的默认列。columns 参数接受可导航字段值，且以...格式表示

status — 此资源表示状态。可用于搜索、获取、创建、删除和更改状态。

  • jira-pp-cli status get — 返回一个状态。只有与活动工作流关联的状态才会返回。如果名称用于...更多

  • jira-pp-cli status get-statuses — 返回与活动工作流关联的所有状态的列表。此操作可匿名访问... statuscategory — 管理状态类别

  • jira-pp-cli statuscategory get-status-categories — 返回所有状态类别的列表。所需权限： 有权访问 Jira。

  • jira-pp-cli statuscategory get-status-category — 返回一个状态类别。状态类别提供了一种对……进行分类的机制

statuses — 管理状态

  • jira-pp-cli statuses create — 创建全局或项目范围的状态。所需权限： * 管理项目……
  • jira-pp-cli statuses delete-by-id — 按 ID 删除状态。所需权限： * 管理项目 [项目……
  • jira-pp-cli statuses get-by-id — 返回一个或多个状态 ID 指定的状态列表。所需权限： *……
  • jira-pp-cli statuses get-by-name — 返回一个或多个状态名称指定的状态列表。所需权限： *……
  • jira-pp-cli statuses search — 返回一个分页列表，其中包含……
  • jira-pp-cli statuses update — 按 ID 更新状态。所需权限： * 管理项目 [项目……

task — 此资源表示一个长时间运行的异步任务。可用它获取长时间运行任务的进度详情，或取消该任务。

ui-modifications — 管理 UI 修改

  • jira-pp-cli ui-modifications create — 创建 UI 修改。只有 Forge 应用才能创建 UI 修改。每个应用最多可定义 3000 个 UI……
  • jira-pp-cli ui-modifications delete — 删除 UI 修改。该 UI 修改所属的所有上下文也会一并删除。UI 修改……
  • jira-pp-cli ui-modifications get — 获取 UI 修改。只有 Forge 应用才能检索 UI 修改。**所需权限……
  • jira-pp-cli ui-modifications update — 更新 UI 修改。只有 Forge 应用才能更新 UI 修改。每个 UI 修改最多可定义……

universal-avatar — 管理通用头像

  • jira-pp-cli universal-avatar delete-avatar — 从项目、问题类型或优先级中删除头像。所需权限： *管理……
  • jira-pp-cli universal-avatar get-avatar-image-by-id — 按 ID 返回项目、问题类型或优先级的头像图片。此操作可匿名访问……
  • jira-pp-cli universal-avatar get-avatar-image-by-owner — 返回项目、问题类型或优先级的头像图片。此操作可匿名访问……
  • jira-pp-cli universal-avatar get-avatar-image-by-type — 返回默认的项目、问题类型或优先级头像图片。此操作可匿名访问……
  • jira-pp-cli universal-avatar get-avatars — 返回项目、问题类型或优先级的系统头像和自定义头像。此操作可……
  • jira-pp-cli universal-avatar store-avatar — 为项目、问题类型或优先级上传自定义头像。在请求正文中指定头像的本地文件位置……

user — 此资源表示用户。可用它：

  • 获取、列出、创建和删除用户。
  • 获取、设置和重置用户的默认问题表列。
  • 获取用户所属群组的列表。
  • 获取一组用户名或用户密钥对应的用户账号 ID 列表。
  • jira-pp-cli user bulk-get — 返回由一个或多个账户 ID 指定的用户的分页列表……
  • jira-pp-cli user bulk-get-migration — 返回由 key 或 username 参数指定的用户的账户 ID。请注意，多个 key 或……
  • jira-pp-cli user create — 创建用户。此资源为保持旧版兼容性而保留。一旦出现更合适的替代方案……
  • jira-pp-cli user delete-property — 删除用户的一个属性。注意：此操作不会访问[用户……
  • jira-pp-cli user find — 返回与搜索字符串和属性匹配的活跃用户列表。此操作会先应用筛选条件……
  • jira-pp-cli user find-assignable — 返回可分配到某个问题的用户列表。使用此操作查找可以……
  • jira-pp-cli user find-bulk-assignable — 返回可在一个或多个项目中分配问题的用户列表。此列表可能仅包含……
  • jira-pp-cli user find-by-query — 使用结构化查询查找用户，并返回用户详细信息的分页列表。此操作……
  • jira-pp-cli user find-for-picker — 返回属性与查询词匹配的用户列表。返回的对象包含 html 字段，其中……
  • jira-pp-cli user find-keys-by-query — 使用结构化查询查找用户，并返回用户密钥的分页列表。此操作接受……
  • jira-pp-cli user find-with-all-permissions — 返回符合以下条件的用户列表：* 用户属性与搜索字符串匹配。* 用户拥有一组……
  • jira-pp-cli user find-with-browse-permission — 返回符合以下条件的用户列表：* 用户属性与搜索字符串匹配。* 用户拥有……
  • jira-pp-cli user get — 返回用户。响应会根据用户的偏好应用隐私控制。这可能意味着……
  • jira-pp-cli user get-default-columns — 返回用户的默认问题表格列。如果 accountId 为……
  • jira-pp-cli user get-email — 返回用户的电子邮件地址，不受用户个人资料可见性设置的影响。对于 Connect 应用，此 API……
  • jira-pp-cli user get-email-bulk — 返回用户的电子邮件地址，不受用户个人资料可见性设置的影响。对于 Connect 应用，此 API……
  • jira-pp-cli user get-groups — 返回用户所属的群组。所需权限： 浏览用户和群组……
  • jira-pp-cli user get-property — 返回用户属性的值。如果未提供属性键，[获取用户属性……
  • jira-pp-cli user get-property-keys — 返回用户所有属性的键。注意：此操作不会访问[用户……
  • jira-pp-cli user remove — 删除用户。如果操作成功完成，用户将从 Jira 用户库中移除。此……
  • jira-pp-cli user reset-columns — 将用户的默认问题表格列重置为系统……
  • jira-pp-cli user set-columns — 设置用户的默认问题表格列。如果提供了账户 ID……
  • jira-pp-cli user set-property — 设置用户属性的值。使用此资源可为用户存储自定义数据。注意：此操作……

users — 此资源代表用户。可用于：

  • 获取、列出、创建和删除用户。
  • 获取、设置和重置用户的默认问题表格列。
  • 获取用户所属群组的列表。
  • 获取用户名或用户密钥列表对应的用户账户 ID 列表。
  • jira-pp-cli users get-all — 返回所有用户的列表，包括活跃用户、不活跃用户和之前已删除且拥有……的用户
  • jira-pp-cli users get-all-default — 返回所有用户的列表，包括活跃用户、不活跃用户和之前已删除且拥有……的用户

webhook — 此资源表示 Webhook。Webhook 是在 Jira 中发生事件时，向某个 URL 发送的调用，该事件涉及由 JQL 查询指定的问题。只有 Connect 和 OAuth 2.0 应用可以注册和管理 Webhook。更多信息，请参阅 Webhook。

  • jira-pp-cli webhook delete-by-id — 按 ID 移除 Webhook。只会移除由调用应用注册的 Webhook。如果 Webhook 是由其他应用创建的……
  • jira-pp-cli webhook get-dynamic-for-app — 返回由调用应用注册的 Webhook 的分页列表。**权限……
  • jira-pp-cli webhook get-failed — 返回最近在达到最大……次数后，未能传递给请求应用的 Webhook
  • jira-pp-cli webhook refresh — 延长 Webhook 的有效期。通过 REST API 注册的 Webhook 会在 30 天后过期。调用此操作以……
  • jira-pp-cli webhook register-dynamic — 注册 Webhook。**注意：**对于非公开 OAuth 应用，只有当……之间匹配时，才会传递 Webhook

workflows — 此资源表示工作流。使用它可以：

  • 获取工作流
  • 创建工作流
  • 更新工作流
  • 删除非活跃工作流
  • 获取工作流功能
  • jira-pp-cli workflows capabilities — 使用工作流 ID，或项目和问题……，获取特定工作流的工作流功能列表
  • jira-pp-cli workflows create — 创建工作流及相关状态。所需的权限： * 管理 Jira 项目……
  • jira-pp-cli workflows get-default-editor — 获取用户的默认工作流编辑器。可以是新版编辑器或旧版编辑器。
  • jira-pp-cli workflows read — 通过提供工作流名称、工作流 ID，或项目和问题……，返回工作流及相关状态的列表
  • jira-pp-cli workflows read-previews — 返回指定项目中的指定工作流。响应提供工作流的只读预览，……
  • jira-pp-cli workflows search — 返回全局工作流和项目工作流的分页列表。如果在……中指定了工作流名称
  • jira-pp-cli workflows update — 更新工作流及相关状态。所需的权限： * 管理 Jira 项目……
  • jira-pp-cli workflows validate-create — 验证批量创建工作流的负载。所需的权限： * 管理 Jira……
  • jira-pp-cli workflows validate-update — 验证批量更新工作流的负载。所需的权限： * 管理 Jira……

workflowscheme — 管理工作流方案

  • jira-pp-cli workflowscheme assign-scheme-to-project — 为项目分配工作流方案。仅当项目中没有问题时才会执行此操作……
  • jira-pp-cli workflowscheme create-workflow-scheme — 创建工作流方案。所需权限： 管理 Jira [全局……
  • jira-pp-cli workflowscheme delete-workflow-scheme — 删除工作流方案。请注意，如果工作流方案处于活动状态（即正在被……使用），则无法删除。
  • jira-pp-cli workflowscheme get-all-workflow-schemes — 返回所有工作流方案的分页列表，不包括草稿工作流方案……
  • jira-pp-cli workflowscheme get-required-workflow-scheme-mappings — 获取对工作流方案进行所需更改的状态映射。结果按每个问题……提供
  • jira-pp-cli workflowscheme get-workflow-scheme — 返回工作流方案。所需权限： 管理 Jira [全局……
  • jira-pp-cli workflowscheme get-workflow-scheme-project-associations — 返回与一组项目关联的工作流方案列表。每个返回的工作流方案都包含……
  • jira-pp-cli workflowscheme read-workflow-schemes — 通过提供工作流方案 ID 或项目 ID，返回工作流方案列表。**所需权限……
  • jira-pp-cli workflowscheme switch-workflow-scheme-for-project — 切换项目的工作流方案。只能为经典项目分配工作流方案。**计算……
  • jira-pp-cli workflowscheme update-schemes — 更新公司管理和团队管理项目的工作流方案。此 API 没有草稿概念，因此任何……
  • jira-pp-cli workflowscheme update-workflow-scheme — 更新公司管理项目的工作流方案，包括名称、默认工作流、问题类型到项目……

worklog — 管理工作日志

  • jira-pp-cli worklog get-for-ids — 返回一组工作日志 ID 对应的工作日志详情。返回的工作日志列表最多包含 1000 项……
  • jira-pp-cli worklog get-ids-of-deleted-since — 返回某个日期和时间之后删除的工作日志 ID 和删除时间戳列表。此资源采用分页……
  • jira-pp-cli worklog get-ids-of-modified-since — 返回某个日期和时间之后更新的工作日志 ID 和更新时间戳列表。此资源采用分页……
查找合适的命令

当你知道要做什么，但不知道该用哪个命令时，可以直接询问 CLI：

jira-pp-cli which "<capability in your own words>"

which 会根据自然语言能力查询，从此 CLI 精选的功能索引中匹配最合适的命令。退出代码 0 表示至少有一个匹配项；退出代码 2 表示没有可靠的匹配项——请改用 --help 或缩小查询范围。

身份验证设置

运行 jira-pp-cli auth setup 获取 URL 和令牌获取步骤（添加 --launch 可打开 URL）。然后保存令牌：

jira-pp-cli auth set-token YOUR_TOKEN_HERE

或者将 JIRA_OAUTH2 设置为环境变量。

运行 jira-pp-cli doctor 验证设置。

Agent 模式

向任意命令添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

  • 可通过管道传递 — JSON 输出到 stdout，错误输出到 stderr

  • 可筛选 — --select 保留字段子集。带点的路径会深入嵌套结构；数组则逐个遍历元素。对于冗长 API，缩小上下文至关重要：

    jira-pp-cli attachment get mock-value --agent --select id,name,status

  • 可预览 — --dry-run 显示请求但不发送

  • 支持离线使用 — 有本地 SQLite 存储时，同步／搜索命令可以使用它

  • 非交互式 — 不会显示提示，所有输入都通过标志提供

  • 显式重试 — 仅当已存在的创建操作应视为成功时使用 --idempotent；仅当缺失的删除目标应视为成功时使用 --ignore-missing

响应封套

从本地存储或 API 读取数据的命令会将输出封装在来源信息中：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

从 .results 解析数据，并通过 .meta.source 判断数据来自实时还是本地。只有当 stdout 是终端时，才会向 stderr 打印人类可读的 N results (live) 摘要；通过管道传输或由 Agent 消费时，stdout 只输出纯 JSON。

Agent 反馈

当你（或 Agent）发现这个 CLI 有不对劲的地方时，请记录下来：

jira-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
jira-pp-cli feedback --stdin < notes.txt
jira-pp-cli feedback list --json --limit 10

条目会保存在本地的 ~/.jira-pp-cli/feedback.jsonl 中。只有设置了 JIRA_FEEDBACK_ENDPOINT，并且传入了 --send 或设置了 JIRA_FEEDBACK_AUTO_SEND=true，才会通过 POST 发送。默认行为仅保存在本地。

写下让你感到意外的地方，而不是提交错误报告。简短、具体、一行即可：这些观察会逐渐累积成效。

输出交付

每条命令都接受 --deliver <sink>。除了（或取代）stdout 外，输出还会发送到指定的接收端，因此 Agent 无需手动通过管道传输，就能路由命令结果。支持三种接收端：

接收端效果
stdout默认；仅写入 stdout
file:<path>原子地将输出写入 <path>（临时文件 + 重命名）
webhook:<url>将输出正文 POST 到该 URL（使用 --compact 时为 application/json 或 application/x-ndjson）

遇到未知方案时，会拒绝执行并返回结构化错误，指出支持的方案。Webhook 请求失败时会返回非零状态，并在 stderr 中记录 URL 和 HTTP 状态码。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。若计划中的 Agent 每次运行都使用相同配置调用同一命令，可使用配置——这就是 HeyGen 的“Beacon”模式。

jira-pp-cli profile save briefing --json
jira-pp-cli --profile briefing attachment get mock-value
jira-pp-cli profile list --json
jira-pp-cli profile show briefing
jira-pp-cli profile delete briefing --yes

显式标志始终优先于配置值；配置值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置，让执行自省的 Agent 能在运行时发现它们。

异步任务

对于会提交长时间运行任务的端点，生成器会检测“提交后轮询”模式（响应中包含 job_id/task_id/operation_id 字段，并且存在对应的状态端点），并为提交命令添加三个额外标志：

标志用途
--wait阻塞直至任务到达终止状态，而不是立即返回任务 ID
--wait-timeout最长等待时长（默认 10m，0 表示不设超时）
--wait-interval初始轮询间隔（默认 2s；随后以指数退避方式递增，最长为 30s）

若要提交异步任务后不等待结果，请在不使用 --wait 的情况下提交；若希望一条命令返回已完成的产物，请使用 --wait。

退出代码

代码含义
0成功
2用法错误（参数错误）
3未找到资源
4需要身份验证
5API 错误（上游问题）
7请求过于频繁（等待后重试）
10配置错误

参数解析

解析 $ARGUMENTS：

  1. 为空、为 help 或 --help → 显示 jira-pp-cli --help 输出
  2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
  3. 其他任何内容 → 直接使用（以 --agent 执行 CLI 命令）

安装 MCP 服务

从此 CLI 发布的公共库条目或预构建版本安装 MCP 二进制文件，然后注册：

claude mcp add jira-pp-mcp -- jira-pp-mcp

验证：claude mcp list

直接使用

  1. 检查是否已安装：which jira-pp-cli 如果未找到，请提供安装选项（参见本技能开头的先决条件）。
  2. 根据上文的“独特功能”和“命令参考”，将用户查询匹配到最合适的命令。
  3. 使用 --agent 标志执行： 
    jira-pp-cli <command> [subcommand] [args] --agent
  4. 如有歧义，请查看子命令帮助：jira-pp-cli <command> --help。

评论

支持 Markdown