compress-images

compress-images 技能概覽

compress-images 的用途

compress-images 技能會自動化網站用圖的圖片最佳化：它會接收一個包含 JPG、PNG 或 GIF 檔案的資料夾，保留原始檔，並輸出針對更小檔案體積與更佳頁面效能調校過的 WebP 版本。如果你需要一個 compress-images 技能，把雜亂的圖片資料夾整理成適合 SEO 與上線使用的素材，而且不想逐一手動調每個檔案，這正是為這個工作而設計的。

這個工作流程最適合什麼情境

當你的目標是降低內容頁、登陸頁或部落格文章的圖片負擔，而且載入速度很重要時，就適合用 compress-images。它最有用的情境，是你已經知道目標資料夾在哪裡，並且想要一套可重複執行的壓縮流程，而不是一個泛泛的「幫我最佳化圖片」提示。

它和一般作法有什麼不同

關鍵差異在於這個 repo 的流程紀律：它會把原始檔保存在 originals/ 子資料夾中，把 WebP 輸出寫在旁邊，並持續迭代直到檔案低於指定大小門檻。這讓 compress-images 指南不只是一次性的格式轉換，而是能直接用在正式內容工作流中的實用做法。

如何使用 compress-images 技能

安裝並呼叫它

請使用 compress-images install 流程與 repo 的 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。不好的輸入則只是「幫我壓縮圖片」，因為這個技能需要明確路徑與清楚的範圍邊界。

依正確順序閱讀 repo

先看 SKILL.md，因為它包含實際的壓縮流程與大小目標。接著再檢查周邊的 skill metadata，以及任何有連結的 repo 文件（如果有的話）。對這個 repo 來說，最重要的決策點是流程規則：保留原始檔、轉成 .webp、以迭代方式壓縮，並更新內容檔中的引用。

會影響輸出的工作流建議

當你想要的是安全的批次工作流時，就用這個技能：先把原始檔移到一旁，再產出壓縮後的素材，最後在驗證後更新引用。若想要更好的結果，請先告訴 agent 圖片尺寸是否必須維持不變、小檔案是否仍要轉檔，以及目標資料夾是由內容系統管理還是程式碼管理。這些細節都會影響它壓縮的積極程度，以及改寫引用時的謹慎程度。

compress-images 技能 FAQ

compress-images 只用來轉成 WebP 嗎？

不是。轉成 WebP 是主要輸出，但 compress-images 技能真正的目的，是在保留來源檔的前提下，降低圖片重量以加快傳遞速度。如果你的技術棧在其他地方仍需要 PNG 或 JPG，這可能就不是最適合的選擇。

什麼情況下不該用這個技能？

如果你需要在工作目錄中做像素級、可長期封存的完整保留，或者資料夾裡混有不該批次處理的多媒體檔，或你還沒準備好在轉檔後更新內容引用，就不建議使用。這個技能假設的是有意識的圖片最佳化流程，而不是隨手編修。

這適合新手嗎？

適合，只要你能辨識目標資料夾，並理解原始檔會被移到 originals/。它比單純的提示詞更有結構，因此能更安全地使用；但你仍然需要知道哪些檔案應該被納入處理範圍。

這和一般的泛用提示詞有什麼不同？

一般提示詞也許能壓縮圖片，但 compress-images 提供的是一套明確流程：指定目標資料夾、保留原始檔、迭代壓縮，以及更新引用。這讓 Image Editing 與網站效能相關工作更可預測，也更容易落地。

如何改進 compress-images 技能

明確指定成功門檻

影響品質最大的因素，是你希望 agent 優化到什麼標準。這個技能預設每張圖低於 100KB，但如果你的版面、圖片數量或 CMS 限制不同，請一開始就說明。更好的提示詞會直接寫出資料夾、檔案類型，以及 100KB 目標是必須嚴格達成還是可接受近似值。

補充版面與用途的上下文

當你告訴 compress-images 圖片會出現在什麼地方、以及視覺保真度有多重要時，它的表現會更好。Hero 圖、商品照和內文截圖，各自該怎麼取捨都不同。如果你只說「幫我最佳化這些圖片」，agent 只能猜是要保細節，還是要拼命縮小檔案。

注意常見失誤模式

主要風險包括過度壓縮、處理範圍抓錯，以及副檔名變更後引用壞掉。要降低這些風險，可以要求 agent 回報壓縮前後大小、列出移入 originals/ 的檔案，並確認哪些引用已被更新。這樣就能讓 compress-images guide 更容易一次驗證完成。

用更清楚的第二輪指令迭代

如果第一次輸出還是太大，或畫質太軟，可以在第二輪把沒達標的具體檔案與可接受的取捨講清楚。例如：「只重新跑這三張 hero 圖；保持文字可讀；只有在檔案仍高於 100KB 時，才優先犧牲畫質換取更小尺寸。」這樣就能給 compress-images skill 足夠明確的方向，讓它精修輸出，而不是盲目重壓全部檔案。