defuddle

defuddle skill 概覽

defuddle skill 的功能是什麼

defuddle 可以把一般網頁轉成乾淨、可讀的 markdown，比直接 raw fetch 少掉大量雜訊。它特別適合處理文章、文件、教學、部落格貼文，以及其他 HTML 頁面；這些頁面常常夾帶選單、廣告、側邊欄和導覽元素，不只浪費 token，也會干擾後續分析。

最適合用在 Web Research 的情境

當你的真正目標是閱讀、摘要、比較、引用或分析頁面內容，而不是檢查網站外框或原始 HTML 時，就很適合使用 defuddle for Web Research。它的核心價值在於，先把輸入整理乾淨，再交給後續推理流程。如果使用者給的是一般頁面 URL，而且想直接取得內容，defuddle usage 通常會比泛用的 web fetch 更適合作為起點。

主要限制與不適用情況

最重要的界線其實很簡單：不要把 defuddle 用在以 .md 結尾的 URL。這類頁面本來就是 markdown，直接 fetch 反而更乾淨，也能避免多做一次不必要的轉換。若你需要精確的頁面結構、互動元件、腳本行為，或完整的 DOM 還原度，defuddle 也不是理想選擇。

使用者為什麼會選擇 defuddle

defuddle 真正的差異點，不是「能不能抓到網頁」，而是「能不能快速提供主體文字，而且格式乾淨、token 使用更有效率」。這也是 defuddle skill 很適合研究流程、筆記擷取、文章摘要與文件閱讀的原因：當 markdown 更乾淨時，輸出品質通常也會明顯提升。

如何使用 defuddle skill

defuddle install 與基本指令

如果你要做 defuddle install，repository 指向的是 Defuddle CLI 本體：

npm install -g defuddle

核心指令：

defuddle parse <url> --md

建議固定使用 --md。對大多數研究與分析流程來說，這是最推薦的輸出格式，因為它能移除視覺雜訊，同時保留可閱讀的結構。

defuddle skill 需要哪些輸入

defuddle skill 需要一個頁面 URL，最好再加上清楚的使用意圖。理想的輸入通常包括：

• 精確的 URL
• 你要從這個頁面拿到什麼
• 你要完整 markdown、儲存輸出，還是只要 metadata

例如：

• 「讀這篇文章並摘要主要論點：<url>」
• 「從這個 docs 頁面擷取乾淨的 markdown，並存成 content.md：<url>」
• 「只取得 <url> 的 page title 和 description」

實用指令：

defuddle parse <url> --md -o content.md
defuddle parse <url> -p title
defuddle parse <url> -p description
defuddle parse <url> -p domain

把模糊需求變成有效的 defuddle prompt

弱的請求方式：「幫我看一下這個 URL。」

更好的 defuddle guide prompt：

• 「Use defuddle on <url> with markdown output. Ignore site navigation. Then summarize the key points in 5 bullets and quote the most important section.」
• 「Use defuddle for this documentation page: <url>. Extract markdown, identify setup steps, prerequisites, and caveats, then rewrite them as a checklist.」
• 「Pull only metadata from <url> first. If the title and description match the topic, then extract full markdown.」

這樣效果更好，因為它同時告訴 agent：要怎麼呼叫 defuddle，以及清理完內容後下一步要做什麼。

建議 workflow 與優先閱讀內容

這個 skill 的設計本來就很精簡。請先讀 skills/defuddle/SKILL.md，因為實際可用的 workflow 都在裡面：包含安裝方式、解析指令、輸出格式，以及 metadata properties。實務上建議照這個順序走：

1. 先確認 URL 是一般 HTML 頁面，還是 .md 檔案。
2. 執行 defuddle parse <url> --md。
3. 如果你需要可重複使用的產物，就加上 -o content.md。
4. 如果你只是要做 routing 或 validation，就先用 -p 查 metadata。
5. 再把整理好的 markdown 丟進摘要、資訊擷取或筆記流程。

defuddle skill 常見問題

defuddle 會比一般 prompt 加 fetch 更好嗎？

多半會，尤其是文章型頁面。一般 fetch 往往會帶進 header、footer、cookie notice 和導覽區。defuddle usage 會在分析開始前先改善訊雜比，不但可能降低 token 成本，也能減少因頁面無關元素而造成的摘要錯誤。

什麼情況下不該使用 defuddle skill？

遇到 .md URL、raw 檔案，或你需要精確 HTML、嵌入媒體行為、頁面腳本、版面配置細節時，就應該跳過 defuddle。它是內容擷取工具，不是瀏覽器自動化工具，也不是 DOM 檢查工具。

defuddle skill 對新手友善嗎？

是的。它的指令面非常小：安裝一次後，基本上就用 defuddle parse <url> --md。因此 defuddle skill 很容易上手，即使你的需求只是替研究或筆記整理拿到更乾淨的來源文字也一樣。

defuddle 可以輸出哪些格式？

你可以用 --md 取得 markdown、用 --json 取得 JSON、預設拿到 HTML，或透過 -p <name> 取出特定 metadata。大多數閱讀與研究任務，markdown 都是最好的預設值；而 metadata 模式則很適合用來快速驗證與分流。

如何改進 defuddle skill 的使用效果

給 defuddle 更精準的頁面目標

想提升 defuddle 結果，最簡單的方法就是提供 canonical content page，而不是首頁、搜尋頁或列表頁。文章 URL 和單篇文件頁面，通常會比充滿導覽與重複連結的 hub 頁面產出更乾淨的 markdown。

在同一個請求裡一起說清楚下游任務

當擷取動作和明確的下一步任務一起提出時，defuddle skill 的效果會更好。不要只說「parse 這個」，也可以直接要求：

• summary
• key claims
• setup steps
• FAQs
• quotes
• comparison points

這樣能減少交接上的模糊地帶，也更能讓 agent 依照你真正要完成的工作來組織輸出。

不確定時，先用 metadata 模式再做完整擷取

如果 URL 可能會 redirect、品質偏低，或根本不是你要的頁面，建議先從這些開始：

defuddle parse <url> -p title
defuddle parse <url> -p description
defuddle parse <url> -p domain

這是一個簡單但有效的 defuddle guide 策略：先驗證相關性，再投入完整 markdown 擷取的成本。

常見失敗模式與迭代方式

如果輸出看起來太薄、結構怪異，問題通常出在來源頁面，而不是 CLI。本質上可以先嘗試更精確的 URL、把分類頁改成文章頁，或把 markdown 存下來手動檢查。如果第一次結果太發散，可以重新執行 defuddle for Web Research，並把指令收窄成像是「extract setup steps only」或「quote sections about authentication only」這種更具體的要求。