Hive 集成赏金计划「Game Master 运营手册」:维护者从受理、审核、晋升到反作弊的全流程实战指南
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” 时,维护者按下述规则处置:
difficulty:easy:直接分配(assign immediately)。这类赏金定位为“Good First Contribution”,风险低、门槛低,无需额外考察。difficulty:medium/difficulty:hard:先核查该贡献者是否已完成过更简单的赏金(check if they've done easier bounties first),避免新手直接扑向高难度任务导致烂尾。- 分配动作在 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 后,维护者按以下顺序执行(这是手册给出的标准动作序列):
- 验证 PR 与赏金 Issue 匹配(Verify the PR matches the bounty issue)——防止“挂羊头卖狗肉”,用其他改动冒领赏金;
- 检查质量门禁(Check quality gates)——详见下文第四、五节的两套清单;
- 交叉审核:批准者必须是创建该赏金之外的另一位维护者(A different maintainer must approve than the one who created the bounty),杜绝自我背书;
- 合并前为 PR 打上正确的
bounty:*标签(Apply the correct label before merging)——这一步是 XP 自动发放的触发开关,见第十一节源码剖析; - 合并 PR——GitHub Action 自动授予 XP 并推送 Discord 通知(Merge — the GitHub Action auto-awards XP and posts to Discord);
- 关闭关联的赏金 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):
- ] 测试报告遵循 [Agent Test Report 模板;
- [ ] 包含日志、Session ID 或截图等证据;
- [ ] 必须使用真实 API Key 完成,不得 mock;
- [ ] 如实报告失败项(Reports failures honestly)。
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)的规范
拒绝不是终点,而是协作的延续。手册给出的标准动作:
- 给出具体、有建设性的反馈(Leave specific, constructive feedback)——指出问题而非笼统否定;
- 请求修改而非关闭 PR(Request changes, don't close the PR)——给贡献者修复机会;
- 留出 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 幂等创建,可安全重复执行。
十二、进一步阅读:运营相关的仓库文档地图
- docs/bounty-program/game-master-manual.md — 本文解读的原始运营手册;
- docs/bounty-program/README.md — 赏金计划总览:三级体系、标签颜色、自动化架构与 55-Tool Blitz 启动计划;
- docs/bounty-program/setup-guide.md — 管理员从零搭建(标签、频道、角色、Lurkr、Secrets、流水线测试);
- docs/bounty-program/contributor-guide.md — 贡献者参与规则(认领、7 天窗口、3 个活跃认领上限);
- docs/bounty-program/promotion-checklist.md — 工具从 unverified 晋升 verified 的完整核验清单;
- docs/bounty-program/templates/tool-readme-template.md 与 docs/bounty-program/templates/agent-test-report-template.md —
bounty:docs与bounty:test的交付物模板; - .github/workflows/bounty-completed.yml、.github/workflows/weekly-leaderboard.yml、scripts/bounty-tracker.ts、scripts/setup-bounty-labels.sh — 自动化链路的四份关键源码/配置;
- tools/tests/test_credential_registry.py —
bounty:code健康检查验收所依赖的回归测试。
适用范围说明:本文所有流程、点数、金额区间与自动化行为均以当前仓库内容为准。其中美元金额发布在 Discord 私密频道
#bounty-payouts、由维护者人工执行;XP 计算与排行榜则由 GitHub Actions 自动化完成。若你的仓库结构或标签体系与 Hive 不同,需要相应调整标签命名与工作流配置。