fix-quality
Diagnose and repair a failing quality gate at its root instead of suppressing the finding.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-15
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- fix-quality
- description
- Diagnose and repair a failing quality gate at its root instead of suppressing the finding.
03 SKILL.md 正文
Fix a failing gate
- Read
AGENTS.md, then reproduce with the narrowest recipe:just checknames the failed recipe; run that one alone and read its first failure. - Dispatch on which gate failed:
check-toolchain— cargo is not rustup's proxy, or rustup is missing. Put~/.cargo/binfirst onPATH; only that proxy honoursrust-toolchain.toml.lock-check— runjust lock, a network recipe needing explicit authorization, and read the lockfile diff before accepting it.lint— a pre-commit hook failed. Hooks namedfmt-check,toml-check,deps-unused,py-lintorpy-typecheckgo to their gate's line below;validate-docsgoes tocheck-docs,validate-agentstocheck-agents. For remaining hooks (Markdown, typos, links, shell, workflows, secrets, whitespace), runjust fixfor automatic repairs, then fix the remainder by hand. Remove secrets found by ripsecrets; never allowlist them.fmt-checkortoml-check— runjust fix; never hand-format to match.clippy— fix the code. A lint wrong for one item gets#[expect(lint, reason = "...")]there. A lint wrong for the core is changed in the workspace table with a comment explaining why. A lint pyo3's macro output trips is allowed incrates/alliumpy/Cargo.toml's own[lints]table with a comment naming the macro, never in the workspace table. Keep unsafe forbidden.metrics— lower the complexity, cohesion or coupling rustqual reports. Never raise a threshold inrustqual.toml. A version mismatch meansjust install-tools, a network recipe needing explicit authorization, has not run in this worktree.features— fix thecfgfor the failing feature combination; keep every combination in the powerset.test-doc— fix the example or the item it documents; doc examples are tests.coveragebelow the floor — add the missing test; never lowercoverage_floorin theJustfile. Remove genuinely unreachable defensive code instead of inventing an input to cover it.doc— fix a missing doc comment or broken intra-doc link; warnings are errors.denyordeps-unused— fix a licence, ban or unused dependency. A new dependency needs the decision-0004 note;just fixruns cargo shear's fixer. Cargo shear takes no--lockedflag; the invariant 7 gap remains recorded in T05.py-lint—just fixruns ruff's fixers. A rule wrong for one line gets# noqa: RULEwith a reason. Never addextend-ignoreinruff.tomlwithout a comment and a review. Preserve the fixture's positive control.py-typecheck— fix the type; never use# type: ignorewithout a code and a reason, and never loosenstrict. Preserve the positive control.py-test— fix the binding or test.just py-testrebuilds the extension first; a stale.sobeside__init__.pyonly explains a bare pytest run. Usejust py-testto reproduce.py-stubtest— the stub and module disagree: change whichever is wrong. Never add an allowlist entry without a reason beside it.wheel-smoke— two wheels indist/mean something wrote there afterjust wheelemptied it; rerunjust wheel-smoke. Missing uv means the pixi environment is incomplete;just initialize, a network recipe needing explicit authorization, rebuilds it. A network error means the recipe reached out, which is a defect in the recipe: the wheel smoke must install offline.version-check— five copies of one version disagree; the message names the two. A bareallium-parserbump is a release (decision 0010), with the wheel's packaging-only.postNstripped for comparison.check-docs— frontmatter disagreement withdocs/manifest.ymlis often list order; the comparison is order-sensitive. Repair the owning page and its entry.check-agents— check inventory, required guidance and exact bridge content and frontmatter against the canonical file. Bridges and adapters stay thin.snapshots-check— a snapshot differs or a.snapfile is unreferenced. The gate writes no pending snapshots. If the change is intended, runjust snapshots-accept, obtaining explicit authorization first if it would delete unreferenced snapshots. Review and explain every resulting diff before committing.just snapshots-reviewonly reviews pending snapshots that already exist.
- Distinguish an unreachable branch from an untested one: remove defensive code no input can reach instead of covering it with a contrived test.
- Never disable a gate to make a run green. A suppression is a last resort: one rule, one line, with a stated reason.
- A recipe that changes the worktree is defective; repair the recipe within the ticket's scope, or hand it back if frozen or owned by another lane.
- Run the narrow recipe, then
just checkto confirm nothing else moved.
04 同仓库更多 Skills
rust-change
Implement or review a change to the core or the bindings crate with the layering, tests and documentation evidence the invariants require.
review-docs
Add or revise a handbook page so it satisfies the documentation contract and stays reachable.
review-change
Review a change in this repository against its invariants, specifications, tests, and documentation contract.
python-change
Implement or review a change to the Python package, its stub, its tests or the console script with the stubtest, pytest and wheel-smoke evidence the invariants require.
project-check
Bring a workspace to a state where the full gate runs, and interpret what it reports.
plan-change
Plan a change when the scope, affected specifications, risks, or validation need evidence before any code is written.