用途:修复项目配置与代码卫生问题,减少仓库噪声、保持配置一致、避免隐性失败。主要能力与工作流:
- 清理误入库的备份/制品文件:检测 .bak、.orig、*~,用 git rm --cached 从版本控制移除并追加到 .gitignore,再提交。
- 补全 .gitignore 模式:涵盖编辑器、操作系统、IDE、构建产物、依赖、环境变量、日志、测试覆盖率与缓存等常见条目,提供 Node.js 模板 templates/gitignore-node.txt。
- 修复 Husky prepare 脚本静默失败:避免
husky install || true,改用 CI 环境判断、is-ci 包,或 Husky v9+ 的自动装配方案。 - 收敛 lint:strict 阈值:通过跟踪当前警告数,分周逐步降低 --max-warnings,目标为零容忍;CI 中可做进度检查并在超阈值时失败。
- 消除 ESLint 配置重复:将重复的 plugins/globals/parser 抽取为共享 base 配置,把禁用的规则提取为带注释的命名常量,便于后续渐进恢复。
- 代码卫生修复:为递归目录遍历增加最大深度、最大文件数与已访问路径跟踪以处理循环符号链接;对按关键字构造的正则进行预编译与缓存,并转义特殊字符。
使用方式:提供检测与修复脚本
node scripts/check-config.js、node scripts/fix-gitignore.js,以及模板 templates/gitignore-node.txt、templates/eslint-base.js;流程为识别问题、应用修复、验证副作用、提交变更。 适用场景:Node.js/TypeScript 项目的配置维护、CI 质量门禁与仓库清理。限制:资料未提供支持平台范围、运行环境要求、性能表现与收费信息;部分修复策略需按项目实际情况调整阈值与规则。