| name | deep-simplify |
| description | 深度简化Python代码，通过运行时日志分析识别并移除死代码。
当用户需要简化代码、清理未使用的代码、优化代码结构、移除死代码时使用此skill。
适用于：代码清理、死代码检测、代码重构前的分析、代码库瘦身。
使用方法：/deep-simplify <file_path>
|
深度简化代码 (Deep Simplify)
通过运行时日志分析，识别并移除Python代码中未被实际执行的"死代码"。
触发条件
当用户有以下请求时触发此skill：
- "简化这个文件"
- "清理死代码"
- "移除未使用的代码"
- "分析代码覆盖率"
- "/deep-simplify <文件路径>"
工作流程
- 验证输入：检查文件路径是否有效
- 代码插桩：在目标文件的所有函数、循环、if-else分支中插入日志标记
- 运行收集：执行主程序，收集代码覆盖日志
- 日志分析：分析哪些代码路径被执行，哪些从未被执行
- 死代码识别：确定未被访问的代码区域（排除测试用例）
- 代码简化：安全地移除确认的死代码
- 验证：再次运行确保程序正常工作
执行步骤
前提检查
- 确保项目根目录存在
main.py 作为主程序入口
- 确保已安装
astor 库（用于AST代码生成）
Step 1: 验证输入
检查用户提供的文件路径：
- 路径不能为空
- 文件必须存在
- 必须是
.py 文件
- 一次只能处理一个文件
如果不满足条件，向用户说明原因并退出。
Step 2: 代码插桩
使用 scripts/instrument.py 对目标文件进行插桩：
python /Users/kang/.claude/skills/deep-simplify/scripts/instrument.py <file_path>
插桩位置包括：
- 函数定义的第一行（
func_entry）
- for/while循环体内部（
loop_entry）
- if/elif/else分支内部（
if_branch/elif_branch/else_branch）
- try/except/finally块内部（
try_block/except_block/finally_block）
插桩后的日志格式：
print(f"[DEEP_SIMPLIFY] {file_name}:{line_number}:{function_name}:{tag_type}")
原文件会被备份为 .bak 文件。
Step 3: 运行主程序收集日志
执行项目主程序：
cd /Users/kang/Documents/workspace/rebuild_data_flow && python main.py
捕获所有输出（stdout和stderr），筛选包含 [DEEP_SIMPLIFY] 的日志行。
Step 4: 分析代码覆盖
解析收集到的日志，与插桩点对比：
- 提取所有插桩点（使用
extract_instrumentation_points 函数）
- 解析执行日志，获取实际执行的代码点
- 计算覆盖率：
已执行点数 / 总插桩点数
- 识别死代码：
Step 5: 确定可移除的死代码
过滤死代码列表：
- 排除测试函数（以
test_ 开头）
- 分析上下文依赖，确认移除是安全的
- 生成死代码报告，包含：
- 文件位置（行号）
- 代码类型（函数/分支/循环）
- 代码内容预览
Step 6: 执行代码简化
使用 scripts/simplify.py 移除确认的死代码：
python /Users/kang/.claude/skills/deep-simplify/scripts/simplify.py <file_path> <analysis_json> <output_path>
简化规则：
- 移除整个死函数定义
- 简化if语句：如果if分支死亡但else存活，用else内容替换整个if
- 如果整个if-else都死亡，移除整个块
Step 7: 验证简化结果
再次运行主程序：
cd /Users/kang/Documents/workspace/rebuild_data_flow && python main.py
- 如果程序正常执行（返回码0），简化成功
- 如果程序失败，从备份恢复原始文件，并报告错误
清理
删除临时文件：
.deep_simplify_logs.txt.deep_simplify_inst.txt
保留备份文件 .bak 供用户需要时手动恢复。
输出报告格式
执行完成后输出简洁报告：
============================================================
代码简化完成!
============================================================
文件: <file_path>
总插桩点: <count>
已执行: <count> (<rate>%)
死代码: <count> 个
- 未使用函数: <count>
- 未执行分支: <count>
已移除: <count> 个代码项
验证: 通过
原始备份: <file_path>.bak
注意事项
- 单次只能处理一个文件：确保专注分析，避免复杂依赖问题
- 需要main.py：项目必须有可执行的main.py作为主入口
- 备份原文件：简化前会自动创建
.bak 备份
- 测试用例排除：分析时会排除测试代码对主代码的访问
- 保守策略：不确定是否可移除的代码会保留，由用户决定
依赖安装
如果缺少 astor 库，自动安装：
pip install astor
手动恢复
如果简化后出现问题，手动恢复：
cp <file_path>.bak <file_path>
