GitHub Project Triage
当用户输入 triage 时始终使用此技能,除非请求明确针对非 GitHub 领域。在仓库内部时,默认使用当前 GitHub 项目。Triage 指面向维护者的项目卡片:URL、每个 Issue/PR 的内容、为何重要、作者信任度、适配度、风险、证据/测试状态、阻塞项和下一步行动。绝不只返回队列数字或模糊引用。
输出以 URL 优先:每个列出的 Issue/PR/仓库项必须在其第一行或第一句包含 GitHub URL。如果给出简短列表,每个项打印一个 URL。
将 RepoBar 作为第一遍工具使用,仅用于跨相关所有者/组织的广泛队列发现。RepoBar 比手动编写 gh repo list 循环更快且更了解配置文件,它已经理解仓库活动、Issue 数量、PR 数量、本地项目、认证、缓存和过滤器。
设置
优先使用已安装的真实 repobar 二进制文件。在此工作区中,它可能仅作为 SwiftPM 产品存在于 ~/Projects/RepoBar 中。
repobar_cmd() {
if command -v repobar >/dev/null 2>&1; then
repobar "$@"
elif [ -x "$HOME/Projects/RepoBar/.build/debug/repobarcli" ]; then
"$HOME/Projects/RepoBar/.build/debug/repobarcli" "$@"
else
swift run --package-path "$HOME/Projects/RepoBar" repobarcli "$@"
fi
}
repobar_cmd status --json
默认所有者用于广泛分类:steipete、openclaw。对于广泛/默认队列分类,即使 openclaw/openclaw 不是按计数排名第一的仓库,也需包含其详细检查,因为它是主要的 ClawdBot/OpenClaw 队列。除非用户指定、当前仓库已在该所有者名下、或任务明确要求全部/所有,否则不要包含 amantus-ai 或其他所有者。对于针对特定所有者的任务,不要扩大到该命名所有者之外。
本地仓库门控
在任何本地项目开始工作之前,验证签出是否就绪:
git status --short --branch
git branch --show-current
git pull --ff-only
git status --short --branch
仅当分支为 main、拉取成功且工作树干净时才继续。如果分支不是 main、拉取失败、或 git status --short 显示有更改,停止并询问 Peter 该怎么做。未经明确指示,不要切换分支、stash、commit、reset、restore 或 clean。
范围规则
如果用户说 triage 且当前工作目录是带有 GitHub 远程仓库的 Git 仓库,则仅对该项目进行分类。除非用户说 broad、all、everything、指定多个所有者/组织、或要求跨仓库分类,否则不要扩大到所有 Peter/组织队列。
如果仓库有 VISION.md,请在判断哪些可以自主处理之前先阅读它。将其作为产品适配度的真理来源,然后应用此技能的优先规则。如果不存在 VISION.md,则使用下面的自主适配规则。
查找当前项目:
repo=$(gh repo view --json nameWithOwner --jq .nameWithOwner 2>/dev/null || true)
if [ -z "$repo" ]; then
url=$(git remote get-url origin 2>/dev/null || true)
repo=$(printf '%s\n' "$url" |
sed -E 's#^[email protected]:##; s#^https://github.com/##; s#\\.git$##')
fi
printf '%s\n' "$repo"
当前项目分类从以下开始:
gh issue list --repo "$repo" --state open --limit 50 \
--json number,title,author,labels,createdAt,updatedAt,url
gh pr list --repo "$repo" --state open --limit 50 \
--json number,title,author,isDraft,reviewDecision,mergeStateStatus,createdAt,updatedAt,url
在对任何 Issue 或 PR 采取行动之前,阅读所有评论,并将 Peter/所有者的评论视为权威路由指令。如果 Peter 说看起来不错、需要修改、已取代、已获产品批准、或不想要,则覆盖机器人标签和普通分类判断。如果没有 Peter/所有者评论,请使用维护者判断,并说明决定是您做出的。
然后检查足够的详细信息以解释每个列出的项目。对于小型队列(约 10 个或更少的开放项目),检查所有项目。对于大型队列,检查最高优先级的切片,并说明哪些未展开。
gh issue view <n> --repo "$repo" \
--json number,title,author,body,comments,labels,createdAt,updatedAt,url
gh pr view <n> --repo "$repo" \
--json number,title,author,body,comments,files,commits,isDraft,reviewDecision,mergeStateStatus,statusCheckRollup,createdAt,updatedAt,url
gh pr diff <n> --repo "$repo" --patch
仅在证据充分时才进行评论、关闭、合并、重新运行或修补。
Triage 输出
当用户说 triage 时,始终扫描当前仓库的开放 Issues 和开放 PRs。返回:
Autonomous candidates:看起来无需更多产品输入即可修复/着陆的项目,附带 URL、符合条件的原因、所需验证和置信度。这是供审查的选择,除非用户还要求自主执行,否则并非开始工作的许可。Needs Peter:因 Peter/所有者决策、产品方向、缺少凭据/访问权限、无法获取的实时供应商证据、安全/隐私判断、或权威的 Peter 评论请求变更而受阻的项目。Defer/close/supersede:过时、重复、质量较低或重叠的项目,可能的操作不是编写新代码。
对于每个可能的自主候选项目,当存在工具支持时,使用可用的高推理子代理、oracle 或独立代理审查来评估可行性,然后再呈现。仅向子代理提供任务本地证据,并询问该项目是否可以自主完成、需要哪些验证、以及什么可能导致不安全。如果子代理不可用,自己进行相同深度的检查并说明。
自主工作模式
当用户说 do work autonomously、work you can do autonomously、keep going 或类似内容时,不要在队列摘要或一个本地补丁后停止。将其视为许可,按顺序处理符合条件的 Issue/PR 队列,直到没有安全的自主项目可处理、每个项目已着陆/关闭/推迟并有证据、或出现阻止项需要 Peter。
永远不要同时处理多个工单。对于每个项目:
- 阅读 Issue/PR、相关代码、文档、CI 和
VISION.md(如果存在);使用 Google/官方文档处理事实可能过时或不明确的情况。 - 判断是否可自主处理:
- Go:性能改进(除非复杂度增加过多);有重现/根因和验证路径的 bug 修复;小的 UI/UX 调整;文档修复;狭窄的测试/内部修复;低风险的依赖/CI 清理并有绿色证据。
- Ask first:新功能、产品/愿景选择、广泛行为变更、高风险依赖、无强证据的安全敏感变更、无可用凭据的实时供应商工作、任何无法端到端测试的内容。
- 重构偏好:当对于自主项目来说重构是更好的修复时,选择干净有界的方式;不要默认使用“小补丁”如果它留下更差的设计。
- 以最佳可维护方式实现或修复 PR。当可写入时优先更新贡献者 PR;否则在本地重建并注明来源。
- 尽可能进行本地验证和实时端到端测试。对于 UI 行为,使用仓库预期的实时 UI 验证路径,如 Peekaboo、browser-use、截图或 VM 证据。对于 API/供应商行为,尽可能使用真实的可用密钥/账户通过预期的秘密工作流。如果缺少访问权限,在假装项目完成之前停止并请 Peter 帮助。
- 在提交/着陆前运行 Codex Auto Review,除非是琐碎/仅文档或被明确跳过;处理可接受/可操作的发现。
- 确保 CI 变绿、PR 描述/更新日志良好、着陆/关闭/评论并附上证据,然后返回
main,拉取--ff-only,验证干净的工作树,再选择下一个自主项目。 - 在每个着陆的 PR 之后,发布一个 PR 评论,准确说明测试方式:本地命令、实时/UI/API 证据、CI 运行/检查状态、着陆提交以及任何注意事项。如果适用,上传/发布验证图像,当
gh image可用时使用;如果上传工具不可用,说明情况并包含截图路径或替代的 GitHub 附件证据,而不是默默地省略图像。
不要以脏文件或未推送的本地修复结束自主模式,除非被阻止。如果被阻止,说明确切阻止项、当前分支/状态、已收集的证据以及所需的下一个决策。
自主工作仍然受范围限制:默认当前仓库;仅当用户要求 broad/all/everything 或指定了所有者/组织时才扩展到广泛/所有队列。
信任信号
对于每个您建议采取行动的非维护者项目,包含作者/打开者的信任信息。对于低风险的 Dependabot/内部项目,简短的 bot/内部信任行即可。
优先使用捆绑的帮助脚本:
skills/github-project-triage/scripts/github-activity.sh --repo <owner/repo> --global <login>
如果此技能签出缺少帮助脚本,则回退到:
~/Projects/clawdbot/.agents/skills/openclaw-pr-maintainer/scripts/github-activity.sh --repo <owner/repo> --global <login>
当 PR 需要更深入的信任判断时,特别是对于 OpenClaw、安全敏感变更、广泛的 PR、新账户或异常的作者行为,也使用 github-author-context。优先使用现有的贡献者注释:
~/Projects/maintainers/scripts/clawtributors find github <login>
信任输出必须保持事实性:
Trust: @login; acct 2021-04-03; repo 2 PRs/1 issue/0 commits in 12mo; GitHub 9 PRs/3 issues/12 reviews; signal: known contributor / new drive-by / bot / unknown.
不要将信任视为证明。它改变审查深度,而非正确性。
项目评估
对每个项目进行分类:
bug:要求可行的重现/日志/失败测试/当前主分支证据;在推荐修复/合并前确定根因。feature:要求端到端测试计划。如果实时验证需要提供商密钥、账户、设备、服务、模型访问或付费 API,说明在认为工作完成前缺少的确切凭据/访问权限。dependency:解释包组、主要/次要风险、失败的检查、运行时/引擎变更以及是否应该拆分。security:提高优先级,要求仔细的代码路径证据、测试和信任/上下文;不要仅凭理由合并。docs/internal:风险较低,但仍需解释对用户可见的相关性以及过时/生成内容带来的变更风险。
判断:
Fit:good / mixed / poor,附带一个原因。Risk:low / medium / high,附带影响范围。Proof:current CI,local repro,failing test,live E2E,or missing proof。Blocker:first-time contributor CI approval, failing check, missing key, unclear product direction, stale branch, untrusted/broad diff, no repro, conflicts。Next:approve CI, run test, request repro, split PR, patch locally, merge after green, close with proof, or defer。
快速队列图谱
仅在范围为广泛时使用此功能。从仓库级别的队列图谱开始。这会找到具有开放 Issues 和/或 PRs 的仓库并给出计数。
PR 队列,主要分类顺序:
repobar_cmd repos \
--scope all \
--only-with work \
--owner steipete \
--owner openclaw \
--sort prs \
--json
Issue 压力,当 Issues 重要时第二遍:
repobar_cmd repos \
--scope all \
--only-with work \
--owner steipete \
--owner openclaw \
--sort issues \
--json
仅当用户说 "all"、"everything" 或要求考古时才使用 --forks 和 --archived。默认分类应省略 forks 和归档仓库,除非它们的队列特别相关。
对于紧凑的终端视图:
repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --plain
有用的 jq 摘要:
repobar_cmd repos --scope all --only-with work --owner steipete --owner openclaw --sort prs --json |
jq -r '.[] | [.fullName, .openIssues, .openPulls, .activityTitle, .activityActor] | @tsv'
当总结按 PR 排序的队列时,保留 RepoBar 的 PR 数量顺序。不要在来自同一所有者的范围中包含 PR 较少的仓库而忽略 PR 较多的仓库。有开放 PR 但零 Issue 的仓库,例如 openclaw/crabbox,仍然与分类相关。
详细检查
在广泛的队列图谱之后,仅检查顶部仓库,除非用户明确要求详尽细节。
repobar_cmd issues <owner/name> --limit 50 --json
repobar_cmd pulls <owner/name> --limit 50 --json
repobar_cmd ci <owner/name> --limit 20 --json
repobar_cmd activity <owner/name> --limit 20 --json
对于看起来可合并或可疑的 PR,切换到 gh 进行维护者级状态检查:
gh pr view <n> --repo <owner/name> --json number,title,state,author,isDraft,mergeStateStatus,reviewDecision,statusCheckRollup,updatedAt,url
gh pr diff <n> --repo <owner/name> --patch
gh run list --repo <owner/name> --branch <branch> --limit 10
对于可能已经修复的 Issues,切换到 gh issue view,然后在评论或关闭之前检查当前源代码。
对于 OpenClaw/ClawdBot 队列,在有用时使用 OpenClaw 维护者检查:
- 使用
gitcrawl(如果可用)搜索重复/相关线程; - 使用活动帮助脚本识别打开者/作者身份;
- 抑制顶级维护者噪音,除非用户要求查看维护者拥有的工作;
- 优先处理具有清晰证据的外部/用户报告的 bug 和 PR。
本地交叉检查
当任务提到本地项目状态、脏仓库或“我在这里拥有什么”时使用此功能。
repobar_cmd local --root "$HOME/Projects" --depth 1 --limit 200 --plain
repobar_cmd local --root "$HOME/Projects" --depth 1 --sync --limit 200 --json
除非用户明确要求,否则不要运行破坏性的本地操作(local reset、分支删除、签出移动)。
Triage 启发式规则
优先级顺序:
- PRs 具有绿色或接近绿色的 CI、最近的维护者活动、或低风险的依赖/文档/测试变更。
- 开放 PR 数量高但近期有活动的仓库,因为它们通常隐藏着明显的清理工作。
- 可重现、最近报告或阻塞发布的 Issues。
- 安全、发布、认证、安装、CI 和数据丢失报告。
…