url-to-blog

name	url-to-blog
description	當使用者單純貼一個 URL 時，自動詳讀該網址的內容，整理成技術部落格文章。 觸發條件：訊息只有一個或多個 URL，沒有其他指示。 流程：讀內容 → 搜尋相關舊文章 → 問使用者確認方向 → 寫文章。
allowed-tools	Read, Write, Edit, Bash, Glob, Grep, WebFetch

URL → 部落格文章 工作流程

觸發條件

使用者的訊息只有 URL，沒有其他說明，就啟動這個流程。

步驟一：詳讀 URL 內容

用 WebFetch 讀取每個 URL，prompt 設為：

詳細擷取這篇文章的所有內容：主題、背景、所有技術細節、程式碼範例、結論。
不要摘要，給我完整的技術內容。

如果是 GitHub repo，額外讀 README 和關鍵原始碼檔案。

如果網站擋住（Medium、Stack Overflow 等），根據 URL 和已知知識繼續，在問使用者時說明哪個網址讀不到。

步驟二：搜尋現有相關文章

用 Grep 在 content/post/ 搜尋跟這個主題相關的現有文章：

grep -rl "關鍵字" content/post/

把找到的相關文章記下來，待步驟三詢問，以及步驟四寫作時加入內部連結。

相關文章的處理原則：永遠寫新文章，連結舊的。 不論新舊文章的關係是補充、延伸、同主題不同角度，都寫成獨立新文章， 在新文章裡加內部連結指向舊文章。舊文章有既有排名，讀者讀完新文章自然會跟過去。

步驟三：問使用者確認方向

每次都要問，不要直接動筆。讀完後整理出問題，讓使用者確認再寫。

問題格式：

讀完了。[一句話說明原文的核心主題]

想確認幾個方向再動筆：

1. **文章角度**：[說明你觀察到的可能角度，例如「踩坑記錄 or 工具介紹？」]
2. **你的補充**：有沒有自己遇過的情境或不同做法想加進去？
3. **相關舊文章**：找到 [文章名稱]，新文章會連結過去，這樣 ok 嗎？
   （如果沒找到相關文章，這條跳過）

沒特別意見的話告訴我，我按原文角度寫。

問題精簡，最多 3 個。使用者說「沒意見」或「直接寫」就進行步驟四。

步驟四：寫文章

交棒給 tech-blog-writing skill 跑完整流程（建目錄 → 中/英稿 → 封面 → build → push）。這份 skill 只補充 URL 場景特有的寫作角度原則與相關文章連結規則，其餘全部以 tech-blog-writing 為準。

寫作角度原則

• 用第一人稱改寫，不是翻譯。原文說「you should」→「我習慣這樣做」
• 保留原文的技術細節和程式碼，加入自己的觀點
• 原文程式碼直接用，加中文註解
• 如果原文有過時做法，在文章裡標注

相關文章連結

• 在文章內文的適當位置加內部連結（文中、段落結尾、文末都可以）
• 錨點文字用描述性文字（例如文章標題或主題關鍵字）
• 連結格式一律用 Hugo ref shortcode：[文章標題]({{< ref "/post/slug" >}})
• 中英文版共用同一份 ref，Hugo 會自動解析到對應語系的 URL
• 本站 permalink 為 /:year/:month/:day/:slug/，用 ref 讓 Hugo 於 build 時解析為正確路徑