用途:在推送代码前检测本地环境与 CI 环境的依赖不匹配,防止因版本漂移导致的 CI 失败和 20-45 分钟调试周期。它填补了现有工具只在问题发生后修复的空白,属于推送前预防。
主要能力:收集本地 Python 版本、已安装工具(ruff、black、pyright、mypy)版本及 pre-commit 钩子版本;读取 CI 配置(.github/workflows/ci.yml、pyproject.toml、.pre-commit-config.yaml)提取 CI Python 版本与所需工具版本;生成对比表并标记 MISMATCH/OK;针对每处不匹配给出可操作修复命令,如 pyenv install 3.11、pyenv local 3.11、pip install ruff==0.13.0、pre-commit autoupdate;在用户请求时可自动修复,更新 .pre-commit-config.yaml、运行 pre-commit autoupdate、重新生成 requirements.txt 并暂存更改。
使用方式:激活后自主执行五步——收集本地环境、读取 CI 配置、对比环境、生成建议、按需自动修复。输出为 Dependency Resolver Report,含环境对比表、不匹配数量、建议与快速修复命令。
适用场景:出现“本地通过但 CI 失败”“本地 lint 通过但 CI 不通过”时;长时间开发后推送前;更新本地 Python 或工具后;加入新项目时。
限制:仅负责检测与对比,修复委托给 fix-agent、pre-commit-diagnostic、ci-diagnostic-workflow 等专用代理;CI 已稳定通过、环境刚同步或仅编辑文档时无需使用。具体收费、平台支持与效果数据暂未提供。