用途:在推送代码前检测本地与 CI 环境的依赖不匹配,避免因环境差异导致的 CI 失败和长时间调试。
主要能力:收集本地 Python 与工具版本(如 ruff、black、pyright、mypy)及 pre-commit 钩子版本;读取 CI 配置(.github/workflows/ci.yml、pyproject.toml、.pre-commit-config.yaml);生成本地与 CI 的对比表并标记 MISMATCH/OK;针对每处不匹配给出可执行修复建议,如用 pyenv 匹配 CI 版本、固定工具版本、运行 pre-commit autoupdate;在用户请求时可自动修复并暂存更改。
使用方式:激活后按五步执行——收集本地环境、读取 CI 配置、对比环境、生成建议、按需自动修复。常用命令包括 python --version、pip show、cat .pre-commit-config.yaml、pre-commit autoupdate、pip install ruff==<版本>、pre-commit run --all-files。
适用场景:出现“本地通过但 CI 失败”、长时间开发后推送前、更新本地 Python 或工具后、加入新项目时。
限制:仅负责检测与对比,修复委托给 fix-agent、pre-commit-diagnostic、ci-diagnostic-workflow;CI 已稳定通过、环境刚同步或仅改文档时无需使用。具体收费、平台支持等信息暂未提供。