dependency-resolver by rysweet/amplihack
npx skills add https://github.com/rysweet/amplihack --skill dependency-resolver此技能在推送前检测并解决本地环境与 CI 环境的不匹配问题,防止在 DISCOVERIES.md("CI 故障解决过程分析"条目)中记录的 20-45 分钟调试周期。
该技能解决了一个关键缺口:现有工具(ci-diagnostic-workflow、pre-commit-diagnostic)在问题发生后进行修复。此技能在推送前捕获不匹配。
来自 DISCOVERIES.md 的分析:
激活后,自动执行以下步骤:
# Python version
python --version
# Installed tool versions
pip show ruff black pyright mypy 2>/dev/null | grep -E "^(Name|Version):"
# Pre-commit hook versions (if available)
cat .pre-commit-config.yaml 2>/dev/null | grep -E "rev:|repo:"
Read(file_path=".github/workflows/ci.yml")
Read(file_path="pyproject.toml")
Read(file_path=".pre-commit-config.yaml")
提取:
python-version:)广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
构建比较表:
| 组件 | 本地 | CI | 状态 |
|---|---|---|---|
| Python | 3.12.10 | 3.11 | 不匹配 |
| ruff | 0.12.7 | 0.13.0 | 不匹配 |
| black | 24.3.0 | 24.3.0 | 正常 |
针对每个不匹配,提供可操作的修复方案:
Python 版本不匹配:
# Option A: Use pyenv to match CI version
pyenv install 3.11
pyenv local 3.11
# Option B: Update CI to match local (if local is intentional)
# Edit .github/workflows/ci.yml line 33
工具版本不匹配:
# Pin versions in pyproject.toml
pip install ruff==0.13.0
# Or update pre-commit hooks
pre-commit autoupdate
如果用户请求自动修复:
pre-commit autoupdate与 fix-agent 模板集成,用于:
在版本同步后检测到预提交失败时进行交接。
对于推送前验证未捕获的推送后 CI 故障进行交接。
症状:
修复:
# Check CI Python version
grep -r "python-version" .github/workflows/
# Match locally or update CI
症状:
修复:
# Sync pre-commit hooks to latest
pre-commit autoupdate
# Or pin specific version
pip install ruff==<ci-version>
症状:
修复:
# Install all optional dependencies
pip install -e ".[dev]"
# Ensure requirements.txt is up to date
pip freeze > requirements.txt
## Dependency Resolver Report
### Environment Comparison
| Component | Local | CI | Status |
| --------- | ------- | ------- | -------- |
| Python | 3.12.10 | 3.11 | MISMATCH |
| ruff | 0.12.7 | 0.13.0 | MISMATCH |
| pyright | 1.1.350 | 1.1.350 | OK |
### Mismatches Found: 2
### Recommendations
1. **Python Version** (CRITICAL)
- Local: 3.12.10, CI: 3.11
- Action: Consider using pyenv to test with CI version before push
- Risk: Type syntax differences may cause failures
2. **ruff Version** (WARNING)
- Local: 0.12.7, CI: 0.13.0
- Action: Run `pip install ruff==0.13.0` or `pre-commit autoupdate`
- Risk: New rules may flag previously passing code
### Quick Fix Commands
```bash
# Sync ruff version
pip install ruff==0.13.0
# Update all pre-commit hooks
pre-commit autoupdate
# Re-run pre-commit to validate
pre-commit run --all-files
```
### Status: ACTION REQUIRED
Push may fail due to environment mismatches.
Run recommended fixes before pushing.
触发迹象:
不需要时:
每周安装数
85
仓库
GitHub 星标数
45
首次出现时间
Jan 23, 2026
安全审计
安装于
opencode78
claude-code73
codex72
cursor71
gemini-cli70
github-copilot69
This skill detects and resolves local vs CI environment mismatches BEFORE push, preventing the 20-45 minute debug cycles documented in DISCOVERIES.md ("CI Failure Resolution Process Analysis" entry).
The skill addresses a critical gap: existing tools (ci-diagnostic-workflow, pre-commit-diagnostic) fix issues AFTER they occur. This skill catches mismatches BEFORE push.
From DISCOVERIES.md analysis:
When activated, execute these steps autonomously:
# Python version
python --version
# Installed tool versions
pip show ruff black pyright mypy 2>/dev/null | grep -E "^(Name|Version):"
# Pre-commit hook versions (if available)
cat .pre-commit-config.yaml 2>/dev/null | grep -E "rev:|repo:"
Read(file_path=".github/workflows/ci.yml")
Read(file_path="pyproject.toml")
Read(file_path=".pre-commit-config.yaml")
Extract:
python-version:)Build comparison table:
| Component | Local | CI | Status |
|---|---|---|---|
| Python | 3.12.10 | 3.11 | MISMATCH |
| ruff | 0.12.7 | 0.13.0 | MISMATCH |
| black | 24.3.0 | 24.3.0 | OK |
For each mismatch, provide actionable fix:
Python Version Mismatch:
# Option A: Use pyenv to match CI version
pyenv install 3.11
pyenv local 3.11
# Option B: Update CI to match local (if local is intentional)
# Edit .github/workflows/ci.yml line 33
Tool Version Mismatch:
# Pin versions in pyproject.toml
pip install ruff==0.13.0
# Or update pre-commit hooks
pre-commit autoupdate
If user requests auto-fix:
pre-commit autoupdateIntegrates with fix-agent templates for:
Hand-off when pre-commit failures detected after version sync.
Hand-off for post-push CI failures not caught by pre-push validation.
Symptoms:
Fix:
# Check CI Python version
grep -r "python-version" .github/workflows/
# Match locally or update CI
Symptoms:
Fix:
# Sync pre-commit hooks to latest
pre-commit autoupdate
# Or pin specific version
pip install ruff==<ci-version>
Symptoms:
Fix:
# Install all optional dependencies
pip install -e ".[dev]"
# Ensure requirements.txt is up to date
pip freeze > requirements.txt
## Dependency Resolver Report
### Environment Comparison
| Component | Local | CI | Status |
| --------- | ------- | ------- | -------- |
| Python | 3.12.10 | 3.11 | MISMATCH |
| ruff | 0.12.7 | 0.13.0 | MISMATCH |
| pyright | 1.1.350 | 1.1.350 | OK |
### Mismatches Found: 2
### Recommendations
1. **Python Version** (CRITICAL)
- Local: 3.12.10, CI: 3.11
- Action: Consider using pyenv to test with CI version before push
- Risk: Type syntax differences may cause failures
2. **ruff Version** (WARNING)
- Local: 0.12.7, CI: 0.13.0
- Action: Run `pip install ruff==0.13.0` or `pre-commit autoupdate`
- Risk: New rules may flag previously passing code
### Quick Fix Commands
```bash
# Sync ruff version
pip install ruff==0.13.0
# Update all pre-commit hooks
pre-commit autoupdate
# Re-run pre-commit to validate
pre-commit run --all-files
```
### Status: ACTION REQUIRED
Push may fail due to environment mismatches.
Run recommended fixes before pushing.
Trigger Signs:
Not Needed When:
Weekly Installs
85
Repository
GitHub Stars
45
First Seen
Jan 23, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode78
claude-code73
codex72
cursor71
gemini-cli70
github-copilot69
Azure Data Explorer (Kusto) 查询技能:KQL数据分析、日志遥测与时间序列处理
133,300 周安装