dead-code-removal

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Dead Code Removal

未使用代码移除

This skill safely identifies and removes unused code across multiple programming languages. It includes comprehensive safety checks to prevent removing code that's actually needed.

本Skill可跨多种编程语言安全识别并移除未使用的代码，包含全面的安全检查机制，可防止误删实际需要的代码。

When to Use This Skill

适用场景

After refactoring code and removing features
Before production deployment to reduce bundle size
When cleaning up legacy code
When removing deprecated functionality
When optimizing codebase size
When maintaining code quality standards

代码重构及功能移除后
生产部署前用于减小包体积
清理遗留代码时
移除已弃用功能时
优化代码库体积时
维护代码质量标准时

What This Skill Does

功能说明

Language Detection: Identifies project languages and structure
Entry Point Mapping: Maps entry points and critical paths
Dependency Analysis: Builds dependency graphs and usage patterns
Safe Detection: Identifies unused elements with safety checks
Incremental Removal: Removes code incrementally with validation
Backup Creation: Creates backups before making changes

语言检测：识别项目使用的语言及结构
入口点映射：映射代码入口点与关键路径
依赖分析：构建依赖图与使用模式
安全检测：通过安全检查识别未使用元素
增量移除：通过验证机制增量式移除代码
备份创建：在修改前创建代码备份

Helper Scripts

辅助脚本

This skill includes Python helper scripts in

scripts/

find_unused_imports.py
: Uses AST parsing to accurately detect unused imports in Python files. Outputs JSON with unused imports and line numbers.
bash
```
python scripts/find_unused_imports.py src/utils.py src/services.py
```

本Skill在

scripts/

目录下包含Python辅助脚本：

find_unused_imports.py
：使用AST解析准确检测Python文件中的未使用导入，输出包含未使用导入及行号的JSON结果。
bash
```
python scripts/find_unused_imports.py src/utils.py src/services.py
```

How to Use

使用方法

Remove Unused Code

移除未使用代码

Find and remove unused imports and functions in this project

Clean up dead code in src/ directory, but be conservative

查找并移除本项目中的未使用导入与函数

清理src/目录下的未使用代码，操作请保守处理

Specific Analysis

专项分析

Check for unused functions in src/utils/ and remove them safely

检查src/utils/中的未使用函数并安全移除

Analysis Process

分析流程

1. Language Detection

1. 语言检测

Identify Project Type:

Python: Look for
```
pyproject.toml
```
,
```
setup.py
```
,
```
requirements.txt
```
JavaScript/TypeScript: Check
```
package.json
```
,
```
tsconfig.json
```
Java: Look for
```
pom.xml
```
,
```
build.gradle
```
Go: Check
```
go.mod
```
Rust: Check
```
Cargo.toml
```

Detect Entry Points:

Python:
```
main.py
```
,
```
__main__.py
```
,
```
app.py
```
,
```
run.py
```
JavaScript:
```
index.js
```
,
```
main.js
```
,
```
server.js
```
,
```
app.js
```

Java:

Main.java

*Application.java

*Controller.java

Config files:
```
*.config.*
```
,
```
settings.*
```
,
```
setup.*
```
Test files:
```
test_*.py
```
,
```
*.test.js
```
,
```
*.spec.js
```

识别项目类型：

Python：查找
```
pyproject.toml
```
、
```
setup.py
```
、
```
requirements.txt
```
JavaScript/TypeScript：检查
```
package.json
```
、
```
tsconfig.json
```
Java：查找
```
pom.xml
```
、
```
build.gradle
```
Go：检查
```
go.mod
```
Rust：检查
```
Cargo.toml
```

检测入口点：

Python：
```
main.py
```
、
```
__main__.py
```
、
```
app.py
```
、
```
run.py
```
JavaScript：
```
index.js
```
、
```
main.js
```
、
```
server.js
```
、
```
app.js
```

Java：

Main.java

、

*Application.java

、

*Controller.java

配置文件：
```
*.config.*
```
、
```
settings.*
```
、
```
setup.*
```
测试文件：
```
test_*.py
```
、
```
*.test.js
```
、
```
*.spec.js
```

2. Build Dependency Graph

2. 构建依赖图

Cross-File Dependencies:

Track imports and requires
Map function/method calls
Identify class inheritance
Track dynamic usage patterns

Framework Patterns:

Preserve framework-specific patterns (Django models, React components, etc.)
Check for decorators and annotations
Verify entry point registrations

跨文件依赖：

跟踪导入与引用关系
映射函数/方法调用
识别类继承关系
跟踪动态使用模式

框架模式：

保留框架特定模式（如Django模型、React组件等）
检查装饰器与注解
验证入口点注册

3. Detect Unused Elements

3. 检测未使用元素

Using Helper Script:

The skill includes a Python helper script for finding unused imports:

bash

undefined

使用辅助脚本：

本Skill包含用于查找未使用导入的Python辅助脚本：

bash

undefined

Find unused imports in Python files

查找Python文件中的未使用导入

python scripts/find_unused_imports.py src/utils.py src/services.py


**Unused Imports:**

```python

python scripts/find_unused_imports.py src/utils.py src/services.py


**未使用导入：**

```python

Python: AST-based analysis

Python：基于AST的分析

import ast

Track: Import statements vs actual usage

跟踪：导入语句与实际使用情况

Skip: Dynamic imports (importlib, import)

排除：动态导入（importlib、import）


```javascript
// JavaScript: Module analysis
// Track: import/require vs references
// Skip: Dynamic imports, lazy loading

Unused Functions/Classes:

Define: All declared functions/classes
Reference: Direct calls, inheritance, callbacks
Preserve: Entry points, framework hooks, event handlers


```javascript
// JavaScript：模块分析
// 跟踪：import/require与引用关系
// 排除：动态导入、懒加载

未使用函数/类：

定义：所有已声明的函数/类
引用：直接调用、继承、回调
保留：入口点、框架钩子、事件处理器

4. Safety Checks

4. 安全检查

Never Remove If:

Python:
```
getattr()
```
,
```
eval()
```
,
```
globals()
```
usage detected
JavaScript:
```
window[]
```
,
```
this[]
```
, dynamic
```
import()
```
usage
Java: Reflection, annotations (
```
@Component
```
,
```
@Service
```
)
Framework patterns: Models, controllers, routes, components
Entry points: Main functions, app initialization
Test files: All test-related code

Framework Preservation:

Python:

Django: Models, migrations, admin registrations
Flask: Routes, blueprints, app factories
FastAPI: Endpoints, dependencies

JavaScript:

React: Components, hooks, context providers
Vue: Components, directives, mixins
Angular: Decorators, services, modules

Java:

Spring: Beans, controllers, repositories
JPA: Entities, repositories

以下情况绝对不能移除：

Python：检测到
```
getattr()
```
、
```
eval()
```
、
```
globals()
```
使用
JavaScript：
```
window[]
```
、
```
this[]
```
、动态
```
import()
```
使用
Java：反射、注解（
```
@Component
```
、
```
@Service
```
）
框架模式：模型、控制器、路由、组件
入口点：主函数、应用初始化代码
测试文件：所有测试相关代码

框架代码保留规则：

Python：

Django：模型、迁移文件、admin注册
Flask：路由、蓝图、应用工厂
FastAPI：端点、依赖项

JavaScript：

React：组件、钩子、上下文提供者
Vue：组件、指令、混入
Angular：装饰器、服务、模块

Java：

Spring：Bean、控制器、仓库
JPA：实体、仓库

5. Safe Removal Process

5. 安全移除流程

Backup Creation:

bash

backup_dir="./unused_code_backup_$(date +%Y%m%d_%H%M%S)"
cp -r . "$backup_dir" 2>/dev/null || mkdir -p "$backup_dir" && rsync -a . "$backup_dir"

Incremental Removal:

Create temp file with change
Validate syntax
Run tests if available
Apply or rollback

Validation:

bash

undefined

创建备份：

bash

backup_dir="./unused_code_backup_$(date +%Y%m%d_%H%M%S)"
cp -r . "$backup_dir" 2>/dev/null || mkdir -p "$backup_dir" && rsync -a . "$backup_dir"

增量式移除：

创建包含修改内容的临时文件
验证语法正确性
如有测试用例则运行测试
应用修改或回滚

验证操作：

bash

undefined

Python

python -m py_compile file.py python -m pytest

JavaScript

npx eslint file.js npm test

Java

javac -Xlint file.java mvn test

undefined

javac -Xlint file.java mvn test

undefined

Examples

示例

Example 1: Remove Unused Imports

示例1：移除未使用导入

Input: Clean up unused imports in

src/utils/helpers.py

Output:

markdown

undefined

输入：清理

src/utils/helpers.py

中的未使用导入

输出：

markdown

undefined