Community研究与数据分析github.com

steipete/github-project-triage

GitHub 问题/PR 分类:队列、CI、阻塞项、风险、证据、下一步行动。

github-project-triage 是什么?

此技能专为 AI 代理(如 Claude Code、Cursor 或 Codex)设计,用于执行 GitHub 仓库的维护者级别问题(Issue)和拉取请求(PR)分类。它优先处理与 AI 工具直接交互的场景,例如当用户输入“triage”时自动激活。技能功能涵盖:基于仓库的队列概览、逐项风险评估、信任信号评估、产品适配度判断(依据 VISION.md)、可自主处理的工作项识别,以及后续操作建议。支持使用 RepoBar 工具进行快速队列发现,也支持使用 gh CLI 进行深入维护者操作。输出格式强调以 URL 为先,每个项目的第一行必须包含其 GitHub 链接,并给出明确的分类标签:可自主处理、需等待决策、或应推迟/关闭。该技能还包含一套完整的自主工作流程,允许代理在没有人工干预的情况下依次处理多个问题或 PR,并在每个步骤中进行本地验证、运行 Codex Auto Review、确保 CI 通过,然后提交或关闭。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/github-project-triage

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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。

永远不要同时处理多个工单。对于每个项目:

  1. 阅读 Issue/PR、相关代码、文档、CI 和 VISION.md(如果存在);使用 Google/官方文档处理事实可能过时或不明确的情况。
  2. 判断是否可自主处理:
    • Go:性能改进(除非复杂度增加过多);有重现/根因和验证路径的 bug 修复;小的 UI/UX 调整;文档修复;狭窄的测试/内部修复;低风险的依赖/CI 清理并有绿色证据。
    • Ask first:新功能、产品/愿景选择、广泛行为变更、高风险依赖、无强证据的安全敏感变更、无可用凭据的实时供应商工作、任何无法端到端测试的内容。
    • 重构偏好:当对于自主项目来说重构是更好的修复时,选择干净有界的方式;不要默认使用“小补丁”如果它留下更差的设计。
  3. 以最佳可维护方式实现或修复 PR。当可写入时优先更新贡献者 PR;否则在本地重建并注明来源。
  4. 尽可能进行本地验证和实时端到端测试。对于 UI 行为,使用仓库预期的实时 UI 验证路径,如 Peekaboo、browser-use、截图或 VM 证据。对于 API/供应商行为,尽可能使用真实的可用密钥/账户通过预期的秘密工作流。如果缺少访问权限,在假装项目完成之前停止并请 Peter 帮助。
  5. 在提交/着陆前运行 Codex Auto Review,除非是琐碎/仅文档或被明确跳过;处理可接受/可操作的发现。
  6. 确保 CI 变绿、PR 描述/更新日志良好、着陆/关闭/评论并附上证据,然后返回 main,拉取 --ff-only,验证干净的工作树,再选择下一个自主项目。
  7. 在每个着陆的 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 和数据丢失报告。

…

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

相关技能