GitHub Action将Pull Request转回草稿失败：权限问题求助

以下是针对该权限问题的具体解决步骤：

• 确认权限配置的正确性
  务必在Workflow文件的顶层或对应Job中明确声明所需权限，不要依赖默认权限。示例配置如下：

  permissions:
    pull-requests: write
    contents: read # 若Workflow需要检出代码则保留此配置
  

  注意权限块必须放置在正确位置（如Workflow开头或目标Job内部），否则不会生效。

• 使用个人访问令牌（PAT）替代默认GITHUB_TOKEN
  GitHub自动生成的GITHUB_TOKEN存在权限限制：对于非bot用户创建的PR，它没有权限修改PR的草稿状态。解决方法是使用拥有仓库完整权限的PAT：

  1. 在GitHub个人设置中生成PAT，勾选repo权限（该权限包含Pull Requests的读写权限）。
  2. 将生成的PAT添加到仓库的Secrets中，命名为PR_MODIFY_TOKEN。
  3. 在Workflow中调用gh命令时，指定该令牌作为环境变量：

     - name: Convert PR to draft
       env:
         GH_TOKEN: ${{ secrets.PR_MODIFY_TOKEN }}
       run: gh pr ready $base_pr_id --undo
     

• 升级gh CLI到最新版本
  旧版本的gh CLI可能不支持gh pr ready --undo命令或存在API兼容性问题，建议在Action执行前安装最新版本：

  - name: Install latest GitHub CLI
    run: |
      curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
      echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
      sudo apt update && sudo apt install gh -y
  

• 验证目标PR状态
  在执行转换命令前，先确认目标PR处于“ready for review”状态，避免无效操作：

  - name: Convert PR to draft if ready
    run: |
      IS_DRAFT=$(gh pr view $base_pr_id --json draft --jq '.draft')
      if [ "$IS_DRAFT" = "false" ]; then
        gh pr ready $base_pr_id --undo
      else
        echo "Target PR is already a draft, skipping conversion"
      fi
  

内容的提问来源于stack exchange，提问作者JacksOnF1re