菜单
Score your test suite against an 8-dimension TDD rubric, produce 0-24 scores, and output quality gaps with prioritized improvement actions.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | test-quality-assurance |
| version | 0.8.0 |
| description | Score your test suite against an 8-dimension TDD rubric, produce 0-24 scores, and output quality gaps with prioritized improvement actions. |
Scores a test suite against an 8-dimension TDD rubric, producing 0-24 scores and a prioritized list of quality gaps with concrete improvement actions. Covers contract coverage, behavioral clarity, maintainability, and risk posture.
Use this skill for test-health quality scoring (contract coverage, behavioral clarity,
maintainability, and risk posture). This is separate from $test-redundancy-triage, which
handles redundancy classification.
pyproject.toml, requirements*.txt, and pytest config.python -V
pip check
pytest --collect-only -q
Create a concise contract map first:
Then classify tests as unit contract, integration seam, white-box guard, black-box behavior, change-indicator/sentinel, or performance benchmark.
Use:
skills/test-quality-assurance/scripts/audit_test_quality.py
SKILLS_DIR="${SKILLS_DIR:-$HOME/.codex/skills}"
python "$SKILLS_DIR/test-quality-assurance/scripts/audit_test_quality.py" \
--root /path/to/repo \
--internal-import-pattern "from\\s+myproj\\.(core|impl)\\s+import" \
--public-hint "compute(" --public-hint "run_pipeline(" \
--tests-dir tests \
--test-glob "test_*.py" \
--cov-json /tmp/coverage.json \
--json-out /tmp/test_quality.json \
--md-out /tmp/test_quality.md
If --public-hint is omitted, public hints are inferred from package __init__ exports.
Use skills/test-quality-assurance/references/rubric.md:
behavior focus; white-box justification; determinism/isolation; assertion/oracle quality;
pyramid balance; mutation/coverage adequacy; performance-contract coverage; maintainability
and change resilience.
Use skills/test-quality-assurance/references/question-bank.md to expand evidence gaps.
Tag outputs as contract test, white-box sentinel, or change indicator;
do not auto-delete change indicators.
NUMBA_DISABLE_JIT=1 for meaningful coverage.py signal.cython --annotate for .pyx coverage.coverage.py; validate wrappers.skills/test-quality-assurance/references/rubric.md: dimensions and thresholds.skills/test-quality-assurance/references/question-bank.md: common QA questions.skills/test-quality-assurance/scripts/audit_test_quality.py: baseline metrics.skills/test-quality-assurance/references/sample-report.md: output pattern.--cov-json requires a pre-generated coverage.json file.Deterministic, advisory mutation-testing audit for Python. Wraps mutmut==3.6.0 to measure per-module mutation kill rates, emitting TEST findings (shared code-health schema) for modules whose kill rate falls below the configured threshold. Never mutates source in-place; runs in a sandbox copy. The machine-readable answer to "how good are my tests at catching bugs?".
Umbrella that runs the code-health leaf skills (complexity, duplication, dead-code, structure, quality) in parallel, merges and ranks their findings into one report, and emits a supervisor decision with exit codes 0/1/2. Reads a leaf registry so new language leaves plug in without changing the orchestrator. Advisory only.
Deterministic, advisory complexity and maintainability audit for Python. Uses lizard (per-function cyclomatic complexity, length, parameters) and radon mi (per-module maintainability index) to emit SIMPLIFY / DECOMPOSE findings to the shared code-health finding schema. Never mutates source.
Deterministic, advisory testedness audit for Python. Consumes coverage.py JSON report(s) and emits TEST findings (shared code-health schema) for production files with no or insufficient test coverage. Never runs tests, never mutates source. The machine-readable answer to "is this file safe to refactor?".
Deterministic, advisory dead-code audit for Python. Uses vulture (unused functions/classes/methods/properties) and ruff F401/F811/F841 (unused imports, redefinitions, unused locals) to emit DELETE findings to the shared code-health finding schema. Never mutates source.
Deterministic, advisory dependency audit for Python. Compiles declared dependencies (pyproject.toml [project] or requirements*.txt) against AST-collected imports and reports unused declarations, undeclared imports, test-only runtime usage, and optional C-8 advisory enrichment. Uses stdlib only, requires Python >=3.11, never mutates source, and never makes network calls.