Danger JS 拉取请求自动化工具包

解决的工程问题

当团队的评审规范只停留在口头约定时，容易出现两类问题。一是人工评审重复遗漏：同类问题（如接口变更未更新文档、缺少错误处理、命名不符合规范）在不同 PR 里反复出现，评审者疲劳时容易放过。二是反馈标准不一致：不同评审者对同一问题的严重程度判断不同，作者被迫反复修改，甚至怀疑规则到底是否存在。另外，当代码托管平台与评审工具割裂时，反馈散落在评论、私信和 CI 日志里，很难追溯。

核心能力与工作方式

这个工具包的核心是把审查约定转化为可重复的自动化检查。它在 CI 中触发，在代码变更时运行团队自己编写的规则脚本，例如：

• 校验 PR 标题是否符合 feat: xxx / fix: xxx 的格式
• 检查新增文件是否带有对应的单元测试
• 拦截未清理的调试代码，如 console.log 或 print()
• 验证 API 变更是否同步更新了文档

检查完成后，结果以结构化形式发布回代码托管平台的 PR 评论区，用 error / warn 标出级别并给出修改建议，而不是让评审者凭记忆逐行翻找。规则本身的演进依赖外部脚本迭代，不需要改动仓库的业务代码。

适用边界与注意点

• 强依赖 CI 环境，仓库里需要预先配置对应的流水线，例如 GitHub Actions 或 GitLab CI
• 规则脚本由团队自己维护，工具包不内置现成的规则库
• 不适合安全敏感场景的核心链路（如金融交易系统），自动化检查只能作为辅助，关键变更仍需人工评审
• 超大 PR（例如一次合并整个模块）可能明显拉长 CI 耗时，需要配合缓存或分阶段检查策略