如何通过GitHub CLI或API为组织仓库规则集添加指定目标仓库？

一、用GitHub CLI（gh）通过API直接更新 #

GitHub CLI目前没有专门的ruleset update命令，但可以用gh api调用REST API实现目标仓库的添加：

1. 获取目标仓库的ID
   先拿到要添加的仓库的ID，执行命令：

   gh repo view <你的仓库名> --org <组织名> --json id --jq .id
   

   示例：gh repo view my-repo --org myorg --json id --jq .id，会返回类似123456789的数字ID。

2. 更新规则集的目标仓库列表
   执行以下命令，把仓库ID追加到规则集的target.repository_ids数组里（替换占位符）：

   gh api --method PATCH /orgs/<组织名>/rulesets/<规则集ID> \
     -f "target[repository_ids][]=<要添加的仓库ID>"
   

   一次性添加多个仓库时，重复-f "target[repository_ids][]=<仓库ID>"即可。

   若要覆盖原有目标仓库列表（而非追加），直接传完整数组：

   gh api --method PATCH /orgs/<组织名>/rulesets/<规则集ID> \
     -f "target[repository_ids]=[<仓库ID1>,<仓库ID2>]"
   

二、用Octokit库实现（以JavaScript为例） #

确保Octokit实例已配置拥有组织权限的访问令牌（需admin:org或repo权限）：

import { Octokit } from "octokit";

const octokit = new Octokit({ auth: "你的GitHub访问令牌" });

async function addRepoToRuleset(org, rulesetId, repoId) {
  // 获取当前规则集配置，避免覆盖其他设置
  const { data: ruleset } = await octokit.rest.orgs.getRuleset({
    org,
    ruleset_id: rulesetId
  });

  // 追加新仓库ID并去重
  const updatedRepoIds = [...new Set([...ruleset.target.repository_ids, repoId])];

  // 更新规则集
  await octokit.rest.orgs.updateRuleset({
    org,
    ruleset_id: rulesetId,
    target: {
      ...ruleset.target,
      repository_ids: updatedRepoIds
    }
  });

  console.log("仓库已成功添加到规则集目标");
}

// 调用示例
addRepoToRuleset("myorg", 123, 123456789);

三、注意事项 #

• 访问令牌需拥有足够权限：组织的仓库管理员或规则集管理权限，令牌至少包含admin:org或repo scope。
• 如果规则集当前目标类型为「所有仓库」，需先将目标类型改为「指定仓库」（在updateRuleset时设置target.type: "repository"），再添加仓库ID。
• 更新后可通过gh ruleset view <规则集ID> --org <组织名>验证结果。

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