SuperAPI AI 工具集

codeowners

通用与其它

查看项目

更新于 10-16 03:16

技能介绍

用途:围绕 CODEOWNERS 单个文件及其对应的 ruleset 规则,完成编写、校验与强制审批。不涉及通用分支 ruleset 配置,也不处理社区健康文件。

主要能力:检测 .github/CODEOWNERS、仓库根、docs/CODEOWNERS 三个位置并判定哪个生效;获取默认分支与仓库名;按目录结构或 git 提交历史收集归属候选;按语法与优先级撰写规则;用 API 校验语法与归属错误;在用户明确授权后开启 require_code_owner_review 强制代码所有者审批。

使用方式(命令保持原样): for path in .github/CODEOWNERS CODEOWNERS docs/CODEOWNERS; do test -f "$path" && echo "Found: $path" done REPO="$(gh repo view --json nameWithOwner --jq '.nameWithOwner')" DEFAULT_BRANCH="$(gh repo view "$REPO" --json defaultBranchRef --jq '.defaultBranchRef.name')" git ls-files | awk -F/ 'NF>1 {print $1"/"$2"/"} NF==1 {print $1}' | sort -u git shortlog -sn -- <path> gh api "repos/$REPO/codeowners/errors" gh api "repos/$REPO/rulesets" --jq '.[] | select(.target=="branch") | {id, name}' gh api -X PUT "repos/$REPO/rulesets/<id>" --input "$TMPDIR/ruleset.json"

关键规则:最后匹配的模式生效,通用规则在前、具体覆盖在后;@org/team 需该团队对仓库有写权限;路径模式遵循 .gitignore 语法,/dir/ 锚定根目录,dir/ 任意位置匹配,*.ext 按扩展名匹配;# 为注释,也可用作分组标题。

核实团队写权限: gh api -H 'Accept: application/vnd.github.v3.repository+json' orgs/{org}/teams/{slug}/repos/$REPO 要求 .permissions.push 为 true。

限制与注意:本地 push 前可用 git ls-files -- '<pattern>' 做存在性检查;/codeowners/errors 返回 404 表示默认分支三个位置都没有该文件,需先推送;CODEOWNERS 本身只请求评审、不阻止合并,需 ruleset 中设置 require_code_owner_review: true 才强制审批;修改 ruleset 必须获得用户对该次写入的明确授权;覆盖已有文件前要展示 diff;不得虚构 GitHub 账号或团队 slug;已配置仓库上重跑应为无改动。另提及可选 required-reviewer 规则,但不应擅自启用。免费与否、支持平台等暂未提供。