菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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 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.
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.
| name | dead-code-audit |
| version | 0.8.0 |
| description | 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. |
A code-health leaf skill reporting unused/dead code as advisory DELETE findings. It does not delete anything.
python3 scripts/dead_code_audit.py \
--root /path/to/repo \
--source-prefix src/pkg/ \
--out-dir /tmp/dead-code \
--allowlist .vulture_whitelist.py
dead-code_findings.json — sorted findings (shared schema).dead-code_report.md — summary plus suppression count.suppressed_test_referenced.0 clean, 1 advisory findings present, 2 tool/config error.vulture + ruff (F401/F811/F841 only). See
skills/dead-code-audit/references/rubric.md. --allowlist FILE suppresses
vulture false positives. Vulture function/class/method/property findings whose
symbols appear in tests/test_*.py are suppressed and counted as
suppressed_test_referenced; ruff findings are unaffected. The test-reference
scan is a conservative substring check, so even a test comment can suppress an
advisory DELETE. Findings are deterministic.
vulture and ruff (F401/F811/F841 only).vulture and ruff installed; a missing tool is a config error
(exit 2), not a finding.getattr, string-based
dispatch, plugin entry points), so vulture can report false positives; use
--allowlist to suppress them.