read

read 技能總覽

read 的功能

read 技能會抓取網址或 PDF，並回傳乾淨的 Markdown，讓你不用從瀏覽器手動複製，就能檢視、 উদ্ধ引、引用或再利用網頁內容。它就是為 read 工作流程設計的：先把連結轉成可讀文字，除非你之後特別要求，否則先不做分析。

這個技能最適合什麼情境

當你的真正需求是「讀這個頁面」或「擷取這份文件」時，就該用 read 技能，尤其適合付費牆頁面、JS 很重的網站、PDF、X/Twitter 連結，以及微信、飛書等常見中文平台。如果你在 Workflow Automation 裡，需要先穩定擷取內容，再進行摘要、翻譯、比較或保存，它會是很合適的選擇。

它和其他方法有什麼不同

read 的主要差異在於路由邏輯：它會依來源選擇抓取方式，而不是硬套單一通用提示詞。這一點很重要，因為 GitHub、PDF 網址、微信文章和本機檔案通常需要不同處理方式。它也特別強調隱私分級與預設不分析，讓下游自動化更可預期。

如何使用 read 技能

安裝 read 技能

使用 npx skills add tw93/Waza --skill read 安裝。安裝後，先閱讀 SKILL.md，再查看 references/read-methods.md 和 references/save-paths.md，了解實際的抓取與儲存規則。如果你需要平台專屬行為，請檢查 scripts/fetch.sh, scripts/fetch_weixin.py, scripts/fetch_feishu.py, 和 scripts/fetch_local.py。

提供正確的輸入

read 技能最適合單一、直接的目標：一個 URL、一個 PDF 連結，或一個本機 PDF 路徑。如果你想要高品質輸出，請明確說出來源與你要的結果，不要只說「讀這個」。更好的提示像是：「讀取這篇微信文章，只輸出 Markdown。」或「抓取這份 PDF，並保留標題結構以利引用。」

善用路由邏輯

如果目標是 GitHub 內容，當你想要乾淨的原始內容擷取時，優先使用 raw 檔案 URL 或 gh。對 mp.weixin.qq.com，系統會先走 proxy 串接，再以微信腳本作為 fallback。對 x.com 或 twitter.com，請使用 proxy 路線；對本機 PDF，則應走擷取路徑。這套路由機制，就是 read usage 相對於通用瀏覽器提示詞的核心優勢。

先讀取，再決定要不要儲存

預設情況下，read 會直接把內容顯示在畫面上，而不是存成檔案。只有在你明確需要 Markdown 成品時，才要求儲存，並使用像 ~/Downloads/{title}.md 這種以標題命名的路徑。如果你要把 read 串進研究或自動化流程，先確認下一步預期的是「只顯示」還是「已儲存檔案」。

read 技能 FAQ

read 只是通用抓取提示詞嗎？

不是。通用提示詞可以要求頁面文字，但 read 包含依來源路由、重視隱私的抓取分級，以及平台專屬腳本。這能降低標準瀏覽器擷取在某些頁面上容易失敗的機率。

什麼時候不該用 read？

如果內容已經是 repo 裡的純文字，而且不需要從網路抓取，就不要用 read。如果你想要的是評論、解讀，或在來源文字真正抓下來之前就先摘要，也不是它的正確用途。

read 對初學者友善嗎？

是，只要你有 URL 和明確目標就行。初學者最常犯的錯，是只說「幫我看這個連結」卻沒有講清楚你要 Markdown 輸出、要儲存成檔案，還是要後續分析。read 的操作邏輯很簡單，但輸入一定要具體。

read 適合 Workflow Automation 嗎？

適合，尤其是下一步依賴乾淨來源文字的時候。它很適合自動化流程：先收集文章、PDF 或平台貼文，再進行標記、摘要、翻譯或歸檔。如果你的工作流需要可預測的來源擷取，read 是很實用的前端技能。

如何改進 read 技能

提供更好的來源脈絡

最有用的輸入優化是把來源講清楚：提供完整 URL、註明是 PDF 還是網頁，並說明是否可能遇到登入牆、中文平台或 GitHub 檔案等棘手內容。你對來源描述得越清楚，技能就越不容易選到較弱的路徑。

一開始就說明輸出限制

如果你只要 Markdown，就直接說明。如果你要儲存內容，也要在抓取前先講。如果你需要適合引用的格式，請要求盡量保留標題與連結。這些限制比額外解釋更重要，因為 read 的設計目的就是輸出來源文字，而不是解讀內容。

注意常見失敗模式

常見的失敗模式包括：走錯路由、把只適用本機的抓取方式拿去處理 JS 很重的頁面，或是還沒抓到來源就先要求 read 做摘要。另一個常見問題，是遇到被封鎖或內容空白的頁面，卻沒有切換到 proxy 路線。這種情況通常要修正來源選擇，而不是把提示詞寫得更長。

從抓取到後續分析逐步迭代

好的 read 工作流程是先抓取，再用第二個提示詞做分析、擷取或比較。如果第一次輸出太雜，就調整來源或指定平台；如果結構不完整，就改用不同的抓取方式或儲存路徑。對 read usage 來說，小幅調整提示詞，往往比反覆改寫同一句要求更有效。