first commit

文档润色流和知识库构建流/claude-scholar/commands/refactor-clean.md

@@ -0,0 +1,29 @@
+# Refactor Clean
+
+Safely identify and remove dead code with test verification:
+
+1. Run dead code analysis tools:
+   - vulture: Find unused Python code (functions, classes, variables)
+   - pyflakes: Detect unused imports and variables
+   - ruff check --select F401: Find unused imports
+   - pip-audit: Check for security vulnerabilities
+
+2. Generate comprehensive report in .reports/dead-code-analysis.md
+
+3. Categorize findings by severity:
+   - SAFE: Test files, unused utilities, unused imports
+   - CAUTION: API routes, models, fixtures
+   - DANGER: Config files, main entry points, registry decorators
+
+4. Propose safe deletions only
+
+5. Before each deletion:
+   - Run full test suite (pytest)
+   - Verify tests pass
+   - Apply change
+   - Re-run tests
+   - Rollback if tests fail
+
+6. Show summary of cleaned items
+
+Never delete code without running tests first!