Hive 集成赏金计划「Game Master 运营手册」:维护者从受理、审核、晋升到反作弊的全流程实战指南

原创2026-09-23 11:30:531,704 阅读
文章标签:人工智能AI AgentAgent 框架多智能体大模型Agent 编排工具调用Agent 记忆

Hive 集成赏金计划「Game Master 运营手册」:维护者从受理、审核、晋升到反作弊的全流程实战指南

本文是 Hive(Multi-Agent Harness for Production AI)开源仓库中 docs/bounty-program/game-master-manual.md 的深度解读版,面向运行集成赏金计划(Integration Bounty Program)的维护者(Maintainer / Game Master)。手册定位为“运营操作手册”,覆盖维护者的完整职责闭环:发布赏金并定价、受理领取(Claim)、审核合并 PR、把关质量门禁、拒绝低质量提交、晋升 Core Contributor、执行反作弊处罚以及维持赏金池活跃。读完本文,你将掌握这套赏金体系在 Hive 仓库中的具体运营动作、每个 bounty:* 标签对应的质量验收标准,以及 PR 合并后 XP 自动发放背后的 GitHub Actions + Lurkr 自动化链路源码。

一、Game Master 的角色定位:维护者 = 赏金计划的运营者

在 Hive 的赏金体系里,维护者扮演的是“Game Master”(游戏主持人)角色。与普通贡献者不同,Game Master 不负责完成赏金,而是负责让整张赏金棋盘正常运转。手册明确了以下五项核心职责:

  • 发布赏金 Issue 并为 Core Contributor 设定美元金额(Post bounty issues and set dollar values);
  • 把被认领的赏金分配给贡献者(Assign claimed bounties to contributors);
  • 审核并合并赏金 PR(合并会触发 GitHub Action 自动授予 XP 并推送 Discord 通知);
  • 管理 Core Contributor 角色(晋升与移除都由维护者手动执行,因为该角色涉及金钱);
  • 监控刷量(Gaming)与低质量提交,保证赏金池不被滥用。

这套体系在整个赏金计划中的位置,可以参照 docs/bounty-program/README.md:赏金计划由三份文档共同定义——Setup Guide(从零搭建,面向管理员)、Contributor Guide(面向贡献者)与本文解读的 Game Master Manual(面向维护者运营)。三者分工清晰:Setup Guide 回答“系统怎么建起来”,Contributor Guide 回答“贡献者怎么参与”,Game Master Manual 回答“维护者怎么运营好它”。

二、受理赏金领取(Bounty Claims):三种难度三种处置

当贡献者在 Issue 下评论 “I'd like to work on this” 时,维护者按下述规则处置:

  1. difficulty:easy:直接分配(assign immediately)。这类赏金定位为“Good First Contribution”,风险低、门槛低,无需额外考察。
  2. difficulty:medium / difficulty:hard:先核查该贡献者是否已完成过更简单的赏金(check if they've done easier bounties first),避免新手直接扑向高难度任务导致烂尾。
  3. 分配动作在 GitHub 上完成;若分配后 7 天内未提交 PR,维护者应取消分配并重新开放该赏金(unassign and re-open)。

难度标签体系由 scripts/setup-bounty-labels.sh 一次性创建,共 3 个难度标签:

标签 颜色 含义
difficulty:easy #BFD4F2 适合首次贡献
difficulty:medium #D4C5F9 需要一定熟悉度
difficulty:hard #F9D0C4 需要显著投入或专业技能

7 天窗口并非孤例:贡献者侧规则(docs/bounty-program/contributor-guide.md)同样写明“no PR within 7 days = bounty gets re-opened”,并且限制每位贡献者最多同时持有 3 个活跃认领(Max 3 active claims),防止囤积。维护者在受理时应同步核对这两条规则。

三、PR 审核主流程:六步闭环

收到赏金 PR 后,维护者按以下顺序执行(这是手册给出的标准动作序列):

  1. 验证 PR 与赏金 Issue 匹配(Verify the PR matches the bounty issue)——防止“挂羊头卖狗肉”,用其他改动冒领赏金;
  2. 检查质量门禁(Check quality gates)——详见下文第四、五节的两套清单;
  3. 交叉审核:批准者必须是创建该赏金之外的另一位维护者(A different maintainer must approve than the one who created the bounty),杜绝自我背书;
  4. 合并前为 PR 打上正确的 bounty:* 标签(Apply the correct label before merging)——这一步是 XP 自动发放的触发开关,见第十一节源码剖析;
  5. 合并 PR——GitHub Action 自动授予 XP 并推送 Discord 通知(Merge — the GitHub Action auto-awards XP and posts to Discord);
  6. 关闭关联的赏金 Issue(Close the linked bounty issue)。

需要特别强调第 4 步的时序:标签必须在合并之前打在 PR 上。从 .github/workflows/bounty-completed.yml 的触发条件可以看出,工作流监听的是 pull_request_target 的 closed 事件,并要求 github.event.pull_request.merged == true 且 PR 标签列表中包含 bounty: 前缀。也就是说,如果合并时 PR 上没有 bounty:* 标签,整条 XP 链路根本不会触发。

四、质量门禁(一):Integration Bounties 验收清单

集成类赏金围绕工具生态展开,手册为四类标签分别定义了可勾选的验收清单。

bounty:docs(写文档,20 XP):

  • ] 遵循 [tool README 模板(Tool README Template);
  • [ ] 配置说明准确(API key 的获取 URL 真实可用);
  • [ ] 函数名与实际代码一致;
  • [ ] 未经核验的 AI 生成内容不予通过。

bounty:test(用真实 API Key 测试工具,20 XP):

bounty:code(健康检查器 / Bug 修复 / 集成改进,30 XP):

  • [ ] CI 通过(健康检查相关使用 uv run pytest tools/tests/test_credential_registry.py);
  • [ ] 修复针对根因而非表象(Fix addresses root cause, not symptom);
  • [ ] Bug 修复必须附带新增测试(New test added for bug fixes)。

bounty:new-tool(从零构建完整集成,75 XP):

  • [ ] 完整实现:工具 + 凭据规格(Credential Spec)+ 测试 + README;
  • [ ] make check && make test 全部通过;
  • [ ] 注册在 _register_unverified()(未验证区),而非直接进已验证区。

后两条与仓库源码直接对应:bounty:code 提到的 uv run pytest tools/tests/test_credential_registry.py 对应仓库中的 tools/tests/test_credential_registry.py;bounty:new-tool 提到的 _register_unverified() 位于工具注册入口 tools/src/aden_tools/tools/init.py(参见 docs/bounty-program/promotion-checklist.md 的定位说明)。从源码结构可以推断,工具注册表按“未验证 / 已验证”分区存放,bounty:new-tool 交付物默认进入未验证区,待通过 Promotion Checklist 后再由维护者移动到 _register_verified()。

五、质量门禁(二):Standard Bounties 验收清单

标准类赏金按工作量与影响力分级(docs/bounty-program/README.md 中定义的四种尺寸),手册为每一级给出了验收标准。

bounty:small(小修,10 XP):

  • [ ] 改动正确且不引入回归;
  • [ ] CI 通过;
  • [ ] 范围符合“small”——不得把更大的改动塞进小赏金里(not padded into a bigger change)。

bounty:medium(中等,30 XP):

  • [ ] CI 通过;
  • [ ] Bug 修复附带回归测试(regression test);
  • [ ] 文档/指南准确且遵循现有风格;
  • [ ] 未经核验的 AI 生成内容不予通过。

bounty:large(大型,75 XP):

  • [ ] 实现前已在 Issue 中讨论过设计(Design was discussed in the issue before implementation);
  • [ ] CI 通过,新增测试覆盖改动;
  • [ ] 性能类工作必须附带基准测试(benchmarks,before/after);
  • [ ] 架构文档须经第二位维护者审阅。

bounty:extreme(极限,150 XP):

  • [ ] 动手前维护者已预先批准设计提案(Maintainer pre-approved the design proposal);
  • [ ] CI 通过,测试覆盖全面;
  • [ ] 文档已同步更新以反映改动;
  • [ ] 至少两位维护者审阅(Reviewed by at least two maintainers)。

可以观察到一条递进规律:从 medium 开始强制要求回归测试,从 large 开始要求“先讨论设计再动手”与基准数据,到 extreme 则升级为“双维护者审阅 + 预批准”,质量门槛随金额与 XP 呈阶梯式上升。

六、拒绝提交(Rejecting Submissions)的规范

拒绝不是终点,而是协作的延续。手册给出的标准动作:

  1. 给出具体、有建设性的反馈(Leave specific, constructive feedback)——指出问题而非笼统否定;
  2. 请求修改而非关闭 PR(Request changes, don't close the PR)——给贡献者修复机会;
  3. 留出 7 天修改窗口,超时无响应 → 关闭 PR、解除赏金分配。

最后一条原则被手册单独强调并加粗:“Never merge low-quality work just to be nice.”(永远不要因为人情而合并低质量工作)。这既是对贡献者时间的尊重(有建设性反馈),也是对项目质量的守护。结合 docs/bounty-program/contributor-guide.md 的规则可知,贡献者侧同步约束了“no self-review”(禁止自我审核)与“no AI-only submissions without verification”,维护者在拒绝时也应据此说明理由。

七、Core Contributor 晋升机制:高门槛、高回报

Core Contributor 是唯一解锁金钱奖励的层级,因此手册明确“The bar must be high”(门槛必须高)。

满足以下条件才可晋升(Promote when):

  • 活跃 4 周以上;
  • 贡献覆盖 3 种以上赏金类型(contributions across 3+ bounty types);
  • PR 一贯干净整洁(PRs are consistently clean);
  • 至少一位维护者为其背书(At least one maintainer vouches for them)。

晋升动作(How): 与维护者团队讨论 → 在 Discord 分配角色 → 在 #integrations-announcements 频道公告 → 将其加入 #bounty-payouts 频道(该频道仅 Core Contributor 可见,用于金额发布与支付记录)。

不要晋升(Don't promote)的情况: 只做 easy 赏金、活跃不足 4 周、或表现出刷量迹象。

失活处理: Core Contributor 若 8 周以上不活跃,先私聊联系,无回应再移除角色(reach out privately first, then remove the role if no response)。

对照 docs/bounty-program/README.md 的三级体系可见完整晋升路径:Agent Builder(约 500 XP / Lurkr 5 级)与 Open Source Contributor(约 2000 XP / Lurkr 15 级)由 Lurkr 机器人自动分配,唯独 Core Contributor 是纯人工决策——因为它直接绑定真金白银,自动化在这里被刻意排除。

八、美元价值体系(Dollar Values):金额表与支付流程

金额只在 Discord 的 #bounty-payouts 频道发布,仅限 Core Contributor 可见。

集成类赏金(Integration bounties):

赏金类型 美元区间
bounty:test $10–30
bounty:docs $10–20
bounty:code $20–50
bounty:new-tool $50–150

标准类赏金(Standard bounties):

赏金类型 美元区间
bounty:small $5–15
bounty:medium $20–50
bounty:large $50–150
bounty:extreme $150–500

支付流程(Payout): PR 合并 → 核验质量(verify quality)→ 在 #bounty-payouts 记录 → 处理付款。

手册特别强调一条设计原则:“XP is always awarded regardless of budget. Money is a bonus layer.”——XP 不受预算限制、始终发放(由 scripts/bounty-tracker.ts 中的点数映射自动计算,见第十一节),金钱只是叠加在 XP 之上的奖励层。这保证了赏金体系在预算紧张时依然能持续运转并积累积分数据。

九、反作弊(Anti-Gaming):模式识别与三级处罚

手册用一张“模式 → 应对”表定义了最常见的作弊形态:

作弊模式 应对措施
把一个改动拆成多个 PR(Splitting one change across multiple PRs) 拒绝多余 PR,发出警告(Reject extras, warn)
未经核验的 AI 生成提交(AI-generated without verification) 拒绝并说明原因(Reject, explain why)
认领大量赏金却很少完成(Claiming many, completing few) 7 天后解除分配(Unassign after 7 days)

处罚采用阶梯制:初犯警告 → 再犯停权 2 周(2-week cooldown)→ 三次永久移除(permanent removal)。

这条规则与前面“拒绝低质量提交”形成组合拳:拒绝环节解决单次质量问题,反作弊机制解决系统性的刷量行为。维护者在审核时可结合贡献者的认领历史(活跃认领数、完成率)来判断是否属于“Claiming many, completing few”模式。

十、保持赏金池新鲜(Keeping It Fresh)

运营的持续目标是让赏金池保持吸引力与流动性,手册给出四条操作性建议:

  • 随时保持 10+ 个无人认领的赏金(Aim for 10+ unclaimed bounties at all times);
  • 定期解除过期认领(超过 7 天无 PR 的认领,Unassign stale claims);
  • 在公告频道为杰出贡献点名致谢(Shoutout exceptional contributions in announcements);
  • 发布里程碑(例如“第 10 个工具晋升为 verified!”——Post milestones)。

其中“10+ 无人认领”与“55-Tool Blitz”启动计划(见 docs/bounty-program/README.md 与 docs/bounty-program/setup-guide.md)直接呼应:仓库中 55 个未验证工具面临“缺 README(约 41 个)、缺健康检查端点(约 40 个)、缺社区测试报告(55 个)”三类缺口,正是靠批量发布赏金来填充的。维护者日常职责就是维持这类供给侧的“货架陈列”。

十一、自动化引擎源码剖析:XP 是如何“自动到账”的

手册中反复提到“Merge — the GitHub Action auto-awards XP and posts to Discord”,这条自动化链路在仓库源码中可以被完整还原,维护者理解它有助于排障与设计新赏金类型。

触发端: .github/workflows/bounty-completed.yml 监听 pull_request_target 的 closed 事件,合并条件为 merged == true 且 PR 标签包含 bounty: 前缀;同时支持 workflow_dispatch 手动补发(为“漏发”的赏金提供 pr_number 输入,对应手册里“自动处理漏发”的运营场景)。工作流注入的环境变量包括 GITHUB_TOKEN、DISCORD_BOUNTY_WEBHOOK_URL、BOT_API_URL、BOT_API_KEY、LURKR_API_KEY、LURKR_GUILD_ID 等(这些 Secret 的配置方式见 docs/bounty-program/setup-guide.md 第 6 步)。

计算端: scripts/bounty-tracker.ts 内置与文档完全一致的 POINTS 映射表(第 69–80 行),可作为核对各标签点数的权威来源:

标签 点数
bounty:test 20
bounty:docs 20
bounty:code 30
bounty:new-tool 75
bounty:small 10
bounty:medium 30
bounty:large 75
bounty:extreme 150

脚本提供两种运行模式(与两个工作流一一对应):notify(由 bounty-completed.yml 调用,处理单个已完成赏金并推送 Discord 通知)与 leaderboard(由 .github/workflows/weekly-leaderboard.yml 调用,生成每周排行榜)。从源码可以推断,脚本通过 GitHub API 读取 PR 的 labels 与 user,结合 MongoDB 中 hive.contributors 集合完成 GitHub ↔ Discord 身份映射,再调用 Lurkr API 推送 XP——这与 docs/bounty-program/README.md 描述的“bounty-tracker.ts → 计算点数 → 解析身份 → 推送 XP → 发通知”流水线一致。

身份前提: 贡献者必须在 Discord 执行 /link-github 完成 GitHub ↔ Discord 绑定(通过公共 gist 验证所有权),否则赏金仍会被记录,但 Lurkr 无法向其 Discord 账户推送 XP——这也是维护者在排查“合并后没有 XP 到账”时的首要检查项(docs/bounty-program/setup-guide.md 的 Troubleshooting 章节给出了同样的排查顺序:检查 Webhook Secret → 检查 API Key 是否为 Read/Write → 检查贡献者是否已 /link-github → 检查 Action 日志中的 Lurkr XP push failed)。

标签底座: 整个体系依赖 scripts/setup-bounty-labels.sh 一次性创建的全部 11 个标签(4 个集成赏金 + 4 个标准赏金 + 3 个难度标签),脚本使用 gh label create --force 幂等创建,可安全重复执行。

十二、进一步阅读:运营相关的仓库文档地图

适用范围说明:本文所有流程、点数、金额区间与自动化行为均以当前仓库内容为准。其中美元金额发布在 Discord 私密频道 #bounty-payouts、由维护者人工执行;XP 计算与排行榜则由 GitHub Actions 自动化完成。若你的仓库结构或标签体系与 Hive 不同,需要相应调整标签命名与工作流配置。

登录后查看全文
hive