GitHub Action能否管理多仓库并向非运行所属的独立仓库写入创建文件？

结论 #

GitHub Action完全支持管理多个仓库，也可以向运行所属仓库之外的独立仓库写入内容、创建新文件，你需要存储PR描述的需求可以正常实现。

具体实现方案 #

前置准备

你需要先准备有权限操作目标仓库的凭证：

• 生成GitHub个人访问令牌（PAT），为该令牌开启目标仓库的contents读写权限
• 将生成的PAT保存到当前运行Action的仓库的加密Secrets中，假设命名为TARGET_REPO_TOKEN

方案1：通过签出目标仓库操作（适合多文件修改/批量操作场景）

直接使用官方actions/checkout动作签出目标独立仓库，修改完成后直接推送即可，示例工作流配置如下：

name: 保存PR内容到外部仓库
on:
  pull_request:
    types: [opened, edited]

jobs:
  save-pr-content:
    runs-on: ubuntu-latest
    steps:
      # 先获取当前PR的描述内容
      - name: 提取PR描述
        id: get-pr-body
        run: |
          echo "pr_body<<EOF" >> $GITHUB_OUTPUT
          echo "${{ github.event.pull_request.body }}" >> $GITHUB_OUTPUT
          echo "EOF" >> $GITHUB_OUTPUT

      # 签出目标独立仓库
      - name: 签出目标存储仓库
        uses: actions/checkout@v4
        with:
          repository: <你的用户名/目标仓库名>
          token: ${{ secrets.TARGET_REPO_TOKEN }}
          path: target-storage-repo # 存到运行器的指定目录下

      # 写入PR内容到新文件
      - name: 写入PR内容到文件
        run: |
          cd target-storage-repo
          echo "${{ steps.get-pr-body.outputs.pr_body }}" > pr-${{ github.event.pull_request.number }}.md

      # 提交并推送修改到目标仓库
      - name: 提交并推送修改
        run: |
          cd target-storage-repo
          git config user.name "github-actions[bot]"
          git config user.email "github-actions[bot]@users.noreply.github.com"
          git add .
          git commit -m "feat: 保存PR #${{ github.event.pull_request.number }} 描述内容"
          git push

方案2：通过GitHub API直接创建文件（适合单文件快速写入场景）

如果你只需要创建单个文件，不需要拉取整个目标仓库，可以直接使用GitHub CLI（Action运行环境默认预装）调用API完成写入，示例如下：

- name: 直接通过API创建文件到目标仓库
  env:
    GITHUB_TOKEN: ${{ secrets.TARGET_REPO_TOKEN }}
    PR_NUM: ${{ github.event.pull_request.number }}
    PR_BODY: ${{ github.event.pull_request.body }}
  run: |
    # 将内容转成base64符合API要求
    CONTENT_B64=$(echo "$PR_BODY" | base64 -w 0)
    gh api -X PUT /repos/<你的用户名/目标仓库名>/contents/pr-$PR_NUM.md \
      -f message="保存PR #$PR_NUM 描述内容" \
      -f content="$CONTENT_B64"

注意事项 #

• PAT授权遵循最小权限原则，仅开放目标仓库的contents读写权限即可，不要授予不必要的权限范围
• 如果目标仓库属于组织，需要确认PAT符合组织的访问限制规则，避免被权限拦截
• 若存在多个PR同时触发Action写入同一文件的场景，需要额外添加冲突处理逻辑，避免提交失败

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