通过 Jira 集成，可以在 Jira 工作项中通过分配、评论提及或工作流转换三种方式触发 Copilot Cloud Agent。Agent 会获取工作项的标题、描述、标签、评论和自定义字段作为上下文，在 GitHub 创建 PR，并在 Jira 中推送进度通知。

GitHub Copilot Cloud Agent 集成 Jira：从工作项触发 AI 创建 PR

此功能目前处于公开预览阶段，行为可能变化。

适用场景

• 产品经理在 Jira 详细描述需求，工程师直接在工作项中分配给 Copilot
• 测试创建 Bug ticket，让 Copilot 先起草修复代码供工程师审核
• 通过 Jira 工作流自动化，在 ticket 移入"开发中"时自动触发 Copilot

前提条件

• 有 Copilot Pro、Pro+、Business 或 Enterprise 访问权限的 GitHub 账号
• Jira Cloud（需启用 AI 功能和 Rovo）
• 对目标 GitHub 仓库有写入权限

安装步骤

需要 GitHub 组织的 Owner 或 App Manager 权限，以及 Jira 工作区管理员权限。

1. 在 Atlassian Marketplace 搜索 GitHub Copilot，找到集成 App
2. 按提示完成安装和 GitHub 授权

GitHub Enterprise Cloud（GHE）用户：需要额外配置 GHE 子域名，联系 GitHub 支持获取具体步骤。

三种触发方式

安装完成后，Jira 工作项界面有三种触发 Copilot 的方式：

方式一：通过 Assignee 分配

在工作项的 Assignee 字段中，选择 GitHub Copilot 作为负责人。

方式二：在评论中 @提及

在工作项评论中 @提及：

@GitHub Copilot 在 octo-org/my-repo 中为用户认证模块创建一个新的 API endpoint

可在提及时指定模型：

@GitHub Copilot use Claude Sonnet 4.5 重构这个函数，提高可读性

方式三：工作流转换自动触发

在 Jira 工作流中配置：当 ticket 移到特定状态（如"待开发"）时，自动将 Copilot 添加为分配人，自动触发任务。

Copilot 能读取的上下文

Jira 集成是所有集成中上下文最丰富的，Copilot 会读取：

• 工作项标题和描述
• 标签（Labels）
• 所有评论（按时间顺序）
• 自定义字段（Custom Fields）

这些内容会存储到生成的 PR 描述中，便于 Code Review 追溯。

操作流程示例

1. 在 Jira 创建包含详细描述和验收标准的工作项
2. 在描述或评论中指定目标仓库（如 repo: octo-org/my-app）
3. 将工作项分配给 Copilot 或在评论中 @提及
4. 首次使用时，按提示授权 GitHub 集成
5. Jira 活动流中会出现进度通知，跟踪 Copilot 的处理状态
6. 完成后，在 Links 区域找到 [WIP] 标记的 PR 链接，点击跳转 GitHub 审核

自定义指令

可以在提及 Copilot 时附加指令：

• 指定分支策略：请基于 feature/auth-v2 分支创建
• 要求使用自定义 Agent：请使用我们的 code-reviewer 自定义 Agent
• 指定模型：use Claude Sonnet 4.5

常见问题

Q: 工作项中没有看到 Copilot 选项怎么办？

A: 确认 Jira 已启用 AI 功能（Settings → Products → Jira Labs → AI features）。如果使用发布轨道，可能需要联系 Atlassian Support 启用 agent 功能。

Q: @提及后 Copilot 没有响应？

A: 检查：① 是否已连接 GitHub 账号（首次使用需要授权）；② GitHub 账号是否有目标仓库的写入权限；③ 查看 GitHub Status 确认服务正常。

Q: 自定义字段的内容 Copilot 能读到吗？

A: 可以。Jira 集成支持读取自定义字段，这是与 Slack/Teams 集成的一个区别。确保自定义字段有填写内容，Copilot 会将其作为上下文参考。