用途：解决依赖、安装、环境配置及平台相关的基础设施问题，适合遇到 npm/pip/包错误、安装失败、环境异常时使用。
依赖解析策略：遇到包错误时先读取完整报错、向上滚动找到根因，而非只看最后一行；检查版本兼容性；先清缓存（npm cache clean --force 或 pip cache purge）；尝试全新安装（删除锁文件与 node_modules/venv 后重装）；检查 peer dependencies，特别是 React、TypeScript 与构建工具。
常见包管理器问题：npm/yarn/pnpm 的 ERESOLVE 错误可尝试 --legacy-peer-deps 或升级冲突包；EACCES 权限错误不要用 sudo，应修复 npm 权限；幽灵依赖可用 pnpm 获得更严格解析。pip/poetry/uv 的版本冲突应始终使用虚拟环境；构建失败需检查缺失的系统依赖（如 gcc、python-dev）；wheel 问题可尝试 --no-binary :all: 或更新 pip。
环境搭建最佳实践：隔离环境（venv、nvm、容器）；固定精确版本以便复现；检查 PATH，很多问题源于调用了错误的二进制；安装后验证导入或命令。
平台特定问题：Windows 需注意 260 字符路径上限（启用长路径或缩短路径）、CRLF/LF 行尾配置、原生模块可能需要 Visual Studio Build Tools，并区分 WSL 与原生环境；macOS 许多包需要 Xcode Command Line Tools，需明确 Homebrew 与系统 Python 的区别，M1/M2 ARM 上部分包需 Rosetta 或 ARM 构建；Linux 需检查缺失系统依赖（apt、yum 等）、避免对用户包使用 sudo、链接失败时检查 LD_LIBRARY_PATH。
排障清单：确认确切报错信息、操作系统与版本、包管理器及版本、Node/Python/运行时版本、是全新安装还是升级、最近有何变更。技能还包含累积经验，见 learnings.md。