clean-codebaseRemove dead code, unused imports, fix lint warnings, and normalize formatting across a codebase without changing business logic or architecture. Use when lint warnings have piled up during rapid development, unused imports and variables clutter files, dead code paths were never removed, formatting is inconsistent, or static analysis tools report fixable hyg…
Independent GitHub snapshot · Automated classification · Original documentation governs
用此技於庫積污者：
勿用於構重構、修訛、或業理之變。此技專於潔與自動之清。
| Parameter | Type | Required | Description |
|---|---|---|---|
codebase_path | string | Yes | Absolute path to codebase root |
language | string | Yes | Primary language (js, python, r, rust, etc.) |
cleanup_mode | enum | No | safe (default) or aggressive |
run_tests | boolean | No | Run test suite after cleanup (default: true) |
backup | boolean | No | Create backup before deletion (default: true) |
量當前之態以後驗改。
# Count lint warnings by severity
lint_tool --format json > lint_before.json
# Count lines of code
cloc . --json > cloc_before.json
# List unused symbols (language-dependent)
# JavaScript/TypeScript: ts-prune or depcheck
# Python: vulture
# R: lintr unused function checks
得： 基量存於 lint_before.json 與 cloc_before.json
敗則： 若 lint 具不得，略自動之補而專於手察
施安之自補（間、引、分、尾空）。
JavaScript/TypeScript:
eslint --fix .
prettier --write .
Python:
black .
isort .
ruff check --fix .
R:
Rscript -e "styler::style_dir('.')"
Rust:
cargo fmt
cargo clippy --fix --allow-dirty
得： 諸安 lint 警已解；諸檔式一
敗則： 若自補引測敗，退變而升
用靜析尋未引之函、未用之變、孤之檔。
JavaScript/TypeScript:
ts-prune | tee dead_code.txt
depcheck | tee unused_deps.txt
Python:
vulture . | tee dead_code.txt
R:
Rscript -e "lintr::lint_dir('.', linters = lintr::unused_function_linter())"
通法：
得： dead_code.txt 列未用之函、變、檔
敗則： 若靜析具不得，手察近之提交史尋孤碼
清引區，除永未用之包。
JavaScript:
eslint --fix --rule 'no-unused-vars: error'
Python:
autoflake --remove-all-unused-imports --in-place --recursive .
R:
# Manual review: grep for library() calls, check if package used
grep -r "library(" . | cut -d: -f2 | sort | uniq
得： 諸未用之引句皆除
敗則： 若除引而建敗，間接有用——復而書之
安模（默）：
侵模（擇入）：
每候刪：
CLEANUP_LOG.md得： 死碼已除；CLEANUP_LOG.md 書諸除
敗則： 若不確碼真死，移入 archive/ 而非除
確諸檔式一（雖 lint 不捕）。
# Example: Fix line endings and trailing whitespace
find . -type f -name "*.js" -exec sed -i 's/\r$//' {} +
find . -type f -name "*.js" -exec sed -i 's/[[:space:]]*$//' {} +
得： 諸檔循一式
敗則： 若 sed 破二進之檔，略而書之
驗清未破功。
# Language-specific test command
npm test # JavaScript
pytest # Python
R CMD check # R
cargo test # Rust
得： 諸測皆通（或同清前之敗）
敗則： 漸退變以識破者，而升
書諸變以察。
# Codebase Cleanup Report
**Date**: YYYY-MM-DD
**Mode**: safe | aggressive
**Language**: <language>
## Metrics
| Metric | Before | After | Change |
|--------|--------|-------|--------|
| Lint warnings | X | Y | -Z |
| Lines of code | A | B | -C |
| Unused imports | D | 0 | -D |
| Dead functions | E | F | -G |
## Changes Applied
1. Fixed X lint warnings (automated)
2. Removed Y unused imports
3. Deleted Z lines of dead code (see CLEANUP_LOG.md)
4. Normalized formatting across W files
## Escalations
- [Issue description requiring human review]
- [Uncertain deletion moved to archive/]
## Validation
- [x] All tests pass
- [x] Backup created: backup_YYYYMMDD/
- [x] CLEANUP_LOG.md updated
得： 報存於項目根之 CLEANUP_REPORT.md
敗則：（無——無論結果皆生報）
清後：
CLEANUP_LOG.md 書諸除碼除仍以反射用之碼：靜析漏動呼（如 eval()、元編程）。必察 git 史。
破隱依：除依所用之引。每除引後行測。
刪活功之旗：雖當枝未用，或於他境活。察部署之設。
過侵之式：如 black、prettier 可重式生冗 diff。設具合項目之風。
忽測覆：無測之庫不可安清。若覆低，先升補測。
不備：除前必建 backup_YYYYMMDD/，雖用 git。
混系上之誤 R 二：於 WSL 或 Docker，Rscript 或解為跨臺之包而非原生 R。以 which Rscript && Rscript --version 察。宜用原生 R 二（如 Linux/WSL 上之 /usr/local/bin/Rscript）以信。見 Setting Up Your Environment 以 R 路之設。