GitHub 自动化组织维护方案：Evergreen

背景：共享组织的维护困境

在共享型组织（Shared Org）中，管理外部协作者是一项繁琐且容易被忽视的工作。随着项目迭代，权限变更频繁，而仓库一旦完成使命，往往缺乏及时归档。对于维护者来说，手动追踪每一位协作者的截止日期和跟进情况，随着项目规模扩大，很快就会变成难以完成的任务。

GitHub 团队内部同样面临这一挑战：员工需要与客户及合作伙伴共同进行产品试用和专业服务。为了解决这个问题，他们开发了一款名为 Evergreen 的 GitHub 应用，旨在通过自动化手段维持组织的“生态健康”。

核心工作流与设计原则

Evergreen 的核心功能主要包含两大类：外部协作者权限审查和仓库存活检测与归档。

1. 外部协作者权限审查

每季度，系统会自动审查所有仓库的外部协作者。维护者可以选择保留必要的人员，其余人员将被移除。

2. 仓库存活检测与归档

对于超过特定时间阈值没有人类活动（如提交、Issue、Pull Request）的仓库，系统会先标记警告，若仍无动静则自动归档。

设计原则：

• Fail Secure（默认安全）： 如果协作者审查未得到回应，系统默认不保留权限，而是直接撤销。这是最安全的结果。
• Never Destroy（永不破坏）： Evergreen 永远不会删除仓库或其内容。归档后的仓库是可恢复的，且每一次权限变更都会记录在仓库的追踪 Issue 中，方便误操作回滚。

技术实现：以 Git 为中心

虽然 Evergreen 的后端是一个运行在容器中的小规模 Go Webhook 服务器，但其精妙之处在于编排。它不依赖任何外部服务，完全基于 GitHub 的原生特性构建，包括 GitHub App、定时任务、Webhook、Issue 和文件系统。

1. 控制器与时间轴

Evergreen 拥有一个专门的“控制器”仓库，充当其“大脑”和“时钟”。它利用四个定制的 GitHub Actions 工作流，按照严格的日历周期触发事件：

• 第 1 天： 存活检测审查。标记无近期活动仓库，打开警告 Issue。
• 第 8 天： 权限审查。快照当前协作者列表，为每个仓库打开检查清单 Issue。
• 第 16 天： 存活检测清理。对仍处于警告状态的仓库执行归档。
• 第 23 天： 权限清理。自动撤销那些在审查期内未得到回应的访问权限。

所有工作流都预留了 workflow_dispatch 手动触发接口，方便在紧急情况下干预。

2. 状态追踪与审计

Evergreen 将每个仓库的状态以 JSON 文件的形式保存在控制器仓库的 state/repos/ 目录下。这不仅记录了谁拥有权限、审查何时开启、截止日期、谁做出了决定，还记录了所有操作历史。

Git 历史即审计日志：

由于状态数据存储在 Git 仓库中，每一次状态变更都对应一次 Commit。开发者可以通过 git log 轻松追溯历史记录。例如，想知道某人去年什么时候失去了访问权限？只需查看对应状态文件的 Git 历史。这种设计省去了建立独立数据库或自定义审计管道的复杂度，极大地简化了维护工作。

实用建议

对于开发者和管理员，Evergreen 提供了一个极佳的模板。你可以直接复制这套基于 GitHub 原生功能的自动化方案，适配到你自己的团队中，从而解决“权限遗忘”和“僵尸仓库”带来的安全与空间占用问题。