name: dead-code description: 在代码库中查找未使用的函数和死代码 allowed-tools: [Bash] keywords: [死代码, 未使用, 清理, 重构, 不可达]
死代码检测
使用 TLDR 静态分析查找未使用的函数和死代码。
快速开始
# 扫描整个项目
tldr dead .
# 扫描特定目录
tldr dead src/
# 指定入口点(从分析中排除的函数)
tldr dead . --entry main cli test_
# 指定语言
tldr dead . --lang python
tldr dead . --lang typescript
输出格式
死代码分析:
总函数数:150
死函数数:12
未使用函数:
- old_helper (src/utils.py:42)
- deprecated_func (src/legacy.py:15)
- _unused_method (src/api.py:230)
跨平台
支持 Windows、Mac 和 Linux(包括 WSL)。
# Windows(PowerShell)
tldr dead .
# Mac/Linux
tldr dead .
入口点
匹配入口模式的函数被排除在死代码分析之外:
main,cli- 应用程序入口点test_*,*_test- 测试函数setup,teardown- 测试夹具@app.route,@api.endpoint- 框架处理器
# 自定义入口点
tldr dead src/ --entry main api_handler background_job
集成
此技能替换了会话启动死代码钩子,提供按需分析。
| 方法 | 优点 | 缺点 |
|---|---|---|
| 钩子(已移除) | 自动 | 启动速度减慢 3 秒 |
| 技能(本技能) | 按需、快速 | 手动调用 |
相关命令
# 影响分析(谁调用这个?)
tldr impact func_name .
# 架构层
tldr arch src/
# 完整代码库结构
tldr structure . --lang python