GitHub Copilot 编码智能体 — 从 Issue 到草稿拉取请求的自动化

如果您在 Issue 上添加 ai-copilot 标签，GitHub Actions 会自动将其分配给 Copilot，
然后 Copilot 会创建分支 → 编写代码 → 打开一个草稿拉取请求。

何时使用此技能

• 当产品经理/设计师创建 Issue，并且 Copilot 无需开发人员介入即可开始实现时
• 当将待办事项（重构/文档/测试）下放给 Copilot 处理时
• 当将由 Vibe Kanban 或 Conductor 创建的后续工作委派给 Copilot 时
• 当自动化像 Jira → GitHub Issue → Copilot 拉取请求这样的流水线时

前提条件

• GitHub 套餐：Copilot Pro+、Business 或 Enterprise
• Copilot 编码智能体已启用：必须在仓库设置中启用
• gh 命令行工具：已认证
• 个人访问令牌：具有 repo 范围的个人访问令牌

一次性设置

# 一键设置（注册令牌 + 部署工作流 + 创建标签）
bash scripts/copilot-setup-workflow.sh

此脚本执行：

1. 将 COPILOT_ASSIGN_TOKEN 注册为仓库密钥
2. 部署 .github/workflows/assign-to-copilot.yml
3. 创建 ai-copilot 标签

使用方法

选项 1：GitHub Actions 自动化（推荐）

# 创建 Issue + ai-copilot 标签 → 自动分配给 Copilot
gh issue create \
  --label ai-copilot \
  --title "添加用户认证" \
  --body "实现基于 JWT 的认证，支持刷新令牌。包含登录、登出、刷新端点。"

选项 2：向现有 Issue 添加标签

# 为 Issue #42 添加标签 → 触发 Actions
gh issue edit 42 --add-label ai-copilot

选项 3：通过脚本直接分配

export COPILOT_ASSIGN_TOKEN=<您的个人访问令牌>
bash scripts/copilot-assign-issue.sh 42

工作原理（技术层面）

Issue 创建/被标记
    ↓
GitHub Actions 触发 (assign-to-copilot.yml)
    ↓
通过 GraphQL 查找 Copilot 机器人 ID
    ↓
replaceActorsForAssignable → 将 Copilot 设置为受理人
    ↓
Copilot 编码智能体开始处理该 Issue
    ↓
创建分支 → 编写代码 → 打开草稿拉取请求
    ↓
自动将您分配为拉取请求审阅者

所需的 GraphQL 头部：

GraphQL-Features： issues_copilot_assignment_api_support,coding_agent_model_selection

GitHub Actions 工作流

Copilot 拉取请求限制

Copilot 被视为外部贡献者。

• 拉取请求默认创建为草稿
• 在首次运行 Actions 之前，需要具有写入权限的人员进行手动批准
• 批准后，copilot-pr-ci.yml CI 将正常运行

# 手动批准后检查 CI
gh pr list --search 'head:copilot/'
gh pr view <拉取请求编号>

planno（plannotator）集成 — 可选

在分配给 Copilot 之前，可以在 planno 中审查 Issue 规范（独立技能，非必需）：

在 planno 中审查并批准此 Issue 规范

批准后，添加 ai-copilot 标签 → 触发 Actions。

常见用例

1. 基于标签的 Copilot 队列

产品经理编写 Issue → 添加 ai-copilot 标签
→ Actions 自动分配 → Copilot 创建草稿拉取请求
→ 团队仅执行拉取请求审阅

2. 与 Vibe Kanban / Conductor 结合使用

由 Vibe Kanban 创建的后续 Issue：
  重构/文档清理/添加测试
  → ai-copilot 标签 → Copilot 处理
→ 团队专注于主要功能开发

3. 外部系统集成

Jira Issue → Zapier/webhook → 自动创建 GitHub Issue
→ ai-copilot 标签 → Copilot 拉取请求
→ 完全自动化的流水线

4. 重构待办事项处理

# 批量向待办事项添加标签
gh issue list --label "tech-debt" --json number \
  | jq '.[].number' \
  | xargs -I{} gh issue edit {} --add-label ai-copilot

检查结果

# 列出由 Copilot 创建的拉取请求
gh pr list --search 'head:copilot/'

# 特定 Issue 的状态
gh issue view 42

# 拉取请求 CI 状态
gh pr checks <拉取请求编号>

参考资料

• GitHub Copilot 编码智能体概述
• 要求 Copilot 创建拉取请求（GraphQL 示例）
• 官方文档：将 Copilot 分配给 Issue
• Copilot 拉取请求权限/限制
• GitHub Copilot 编码智能体（VSCode 文档）

快速参考

=== 设置 ===
bash scripts/copilot-setup-workflow.sh   一次性设置

=== Issue 分配 ===
gh issue create --label ai-copilot ...  新 Issue + 自动分配
gh issue edit <编号> --add-label ai-copilot  现有 Issue
bash scripts/copilot-assign-issue.sh <编号>  手动分配

=== 验证结果 ===
gh pr list --search 'head:copilot/'    Copilot 拉取请求列表
gh pr view <编号>                        拉取请求详情
gh pr checks <编号>                      CI 状态

=== 限制条件 ===
需要 Copilot Pro+/Business/Enterprise
首个拉取请求需要手动批准（视为外部贡献者）
个人访问令牌：需要 repo 范围