菜单
Use when pre-commit hooks fail repeatedly, lint errors persist after make format, or local checks disagree with CI on pulp-tool.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | troubleshooting-pulp-tool-ci |
| description | Use when pre-commit hooks fail repeatedly, lint errors persist after make format, or local checks disagree with CI on pulp-tool. |
pre-commit run --all-files
Fix every failure, then re-run until one full run passes with zero failures. Do not commit after a partial fix without a subsequent clean run.
Single hook: pre-commit run <hook-id> --all-files
make lint # All linters
make format # Auto-fix Black
make lint-black # Check formatting only
make lint-flake8
make lint-pylint
make lint-mypy
Prefer Makefile targets over invoking tools directly.
| Issue | Solution |
|---|---|
| Black vs Flake8 E203 | E203 ignored in .flake8 — expected with Black |
| Mypy errors in specific modules | Check [[tool.mypy.overrides]] in pyproject.toml — may be intentional |
| Hooks fail on commit | Loop pre-commit run --all-files locally until clean |
.pre-commit-config.yaml — hookspyproject.toml — Black, Pylint, Mypy.flake8 — Flake8Makefile — targetsIf the failure is uncovered changed lines, use fixing-diff-cover-failures skill instead of guessing from lint output.
Use when the user confirms paste-ready PR materials, or asks for a PR title/body, commit message, or CHANGELOG entry after substantive pulp-tool repo changes.
Use when changing the Dockerfile, .tekton/ PipelineRuns, pulp-tool-container image, UBI/Python base, or Konflux container build integration. Container images are built by Konflux Tekton — not GitHub Actions.
Use when changing upload, global CLI flags (--config, --build-id, --namespace), --rpm-path, --parent-package, --sbom-path, --artifact-results, Tekton workspace paths, or Konflux downstream integration. Container image *build*: changing-pulp-container.
Use when make test-diff-coverage fails, CI reports diff coverage below 100%, or a GitHub PR is blocked on uncovered changed lines.