url-to-blog

# URL → 部落格文章 工作流程 ## 觸發條件 使用者的訊息**只有 URL**，沒有其他說明，就啟動這個流程。 ## 步驟一：詳讀 URL 內容 用 `WebFetch` 讀取每個 URL，prompt 設為： ``` 詳細擷取這篇文章的所有內容：主題、背景、所有技術細節、程式碼範例、結論。 不要摘要，給我完整的技術內容。 ``` 如果是 GitHub repo，額外讀 README 和關鍵原始碼檔案。 > 如果網站擋住（Medium、Stack Overflow 等），根據 URL 和已知知識繼續，在問使用者時說明哪個網址讀不到。 ## 步驟二：搜尋現有相關文章 用 `Grep` 在 `content/post/` 搜尋跟這個主題相關的現有文章： ```bash 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 時解析為正確路徑