GitHub Actions Stale最佳实践：避免误关活跃Issues的10个技巧

【免费下载链接】stale Marks issues and pull requests that have not had recent interaction 项目地址: https://gitcode.com/gh_mirrors/stal/stale

GitHub Actions Stale是一款自动化管理Issues和Pull Requests的强大工具，能够帮助开发者自动标记和关闭长时间未活跃的议题。然而，错误配置可能导致误关重要讨论或活跃开发中的PR。本文将分享10个实用技巧，帮助你精准配置Stale Action，既保持仓库整洁又避免误操作。

1. 合理设置 stale 时间阈值 ⏱️

Stale Action的核心配置是闲置时间阈值，默认60天标记 stale、7天后关闭。建议根据项目类型调整：

• 活跃项目：可缩短至30天标记，14天关闭
• 维护型项目：可延长至90天标记，30天关闭

配置示例（在action.yml中设置）：

days-before-stale: 30
days-before-close: 14

通过 action.yml 文件可查看所有可配置参数，包括针对Issues和PR的独立设置（days-before-issue-stale和days-before-pr-stale）。

2. 配置标签豁免规则 🏷️

为避免标记关键议题，可通过标签豁免功能排除特定类型的Issues/PR：

• 核心功能标签：如"enhancement"、"bug"
• 进行中标签：如"in-progress"、"work-in-progress"
• 重要标签：如"security"、"pinned"

配置示例：

exempt-issue-labels: "enhancement,security,pinned"
exempt-pr-labels: "work-in-progress,blocked"

通过 action.yml 中的 exempt-issue-labels 和 exempt-pr-labels 参数设置，支持逗号分隔多个标签。

3. 保护有里程碑的议题 🎯

已规划到里程碑的议题通常是近期需要处理的，应排除在Stale规则之外：

exempt-all-milestones: true

或针对Issues和PR分别设置：

exempt-all-issue-milestones: true
exempt-all-pr-milestones: true

这项配置在 action.yml 的第79-90行有详细说明，确保里程碑内的工作不会被误标记。

4. 豁免指定负责人的议题 👥

已分配负责人的议题通常在处理中，可通过以下配置豁免：

exempt-all-assignees: true

或指定特定负责人：

exempt-assignees: "john-doe,jane-smith"

通过 action.yml 的 exempt-all-assignees 和 exempt-assignees 参数，确保有人负责的议题不会被自动关闭。

5. 启用更新重置机制 🔄

当议题有新评论或更新时，应重置Stale计时器：

remove-stale-when-updated: true

这项默认启用的功能（action.yml 第119-122行）可确保活跃讨论的议题不会被错误标记。对于特殊场景，还可通过 remove-issue-stale-when-updated 和 remove-pr-stale-when-updated 进行更精细的控制。

6. 保护草稿PR 📝

草稿PR通常处于未完成状态，应排除在Stale规则之外：

exempt-draft-pr: true

通过 action.yml 第175-178行的配置，可避免标记尚在开发中的PR，给开发者足够的完善时间。

7. 使用调试模式测试配置 🧪

首次配置时，建议启用调试模式验证规则效果：

debug-only: true

此模式（action.yml 第131-134行）会运行所有检查但不执行实际操作，通过日志确认配置是否符合预期后再关闭调试模式。

8. 精细控制操作频率 ⚙️

为避免触发GitHub API速率限制，可限制每次运行的操作数量：

operations-per-run: 50

默认值为30（action.yml 第115-118行），可根据项目规模调整，大型项目建议设为50-100，小型项目可保持默认。

9. 定制 stale 消息提升友好度 💬

默认消息可能显得生硬，建议定制更友好的提示：

stale-issue-message: >
  您好！这个议题已经有30天没有活动了。
  如果仍需要关注，请在7天内回复，否则将自动关闭。
  感谢您的贡献！

通过 action.yml 的 stale-issue-message 和 stale-pr-message 参数，可分别定制Issues和PR的提醒消息，提升社区体验。

10. 定期审查和优化规则 🔍

项目生命周期中需求会变化，建议：

• 每季度审查Stale规则配置
• 根据议题处理周期调整时间阈值
• 新增标签时同步更新豁免列表
• 通过 tests/operations-per-run.spec.ts 中的测试用例验证复杂场景

通过以上10个技巧，你可以构建既自动化又人性化的Stale管理流程，让GitHub仓库保持整洁的同时，避免误关重要议题。记住，好的自动化规则应该是隐形的助手，而非阻碍协作的障碍。

要开始使用GitHub Actions Stale，可克隆仓库：

git clone https://gitcode.com/gh_mirrors/stal/stale

然后根据本文建议配置 action.yml 文件，打造适合你项目的自动化管理方案。

【免费下载链接】stale Marks issues and pull requests that have not had recent interaction 项目地址: https://gitcode.com/gh_mirrors/stal/stale