用途:对项目运行本地、确定性的性能审计,适合在用户提出“audit performance”“check bundle size”等需求时使用。所有脚本输出 JSON 到 stdout,仅使用标准 Unix 工具,零网络调用。
主要能力:
- 完整审计(入口):并行运行全部审计,生成带健康分(0-100)的统一报告。用法:bash <skill-path>/scripts/full-audit.sh /path/to/project,返回 health_score、image_audit、bundle_audit、dep_audit。
- 图片审计:扫描过大图片、缺失的下一代格式与尺寸信息。用法:bash <skill-path>/scripts/image-audit.sh /path/to/project。超过 500KB 标记为过大;macOS 上用 sips 获取尺寸;报告没有 WebP/AVIF 等价版本的图片。
- 打包审计:分析构建输出目录(.next、dist、build、out)中的 JS 与 CSS 体积。用法:bash <skill-path>/scripts/bundle-audit.sh /path/to/project。报告每个打包文件的原始与 gzip 后大小;标记生产环境中的 source map。需要已有构建产物,若未找到需先运行项目构建命令。
- 依赖审计:检查 package.json 中已知的臃肿依赖并建议更轻替代。用法:bash <skill-path>/scripts/dep-audit.sh /path/to/project。对照精选的重型包列表(moment、lodash、jquery、完整图标库等),建议可 tree-shaking 或更轻的替代。
工作流:先运行 full-audit.sh 获取基线健康分,再查看各子审计的具体问题,修复(优化图片、替换依赖、配置 tree-shaking),重新运行 full-audit.sh 衡量改进,并在完成报告中包含前后分数。
限制:仅本地运行、无网络调用;打包审计依赖已有构建输出;图片尺寸检测在 macOS 上使用 sips。其他平台行为、安装方式与收费信息暂未提供。