用途:为 JavaScript/TypeScript(含 React、Next.js)项目做上线前清理,扫描并移除无用的代码污染,同时生成清理报告。
主要能力:检测 console.log、console.debug、console.info、debugger;未使用的 import(含 Next.js 13+、React 17+ 中不必要的 import React);应使用 import type 的类型导入;未被读取的 const/let/var、解构未用值与未使用函数参数;无意义注释(TODO、FIXME、HACK、TEMP 等、被注释掉的代码、无意义行内注释)。不会标记 console.error 与 console.warn。
使用方式:先确认 package.json 存在;若项目为 Python(manage.py 或 pyproject.toml),改用 production-clean-python 技能。STEP 1 全项目扫描不修改,汇总发现;STEP 2 显示分类计数与受影响文件数,询问是否继续(Yes / No / 按类别选择);STEP 3 按固定顺序清理:console.log/debugger、未使用导入、未使用变量、无意义注释;每改一个文件先读取、应用修改、验证语法,若损坏立即还原;STEP 4 输出 production-clean-report.md,含汇总表、受影响文件、跳过项与备注。
限制与注意:不修改 console.error/warn、JSDoc/TSDoc、index 再导出、.d.ts、配置与测试文件(测试文件需先确认);不触碰 'use client'/'use server',对 layout.tsx、page.tsx 等 Next.js 文件格外小心;移除类型导入前确认运行时未使用;不改动仅看似未使用的泛型参数;eslint-disable 注释需先询问;语法出错则还原该文件并记入需人工复核列表。