gitlink-contributor

一个贡献者致谢与成长的 GitLink AI Agent Skill。基于仓库贡献者数据，生成 all-contributors 风格的致谢墙、贡献排行榜、徽章体系与成长档案，让开源项目的每一份贡献都被看见。

GitLink 智能化服务开源项目贡献赛 子赛题二（编写和丰富 GitLink Skills） 参赛作品。本作品对应赛题示例中点名的「贡献者成长体系」方向。

作者：Ct201314

它解决什么

开源项目靠社区贡献成长，但贡献者的付出常常缺少被看见、被激励的机制。gitlink-contributor 把”致谢与激励”自动化：

• 致谢墙：all-contributors 风格的 Markdown 表格，含头像链接与贡献次数，可直接贴进 README
• 排行榜：按贡献量排序，金银铜牌 + 贡献占比
• 徽章体系：5 级徽章（🌱 贡献者 → 🏆 核心维护者），按贡献次数自动授予
• 成长档案：分层分布 + 临近晋级提示，帮助社区运营精准激励

安装

作为 Agent Skill

把 SKILL.md 与 scripts/ 放入 Agent 技能目录（Claude Code、Cursor、Kiro CLI 等），向 Agent 提出诉求即可触发，例如：

「帮 Gitlink/gitlink-cli 生成一个贡献者致谢墙」

直接运行脚本

# 完整内容
python scripts/contributor.py --owner Gitlink --repo gitlink-cli

# 只要致谢墙
python scripts/contributor.py --owner Gitlink --repo gitlink-cli --section wall

目录结构

gitlink-contributor/
├── SKILL.md
├── scripts/
│   ├── glapi.py                  GitLink 公开 API 客户端（自包含）
│   └── contributor.py            致谢与成长脚本
├── examples/                     真实致谢墙 + 排行榜 + 成长档案
├── tests/test_contributor.py     单元测试（14 个用例）
├── requirements.txt
└── LICENSE

真实验证

在 Gitlink/gitlink-cli 上运行，为 20 位真实贡献者生成致谢墙与排行榜（tigerwang 以 112 次贡献居首），产物见 examples/。

单元测试：

python -m pytest tests/ -q   # 14 passed

设计要点

• all-contributors 风格：致谢墙采用社区广泛认可的多列头像表格形式，观感专业。
• 激励导向：徽章体系与”临近晋级”提示，把贡献数据转化为可激励社区的行动建议。
• 只读 + 本地生成：致谢墙仅生成到本地，写入仓库 README 由用户确认执行。

许可证

Mulan PSL v2，与 gitlink-cli 主仓库保持一致。