SIMON-WORLD/github-multiagent-contributor

中文 | English
一套面向 GitHub 仓库的**多智能体贡献者方案**：让 Codex、Claude 及其他可验证的 Agent / Bot，以可追溯的共同作者身份进入 Contributors 页面；并配套每日自动 Check-in 与真实 PR 协作两种模式。
核心能力
| 能力 | 说明 | 人工 Review |
| --- | --- | --- |
| 🔁 自动 Check-in | 每日写入一条透明活动记录，携带配置的共同作者尾注 | 默认不需要 |
| 🤝 真实 PR 协作 | Agent 在独立分支完成开发、文档或测试，通过 PR 合并 | 按风险决定 |
| 📦 一键接入 | 任意 Agent 一条命令把贡献者套件装入目标仓库 | 合并时确认 |
快速开始（给任意仓库加贡献者身份）
任何 Agent（Codex / Claude Code / Gemini CLI / Cursor 等）都可在目标仓库内执行：
text
python scripts/build_contributors.py --list # 查看全部身份
python scripts/build_contributors.py --tools codex,renovate # 选择任意组合
python scripts/build_contributors.py --bots # 全部真实 Bot 账号
python scripts/build_contributors.py --all # 全部身份
python scripts/build_contributors.py --remove --tools renovate # 移除身份（停止再新增）
python scripts/build_contributors.py --check --tools codex # 验证是否已进入提交
text
定时运行
→ 更新 activity/agent-checkins.csv（每个日期最多一条）
→ 创建自动提交
→ 写入配置的 Co-Authored-By 尾注
→ 贡献记录进入默认分支
text
AGENT_CHECKIN_ENABLED=true
AGENT_CHECKIN_AUTHORS=Codex ;Claude
text
Issue 定义目标与验收标准
→ Agent 创建独立分支
→ 修改代码、文档或测试
→ 创建 Pull Request
→ GitHub Actions 自动检查
→ 按风险决定是否 Review
→ 维护者确认并合并
日常小修复可由主维护者直接处理；重大功能、架构调整、数据变更与正式发布，建议要求其他 Agent 或人类协作者 Review。
应用到已有仓库
- **只加贡献者身份**：使用上文「快速开始」的一条命令即可，无需复制整套模板。
- **完整协作流程**：需要 Issue→PR→CI→Review 全套时，再复制 AGENTS.md、Issue/PR 模板、tests.yml、邮箱/卫生门禁脚本与 tests/。
Contributor 归属规则
Contributor 来自进入默认分支的提交作者归属：
- Agent 的代码提交可通过其真实作者身份归属；
- 人类账号代提交时，可使用真实的 Co-Authored-By` 尾注；
- GitHub App 或 Bot 以其真实身份提交时，可单独出现在 Contributors；
- Issue、评论、Review 或 Actions 运行本身不会自动产生 Contributor。
Contributor 图只是提交归属的结果，不应替代代码质量、测试与人工风险判断。
隐私与安全
本项目不包含 Token、密码、私人数据或个人邮箱。公开仓库接入前，请确认：
- GitHub 邮箱隐私已开启；
- 提交邮箱检查通过；
- Agent 只访问仓库中明确授权的内容；
- 本地数据、未上传的 PDF、桌面软件和私有环境不会被云端 Agent 自动读取；
- 研究结论、数据隐私与发布风险由维护者最终确认。
许可证
本项目采用 MIT License。复制或改造时请保留许可证声明。