compress-images

compress-images 技能概览

compress-images 的作用

compress-images 技能会自动完成适合 Web 使用的图片优化：它会接收一个包含 JPG、PNG 或 GIF 文件的目录，保留原图，并输出经过调整的 WebP 版本，以获得更小的文件体积和更好的页面性能。如果你需要一个 compress-images 技能，能把杂乱的图片文件夹变成适合 SEO 和线上发布的素材，而不用逐个手工调参，这正是它要解决的事情。

适合什么场景使用

当你的目标是降低内容页、落地页或博客文章中的图片体积，并且加载速度很重要时，compress-images 最合适。它尤其适用于你已经明确目标文件夹，希望执行一次可重复的压缩流程，而不是泛泛地发一句“优化图片”。

它的不同之处

它的核心区别在于仓库里的流程纪律：会把原图放进 originals/ 子目录，在旁边输出 WebP 结果，并持续迭代直到文件低于目标大小。这让 compress-images 指南不仅适合一次性转换，也适合真正的生产内容流程。

如何使用 compress-images 技能

安装并调用

使用 compress-images install 流程，并按仓库的 CLI 模式执行：
npx skills add rameerez/claude-code-startup-skills --skill compress-images

然后尽可能传入目录参数来调用它。这个技能就是围绕 $ARGUMENTS 设计的；如果你不提供参数，它会默认使用 app/assets/images/content/。

提供正确的输入

compress-images usage 这种用法，最适合你明确指定一个只包含待处理图片、且后续引用可以安全更新的文件夹。好的输入示例是：compress-images ./content/posts/post-42/images。差的输入只是“帮我压缩图片”，因为这个技能需要明确路径和清晰的作用范围边界。

按正确顺序阅读仓库

先看 SKILL.md，因为这里写的是实际的压缩流程和大小目标。然后再查看周边的技能元数据，以及任何链接的仓库文档（如果有）。对这个仓库来说，最关键的判断点是流程规则：保留原图、转换为 .webp、迭代压缩，以及更新内容文件里的引用。

会影响输出的工作流提示

当你想要一个安全的批处理流程时，用这个技能最合适：先把原图移走，再生成压缩后的素材，最后在校验通过后更新引用。为了得到更好的结果，告诉代理图片尺寸是否必须保持不变、小文件是否也需要转换，以及目标目录是内容管理型还是代码管理型。这些信息会影响压缩力度，也会影响它改写引用时该有多谨慎。

compress-images 技能常见问题

compress-images 只用于 WebP 转换吗？

不是。WebP 转换是主要输出，但 compress-images 技能的真正目标，是在保留源文件的前提下减小图片体积，从而更快传输。如果你的技术栈在其他地方仍然需要 PNG 或 JPG，那它可能就不是最合适的选择。

什么时候不该用这个技能？

如果你需要在工作目录里做像素级无损归档保留；如果文件夹里混有不适合批量处理的多种媒体；或者你还没准备好在转换后更新内容引用，都不建议使用。这个技能假设你要做的是一次明确的图片优化处理，而不是随手编辑。

对新手友好吗？

友好，只要你能确定目标目录，并理解原图会被移到 originals/ 里。它比普通提示词更有结构，因此更容易安全地使用；但你仍然需要知道哪些文件应该被纳入处理范围。

它和普通提示词有什么不同？

普通提示词也许能压缩图片，但 compress-images 提供的是一套明确流程：目标文件夹、保留原图、迭代压缩、更新引用。这会让 Image Editing 和站点性能相关任务的结果更可预测。

如何改进 compress-images 技能

明确成功标准

影响质量最大的因素，是你希望代理优先优化什么。这个技能默认把单张图片控制在 100KB 以下，但如果你的页面布局、图片数量或 CMS 约束不同，最好一开始就说明。更强的提示会写清楚文件夹、文件类型，以及 100KB 目标是严格要求还是大致参考。

提供布局和使用场景上下文

当你告诉 compress-images 图片会出现在哪里、对画质有多敏感时，它的表现会更好。首屏大图、产品图和正文内截图，权衡方式完全不同。如果你只说“优化这些图片”，代理就只能猜测到底该保细节还是拼命缩小体积。

注意常见失败模式

主要风险是压缩过头、处理范围不对，以及扩展名变化后引用断裂。为了降低这些风险，可以要求代理报告压缩前后大小、列出移入 originals/ 的文件，并确认更新了哪些引用。这样更容易一次性检查 compress-images guide 的执行结果。

用更清晰的第二轮提示继续迭代

如果第一次输出还是太大或太糊，就用更具体的文件名和可接受的取舍来改进提示。比如：“只重新跑这 3 张首屏大图；保留文字可读性；只有在文件仍高于 100KB 时，才优先牺牲画质换体积。”这样能给 compress-images 技能足够明确的方向，在不盲目重压全部图片的前提下继续优化输出。