تشغيل أي مهارة في Manus بنقرة واحدة

complexity-audit

النجوم٠

التفرعات٠

آخر تحديث١٥ يونيو ٢٠٢٦ في ١٤:٥٥

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.

التثبيت

التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.

تشغيل في Manus

المصدر

jc1122

jc1122/repo-audit-skills

فتح مستودع GitHub عرض مستودعات المنشئ

تنزيل

تشغيل في Manus

المهن ذات الصلةSOC

استنادا إلى تصنيف SOC المهني

محللو ضمان جودة البرمجيات والمختبرونمهن الحاسوب والرياضيات·SOC 15-1253

مستكشف الملفات

14 ملفات

SKILL.md

readonly

name	complexity-audit
version	0.8.0
description	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.

complexity-audit

Overview

Reports functions that are too complex or too long and modules with low maintainability. Advisory only; it does not refactor.

Quick Start

python3 scripts/complexity_audit.py \
  --root /path/to/repo \
  --source-prefix src/pkg/ \
  --out-dir /tmp/complexity

Output

complexity_findings.json — sorted list of findings (shared schema).
complexity_report.md — human-readable summary grouped by signal, including counted precision suppressions such as entrypoint_mi_relaxed.
stdout status JSON — includes status, findings, leaf, and entrypoint_mi_relaxed.

Exit Codes

0 — clean (no findings).
1 — advisory findings present.
2 — tool/config error (e.g. lizard or radon not installed).

Flags and Thresholds

--source-prefix is repeatable. Override thresholds with --config thresholds.json; see skills/complexity-audit/references/rubric.md.

Default thresholds include mi_low=65, mi_medium=50, and mi_entrypoint_low=20. Set "mi_entrypoint_low": null to disable entrypoint module-MI relaxation.

Notes

Findings are deterministic: identical input yields byte-identical complexity_findings.json.
CLI entrypoints with if __name__ == guards suppress module-level maintainability-index findings when MI is at least mi_entrypoint_low but below mi_low; each suppression increments entrypoint_mi_relaxed.
The entrypoint relaxation is intentionally narrow: standalone CLI modules can have low module MI because they remain self-contained, while function-level lizard checks still report actionable complexity. Entrypoint modules below the floor still emit maintainability_index.

Limits

Advisory only — emits SIMPLIFY/DECOMPOSE findings and never refactors or mutates source.
Python only: backed by lizard and radon mi, which analyze Python source.
Requires lizard and radon installed; a missing tool is a config error (exit 2), not a finding.
Metrics are static thresholds on cyclomatic complexity, length, parameter count, and maintainability index; they flag structural smells, not behavioral bugs, and need human interpretation.
No network access; deterministic for fixed inputs and tool versions.

المزيد من هذا المستودع

نفس المستودع

test-effectiveness-audit

jc1122/repo-audit-skills

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?".

2026-06-160

code-health-audit-pipeline

jc1122/repo-audit-skills

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.

2026-06-150

coverage-gap-audit

jc1122/repo-audit-skills

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?".

2026-06-150

dead-code-audit

jc1122/repo-audit-skills

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.

2026-06-150

dependency-audit

jc1122/repo-audit-skills

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.

2026-06-150

docs-consistency-audit

jc1122/repo-audit-skills

Deterministic, advisory docs-vs-reality audit for Python docs and command docs that emits LINT findings. Compares documented CLI flags against actual argparse parsers, checks doc paths for dead references, flags stale version pins, and optionally reports docstring coverage. Never mutates source.

2026-06-150

name	complexity-audit
version	0.8.0
description	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.

complexity-audit

Overview

Reports functions that are too complex or too long and modules with low maintainability. Advisory only; it does not refactor.

Quick Start

python3 scripts/complexity_audit.py \
  --root /path/to/repo \
  --source-prefix src/pkg/ \
  --out-dir /tmp/complexity

Output

complexity_findings.json — sorted list of findings (shared schema).
complexity_report.md — human-readable summary grouped by signal, including counted precision suppressions such as entrypoint_mi_relaxed.
stdout status JSON — includes status, findings, leaf, and entrypoint_mi_relaxed.

Exit Codes

0 — clean (no findings).
1 — advisory findings present.
2 — tool/config error (e.g. lizard or radon not installed).

Flags and Thresholds

--source-prefix is repeatable. Override thresholds with --config thresholds.json; see skills/complexity-audit/references/rubric.md.

Default thresholds include mi_low=65, mi_medium=50, and mi_entrypoint_low=20. Set "mi_entrypoint_low": null to disable entrypoint module-MI relaxation.

Notes

Findings are deterministic: identical input yields byte-identical complexity_findings.json.
CLI entrypoints with if __name__ == guards suppress module-level maintainability-index findings when MI is at least mi_entrypoint_low but below mi_low; each suppression increments entrypoint_mi_relaxed.
The entrypoint relaxation is intentionally narrow: standalone CLI modules can have low module MI because they remain self-contained, while function-level lizard checks still report actionable complexity. Entrypoint modules below the floor still emit maintainability_index.

Limits

Advisory only — emits SIMPLIFY/DECOMPOSE findings and never refactors or mutates source.
Python only: backed by lizard and radon mi, which analyze Python source.
Requires lizard and radon installed; a missing tool is a config error (exit 2), not a finding.
Metrics are static thresholds on cyclomatic complexity, length, parameter count, and maintainability index; they flag structural smells, not behavioral bugs, and need human interpretation.
No network access; deterministic for fixed inputs and tool versions.