# Url To Blog

> 當使用者單純貼一個 URL 時，自動詳讀該網址的內容，整理成技術部落格文章。 觸發條件：訊息只有一個或多個 URL，沒有其他指示。 流程：讀內容 → 搜尋相關舊文章 → 問使用者確認方向 → 寫文章。

- Skill: `recca0120/url-to-blog` (Agent Skill)
- Install (CLI): `npx skillmds@latest add recca0120/url-to-blog`
- Raw SKILL.md: https://api.skillmd.com/api/skills/recca0120/url-to-blog/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: recca0120 (https://skillmd.com/u/recca0120)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/recca0120/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 時解析為正確路徑