python-code-reviewer
Installation
SKILL.md
Preconditions
- Python code and
code/Qx/qx_code_plan.mdexist. - Approved method decision, method card, data profile, and relevant run summary are available.
- Required inputs are accessible.
Workflow
- Resolve the approved main and usable baseline. Flag scripts for unapproved candidates unless a fallback activation exists.
- Inspect and run the code in the intended order.
- Evaluate required checks:
syntax: imports, execution, exceptions, and obvious runtime faults.input_contract: paths, fields, units, shapes, missing-data handling, and raw-data protection.method_alignment: formulas, objectives, constraints, assumptions, main/baseline roles, and fallback scope match the approved plan.reproducibility: seed, deterministic setup, dependency/runtime record, and rerun consistency.output_contract: saved tables/metrics/figures, valid run summary, comparable main/baseline metrics, degeneracy evidence, and fallback-trigger state.
- Add risk-specific checks only when relevant, such as leakage, constraint feasibility, numerical stability, or scale.
- If asked to fix findings, make minimal changes, rerun affected checks, and record the repair. Otherwise report findings without changing code.
- Save
code/Qx/reviews/qx_python_review.json.