用途:作为 L3 Worker 审计无用与不可达代码(分类9,低优先级),找出未使用的导入、变量、函数、被注释掉的代码及遗留兼容代码,并计算合规评分(X/10)。
主要能力:四项检查,包括不可达代码(如 return/throw/break 之后的代码,ESLint no-unreachable)、未使用的导入/变量/函数(ESLint no-unused-vars、TypeScript noUnusedLocals/noUnusedParameters、flake8 F401/F841)、被注释掉的代码(>10 行含代码语法的注释块)、遗留代码与向后兼容垫片(别名、包装函数、DEPRECATED 标签、旧版本条件分支、迁移适配器、兼容性注释)。
使用方式:需先读取 references/audit_worker_core_contract.md、mcp_tool_preferences.md、mcp_integration_patterns.md、two_layer_detection.md、clean_code_checklist.md 等参考文件;接收含技术栈、代码库根目录、output_dir 的 contextStore。检测分两层:第一层用 linter 与 grep;JavaScript、TypeScript/TSX、Python、C#、PHP 等支持图索引的项目,可用 index_project 后调用 audit_workspace(verbosity="minimal", limit=5) 检测未使用导出,仅在刻意下钻时提高 limit;不支持的语言或图不可用时回退到 Read/Grep/Glob/Bash 并在报告中声明。第二层逐候选分析动态导入/反射、公共 API 导出、monorepo 跨包使用等误报情况。报告写入 {output_dir}/ln-626--global.md(单次 Write 调用),并按契约输出 JSON 摘要;standalone 模式下摘要写入 .hex-skills/runtime-artifacts/runs/{run_id}/evaluation-worker/{worker}--{identifier}.json。
适用场景:需要审计死代码与遗留兼容代码的代码库,尤其是可进行图索引的 JS/TS/Python/C#/PHP 项目。
限制:仅报告、不自动修复,绝不删除代码;排除生成代码、vendor、迁移脚本、测试夹具;严重级别按代码年龄调整(遗留垫片 >6 个月为 MEDIUM,<3 个月为 LOW);工作量估算 S=<1h、M=1-4h、L=>4h。具体评分算法与输出模板细节需读取对应参考文件,本资料未展开。