# 適用於 Claude Code 的 AI 部落格寫作代理技能

> 利用這款適用於 Claude Code 的 AI 部落格寫作代理技能，大規模生成、優化並審核部落格內容。它能產出針對 Google 排名和 AI 引用平台進行雙重優化的文章，確保每次都能提供高品質、SEO 友善的內容。

- Canonical: https://nanoskill.ai/tw/skills/ai-blog-writing-skill
- Markdown: https://nanoskill.ai/tw/skills/ai-blog-writing-skill.md
- Author: AgriciDaniel
- Published: 2026-05-24T06:35:19.314Z
- Updated: 2026-07-25T04:39:13.470Z
- Language: zh-TW
- Source type: github
- Popularity signal: 818

## Sources

- https://github.com/AgriciDaniel/claude-blog

## Install

```shell
npx skills add https://github.com/AgriciDaniel/claude-blog
```

## About

適用於 Claude Code 的 AI 部落格寫作與 SEO 優化技能（簡稱 claude-blog），是一套全面的解決方案，旨在自動化並增強您的內容創作流程。這項強大的技能能大規模撰寫、優化並審核部落格內容，確保每篇文章都針對 Google 搜尋排名和 AI 引用平台精心打造。對於任何希望持續穩定產出高品質、SEO 友善內容的人來說，這都是一款不可或缺的工具。

claude-blog 以其強大的 5 關卡交付合約為特色，透過針對 100 點評分標準為每份草稿打分，並阻止低於 90 分的內容，來保證內容品質。它提供雙重優化，針對 2025 年 12 月核心更新規範以及 Google 的 E-E-A-T 信號，同時也為 ChatGPT 和 Perplexity 等 AI 引用平台準備內容。擁有 30 項子技能、5 個代理和 12 種內容範本，它能處理從研究、大綱到結構化資料生成和引用驗證的整個內容生命週期。

無論您是希望每週產出一篇高品質文章的獨立部落客，還是管理多元內容組合的行銷團隊，或是尋求生產級參考資源的 Claude Code 技能建構者，claude-blog 都能提供量身打造的解決方案。它支援主題群集規劃、多語言發布、基於人物誌的語調設定，並包含關鍵字蠶食偵測和事實查核流程等進階功能，以確保準確性並防止內容衝突。

## Key features

- **5 關交付合約**: 每份草稿都會通過嚴格的 5 關交付合約（能力、格式、視覺、內容審查、資產完整性），並以 100 分評分表評估，任何低於 90 分的內容都不會送到您手中。
- **SEO 與 AI 引用的雙重優化**: 每篇文章都針對 Google 排名（2025 年 12 月核心更新、E-E-A-T）和 AI 引用平台（ChatGPT、Perplexity、AI Overviews）進行優化，最大限度地提高可見度和可引用性。
- **全方位內容生成**: 一個全生命週期的部落格引擎，擁有 30 個子技能、5 個代理和 12 個內容模板，涵蓋研究、大綱、草稿、結構化資料、內部連結和引用驗證，一次調用即可完成。
- **角色驅動寫作與事實查核**: 管理可設定的寫作角色，包含語氣框架和可讀性範圍，以及事實查核流程，根據引用來源驗證統計數據以確保準確性。
- **關鍵字蠶食偵測**: 識別並解決部落格文章之間的關鍵字重疊問題，提供嚴重性評分和建議，防止內容在搜尋引擎結果頁中互相競爭。

## Use cases

- **生成高品質部落格文章**: 個人部落客和創作者每週可以發布一篇高品質文章，無需手動 SEO 檢查清單，涵蓋研究、大綱、草稿、結構化資料、內部連結和引用驗證。
- **為團隊大規模管理內容**: 行銷團隊和代理商可以透過主題叢集規劃、多語言發布和角色驅動的語調設定檔等功能，跨主題和語言管理大量文章。
- **審核並優化現有內容**: 使用此技能分析現有部落格文章，給予 0 到 100 的品質評分，執行寫作後的 SEO 驗證，並偵測整個網站中的關鍵字蠶食現象。

## Result preview

查看由這項代理技能生成的真實清單文章，介紹最佳 AI PPT 工具。

![部落格寫作示範-01](https://file.nanoskill.ai/blog-writing-demo-01)

![blog-writing-demo-02](https://file.nanoskill.ai/blog-writing-demo-02)

![部落格寫作示範-03](https://file.nanoskill.ai/blog-writing-demo-03)

![部落格寫作示範-4](https://file.nanoskill.ai/blog-writing-demo-4)

## Result walkthrough

### 步驟 1：安裝

將技能新增到您的代理。

![部落格文章撰寫步驟 1](https://file.nanoskill.ai/blog-writing-step-1)

### 步驟 2：生成內容

使用特定指令來生成部落格內容。

![部落格寫作步驟-2](https://file.nanoskill.ai/blog-writing-step-2)

### 步驟 3：審查與編輯

審查內容並在生成的 Word 文件中編輯。

![blog-writing-step-03](https://file.nanoskill.ai/blog-writing-step-03)

## Skill definition

# Claude Code 用的 AI 部落格撰寫與 SEO 優化技能 (`claude-blog`)

> **此技能有兩個版本。**選擇適合您工作方式的版本：
>
> - 🌐 **公開開源版**：[`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog)。採用 MIT 授權，公開發佈，開放給任何人使用。如果您想要穩定、可下載且無需會員資格的版本，請使用此版本。
> - 🔒 **社群私有鏡像**（此儲存庫）：[`AI-Marketing-Hub/claude-blog`](https://github.com/AI-Marketing-Hub/claude-blog)。可搶先體驗開發中的功能（v1.9.0+ 部落格交付合約、英雄圖梯、經過突變測試的回歸覆蓋率），並直接與 [AI Marketing Hub Pro](https://www.skool.com/ai-marketing-hub-pro) 社群協作。需要會員資格。
>
> 上述徽章追蹤的是**公開**儲存庫（`AgriciDaniel/claude-blog`），因為私有鏡像無法被 shields.io 看見。發佈工作流程（私有開發、審查、公開發佈）記載於 [`docs/PUBLISHING.md`](docs/PUBLISHING.md)。

> **部落格：**[了解 claude-blog 的運作方式](https://agricidaniel.com/blog/claude-code-blog-writer)

**claude-blog 是一套 Claude Code 技能組合，可大規模地撰寫、優化和審查部落格內容。**

每篇文章都針對 Google 排名（2025 年 12 月核心更新、E-E-A-T）和 AI 引用平台（ChatGPT、Perplexity、AI Overviews）進行雙重優化。v1.9.0 的 5 閘門交付合約會根據 100 分制評分，並阻擋任何低於 90 分的草稿呈現在您面前。

## 重點摘要

- **它是什麼**：一個全生命週期的部落格引擎：30 個子技能、5 個代理人、12 個內容範本、21 個隨需參考文件、9 個根層級 Python 腳本、160 個通過的測試。
- **適合誰**：個人部落客、行銷團隊、代理商，以及需要生產級內容輸出而非一次性草稿的 Claude Code 技能開發者。
- **核心承諾**：每份草稿都通過 5 閘門交付合約（能力、格式、視覺、內容審查、資產完整性），否則寫作器會最多迭代 3 次，然後再升級給您。
- **與眾不同之處**：它以身作則。版本一致性在 14 個表面上強制執行 CI，每次 PR 都進行散文衛生檢查，三個經過突變測試的回歸套件鎖定 v1.9.0 的修正，而且 `blog-reviewer` 是「阻擋性」閘門，而非僅供參考。
- **目前**：v1.9.0，於 2026-05-18 發布。適用於 Next.js MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby 和靜態 HTML。

## claude-blog 適合誰？

claude-blog 用一個引擎服務三種族群：

**個人部落客和創作者**，他們希望每週發佈一篇高品質文章，而不用花三個小時在 SEO 檢查清單上。透過單一 `/blog write` 指令，編排器會處理研究、大綱、草稿、結構化資料、內部連結和引用驗證。

**行銷團隊和代理商**，他們管理跨主題、語言和平台的眾多文章。此技能附帶主題叢集規劃（`/blog cluster`）、多語一言發布（`/blog multilingual`）、關鍵字蠶食偵測（`/blog cannibalization`）和角色驅動的聲音設定檔（`/blog persona`），讓同一個引擎能為整個團隊產出風格一致的內容。

**Claude Code 技能開發者**，他們需要生產級參考，涵蓋技能架構、代理人分派、交付合約和 CI 閘門。此儲存庫展示了 Tier 4 複雜度的 Agent Skills 開放標準，包含 160 個測試、版本一致性強制檢查、安裝程式同步回歸測試，以及 v1.9.0 的 5 閘門合約模式。您可以閱讀原始碼獲取靈感，並將這些模式分支到自己的技能中。

## claude-blog 產出什麼？

每份草稿以單一資料夾中的 8 個成品文件交付。`.md` 輸出的精簡範例：

```markdown
---
title: "Where Should a Claude Code Skill Plugin Install Itself?"
description: "A working answer to the install-path question..."
date: "2026-05-18"
author: "Daniel Agrici"
tags: [claude-code, skills, plugins, installation]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# Where Should a Claude Code Skill Plugin Install Itself?

The short answer: most user-installable Claude Code skill plugins
should ship to `~/.claude/skills/<name>/` for skill content,
`~/.claude/agents/<name>.md` for agents, and
`~/.claude/scripts/<helper>.py` for any Python helpers.

## Key Takeaways
- `~/.claude/skills/` is the SKILL.md surface area.
- `~/.claude/agents/` holds agent markdown files.
- ... (full article, sourced citations, FAQ, schema JSON-LD)
```

除了 `.md` 之外，合約還會產出：渲染後的 `.html`（具備 XSS 安全的 JSON-LD、深色模式感知的 CSS）、`.pdf`（透過 Playwright 或 weasyprint）、`hero.<ext>`（1200x630，透過 Banana MCP、Gemini、圖庫 API 或 Openverse 生成）、3 種視埠截圖（`mobile-375.png`、`tablet-768.png`、`desktop-1280.png`）、`review.md`（5 類評分卡，附帶「阻擋」行），以及 `preflight-report.json`（完整的稽核軌跡）。

## 目錄

- [展示](#demo)
- [快速開始](#quick-start)
- [指令](#commands)
- [claude-blog 比較起來如何？](#how-does-claude-blog-compare)
- [功能](#features)
- [交付合約（v1.9.0）](#delivery-contract-v190)
- [架構](#architecture)
- [需求](#requirements)
- [常見問答](#frequently-asked-questions)
- [路線圖](#roadmap)
- [解除安裝](#uninstall)
- [整合](#integration)
- [文件](#documentation)
- [如何引用](#how-to-cite)
- [安全性與行為準則](#security--code-of-conduct)
- [貢獻](#contributing)
- [授權](#license)
- [相關專案](#related-projects)
- [作者](#author)

## 展示

[在 YouTube 觀看展示](https://www.youtube.com/watch?v=AeLC4iutG8w)

<p align="center">
  <img src="https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/assets/blog-command-demo.gif" alt="claude-blog 指令展示：透過編排器路由 /blog 子指令" width="100%">
</p>

---

## 快速開始

> ℹ️ **您要安裝哪個版本？**
>
> - **不是 AI Marketing Hub Pro 會員嗎？** 從公開儲存庫安裝：[`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog)。以下所有安裝指令在那裡都適用。只需將 `AI-Marketing-Hub/claude-blog` 換成 `AgriciDaniel/claude-blog`，並將外掛代稱 `claude-blog@ai-marketing-hub-claude-blog` 換成 `claude-blog@agricidaniel-claude-blog`。公開發佈的版本在那裡；這個私有鏡像進度更快。
> - **Pro 會員嗎？** 下列指令安裝的是**社群版本**，可搶先體驗開發中的功能。需要已驗證的 `gh auth login`（或 GitHub PAT）工作階段，且能存取 `AI-Marketing-Hub` 組織。如果 `/plugin marketplace add` 失敗並顯示 404，表示您的帳戶尚未加入該組織。請在 [Skool 社群](https://www.skool.com/ai-marketing-hub-pro) 內發送私訊以加入。

**外掛安裝（Claude Code 1.0.33+）：**

```bash
# Add marketplace (one-time)
/plugin marketplace add AI-Marketing-Hub/claude-blog

# Install plugin
/plugin install claude-blog@ai-marketing-hub-claude-blog
```

**建議：複製、驗證、然後安裝**（讓您能檢查 `install.sh` 並釘選發行標籤）：

```bash
git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0          # pin to a release tag (latest as of 2026-05-18)
chmod +x install.sh && ./install.sh
```

**一指令安裝（Unix/macOS）：**

```bash
curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash
```

**一指令安裝（Windows PowerShell）：**

```powershell
irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.ps1 | iex
```

> 將 `curl` 或 `irm` 管線傳給 shell 會賦予腳本在您機器上的執行權限。先複製再 checkout 標籤的流程較為安全，因為您可以檢查會執行的內容。兩種流程都使用您現有的 `gh auth` / GitHub 憑證來對私有儲存庫進行身份驗證。

**驗證安裝程式完整性（建議，VULN-IAC-001 強化）：**

```bash
# Download, verify SHA-256, then run if the hash matches.
curl -fsSL -o install.sh https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh
echo "029388e448dd29bed259b130c2be42e2f6a16d4d5b6801a61bfb4f49b621fc04  install.sh" | sha256sum -c
bash install.sh
```

上述的 SHA-256 是針對 `main` 分支上 HEAD 的當前 `install.sh`。執行前請對照[官方檔案](https://github.com/AI-Marketing-Hub/claude-blog/blob/main/install.sh)進行驗證。`install.ps1` 的對應雜湊值為 `6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98`。每當安裝程式有變更時，本 README 中的雜湊值都會隨之更新。

安裝後重新啟動 Claude Code 以啟用。

## 指令

> 🚀 **第一次使用嗎？先試試這三個指令**：`/blog strategy <niche>` 來規劃部落格主題，`/blog write <topic>` 來生成第一篇文章（5 閘門合約會自動執行），以及 `/blog analyze <file>` 來根據 100 分制評分。

<p align="center">
  <img src="https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/assets/blog-write-demo.gif" alt="claude-blog /blog write 展示：端到端的文章生成，搭配 5 閘門交付合約" width="100%">
</p>

<p align="center">
  <img src="https://file.nanoskill.ai/03-sub-skill-map-B-6.svg" alt="claude-blog 子技能生態系統：中心是編排器樞紐，30 個子技能組織成 8 個主題群（寫作、策略、品質、AI 與搜尋、多語言、研究、媒體、分發）；面板大小根據技能數量自動縮放" width="100%">
</p>

| 指令 | 說明 |
|---------|-------------|
| `/blog write <topic>` | 全新撰寫部落格文章 |
| `/blog rewrite <file>` | 優化現有部落格文章 |
| `/blog analyze <file>` | 品質稽核，0-100 分 |
| `/blog brief <topic>` | 產出詳細內容簡報 |
| `/blog calendar` | 產出編輯行事曆 |
| `/blog strategy <niche>` | 部落格策略與主題發想 |
| `/blog outline <topic>` | 以 SERP 為依據的內容大綱 |
| `/blog seo-check <file>` | 寫作後 SEO 驗證 |
| `/blog schema <file>` | 產出 JSON-LD Schema 標記 |
| `/blog repurpose <file>` | 為社群、郵件、YouTube 進行內容再利用 |
| `/blog geo <file>` | AI 引用準備度稽核 |
| `/blog image [generate\|edit\|setup]` | 透過 Gemini 進行 AI 圖片產生 |
| `/blog audit [directory]` | 全站部落格健康評估 |
| `/blog cannibalization [directory]` | 偵測文章間的關鍵字重疊 |
| `/blog factcheck <file>` | 驗證統計數據是否符合引用來源 |
| `/blog persona [create\|list\|apply]` | 管理寫作角色和聲音設定檔 |
| `/blog taxonomy [sync\|audit\|suggest]` | 標籤/分類 CMS 管理 |
| `/blog notebooklm <question>` | 查詢 NotebookLM 進行來源紮實的研究 |
| `/blog audio [generate\|voices\|setup]` | 透過 Gemini TTS 產出語音旁白 |
| `/blog google [command] [args]` | Google API 資料：PSI、CrUX、GSC、GA4、NLP、YouTube、關鍵字 |
| `/blog cluster [plan\|execute] <seed>` | 語意主題叢集規劃 + 執行（軸輻式） |
| `/blog multilingual <topic> --languages <codes>` | 一指令寫作、翻譯、在地化並產出 hreflang |
| `/blog translate <file> --to <codes>` | SEO 優化的翻譯，保留格式 |
| `/blog localize <file> --locale <code>` | 針對每個地區進行深度文化調適 |
| `/blog locale-audit <directory>` | 多語言內容 QA（完整性、hreflang、一致性、新鮮度） |
| `/blog flow [find\|optimize\|win\|prompts\|sync]` | FLOW 框架提示（證據導向，30 個適用於部落格） |
| `/blog brand [init\|show\|update]` | 產出 BRAND.md + VOICE.md 內容，供所有子技能自動載入 |
| `/blog discourse <topic>` | 無需 API 的最近 30 天討論研究；產出 DISCOURSE.md |

> **總共 30 個子技能目錄**：29 個可由使用者調用（28 個不同的斜線指令 + `/blog update` 是 rewrite 的別名）+ 1 個僅供內部使用（`blog-chart`，由 blog-write/blog-rewrite 調用於內嵌 SVG 圖表）。`blog-image` 可由使用者調用，同時也能內部呼叫。

## claude-blog 比較起來如何？

claude-blog 是一個結構化的管道。直接 LLM 提示是一次性的。託管的 SaaS 工具是閉源的。以下是誠實的取捨矩陣：

| 能力 | claude-blog | 直接 Claude / ChatGPT 提示 | Copy.ai / Jasper | 自己打造 |
|---|:---:|:---:|:---:|:---:|
| 一指令寫全文，附帶迭代迴圈 | ✅（5 閘門合約，最多重試 3 次） | ⚠️ 一次性 | ✅ | ❌ |
| 附驗證的來源統計 | ✅ `/blog factcheck` 取得來源網址 | ❌ 產生幻覺 | ❌ | ⚠️ 手動 |
| AI 引用最佳化（GEO / AEO） | ✅ 專用 `/blog geo` 稽核 | ❌ | ❌ | ⚠️ |
| 阻擋性內容審查（分數 >= 90 才交付） | ✅ `blog-reviewer` 代理人 | ❌ | ❌ | ❌ |
| 多語言 + hreflang 一指令完成 | ✅ `/blog multilingual` | ⚠️ 無 hreflang | ⚠️ | ❌ |
| 主題叢集規劃（軸輻式） | ✅ `/blog cluster` | ❌ | ⚠️ | ❌ |
| 語音旁白 | ✅ Gemini TTS，30 種聲音 | ❌ | ❌ | ❌ |
| 英雄圖生成（4 階梯流程） | ✅ Banana、Gemini、圖庫、Openverse | ❌ | ⚠️ 僅限圖庫 | ⚠️ |
| 持續的品牌與聲音脈絡 | ✅ 自動載入 BRAND.md + VOICE.md | ❌ 每次提示 | ⚠️ 有限 | ❌ |
| 開源，MIT，無使用成本 | ✅ 免費 | ❌ 訂閱制 | ❌ 訂閱制 | ✅ |

claude-blog 並非在每方面都更出色。對於一次性的丟棄式草稿，直接提示更快。對於非開發人員，託管 SaaS 更容易。DIY 對於獨特的工作流程更加靈活。claude-blog 適合那些希望在不使用 SaaS 訂閱的情況下，大規模生產專業級內容的場合。

## 功能

### 12 種內容範本
根據主題和意圖自動選擇：操作指南、清單文、案例研究、比較、支柱頁、產品評論、思想領導力、懶人包、教學、新聞分析、數據研究、常見問答知識庫。

### 5 類品質評分（100 分制）
| 類別 | 分數 | 重點 |
|----------|--------|-------|
| 內容品質 | 30 | 深度、可讀性、原創性、互動性 |
| SEO 最佳化 | 25 | 標題、標題標籤、關鍵字、連結、 meta |
| E-E-A-T 信號 | 15 | 作者、引用、信任感、經驗 |
| 技術元素 | 15 | Schema、圖片、速度、行動版、OG 標籤 |
| AI 引用準備度 | 15 | 可引用性、問答格式、實體清晰度 |

評分區間：卓越 (90-100)、強勁 (80-89)、可接受 (70-79)、低於標準 (60-69)、需重寫 (<60)。v1.9.0 合約阻擋低於 90 分的交付。

### AI 內容偵測
針對句子長度變化的突發性評分、已知 AI 用語偵測（17 個片語）和詞彙多樣性（TTR）。在內容送到審查員之前，標示讀起來像機器生成的內容。

### 角色驅動寫作
可設定的寫作角色，搭配 NNGroup 四維度語氣框架（正式/隨性、嚴肅/有趣、尊重/不敬、就事論事/熱情）。管理每個部落格或作者的聲音設定檔，附帶可讀性區間（消費者、專業人士、技術性）以及在草稿階段強制執行風格。

### 事實查核管道
`/blog factcheck` 會擷取每個引用的來源網址，並將聲明信心度評分為完全相符、改寫或找不到。確保每個資料點都準確且可追溯，而非憑空杜撰。

### 關鍵字蠶食偵測
`/blog cannibalization` 使用本地 grep 分析或 DataForSEO API 來識別部落格文章間的關鍵字重疊。嚴重性評分搭配合併或區分建議，防止文章在 SERP 中互相競爭。

### CMS 分類管理
標籤和類別同步，支援 WordPress REST、Shopify GraphQL、Ghost、Strapi 和 Sanity。包含標籤建議、同步和稽核工作流程。

### 雙重最佳化
每篇文章都同時瞄準 Google 排名和 AI 引用平台：
- **Google**：符合 2025 年 12 月核心更新、E-E-A-T 信號、schema 標記、內部連結、透過 blog-google 掌握 Core Web Vitals。
- **AI 引用**：答案優先格式、引用膠囊、段落級可引用性（120-180 字區塊）、FAQ schema、實體清晰度。

### 視覺媒體
- 從 Pixabay、Unsplash 和 Pexels 取得圖片，附帶 HTTP 200 驗證和自動生成的 alt 文字。
- 透過 Gemini 生成 AI 圖片，用於英雄圖、內嵌插圖和社群卡片。需使用免費的 Google AI API 金鑰。
- 內建 7 種樣式的 SVG 圖表產生（長條圖、分組長條圖、棒棒糖圖、圓環圖、折線圖、面積圖、雷達圖）。
- YouTube 影片嵌入，具備 `srcdoc` 延遲載入和 noscript AI 爬蟲後備方案。
- 圖片密度目標根據內容類型進行校準。

### Google API 整合（v1.6.5+）
橫跨 4 個憑證層級的 13 個指令，正常使用皆為免費：
- **層級 0**（API 金鑰）：PageSpeed Insights、CrUX Core Web Vitals（25 週歷史記錄）、YouTube 影片搜尋、NLP 實體分析。
- **層級 1**（OAuth）：Search Console 成效、URL 檢查、Indexing API。
- **層級 2**（GA4）：自然流量報表。
- **層級 3**（Ads）：Google Ads 關鍵字規劃工具。

### NotebookLM 研究
查詢 Google NotebookLM，從使用者上傳的文件中進行來源紮實的研究。層級 1 資料品質，零幻覺風險，因為答案是從您上傳的文件中擷取的。

### 語音旁白
`/blog audio` 透過 Gemini TTS 產生語音旁白。三種模式：摘要（200-300 字）、全文、雙人對話。30 種聲音，80 多種語言。

### 平台支援
Next.js MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby 和靜態 HTML。

### 基礎方法論（v1.8.0）
`skills/blog/references/` 下有五份參考文件，定義了應用於所有子技能的編輯和研究方法論。它們由編排器隨需載入：

| 參考文件 | 用途 | 使用對象 |
|---|---|---|
| `ai-slop-detection.md` | 兩層式第一階（片語）+ 第二階（結構節奏）AI 內容偵測 | `blog-rewrite`、`blog-reviewer`、`blog-analyze` |
| `editorial-heuristics.md` | 10 項 Nielsen 調適的啟發法，附 0-4 評分 + P0-P3 嚴重性標記 | `blog-analyze --rubric` |
| `cognitive-load.md` | 每節概念密度（實體、數字、術語、向前引用、子句深度） | `blog-analyze --cognitive-load`、`scripts/cognitive_load.py` |
| `research-quality.md` | 5 維度研究評鑑 + 4 種預檢關鍵字陷阱類別 + 新鮮度門檻 | `blog-researcher`、`blog-discourse`、`blog-brief`、`blog-strategy` |
| `synthesis-contract.md` | 6 條研究綜合法則（禁止末尾「來源」區塊、行內引用等） | 所有研究綜合子技能 |

改編自 `pbakaus/impeccable`（Apache 2.0）和 `mvanhorn/last30days-skill`（MIT）。請參閱 [`CONTRIBUTORS.md`](CONTRIBUTORS.md) 以了解歸屬。

### FLOW 框架

FLOW 框架（Find、Leverage、Optimize、Win）是與 [`AgriciDaniel/flow`](https://github.com/AgriciDaniel/flow) 共用的證據導向工作流程（CC BY 4.0）。每個階段都會對編排器管道貢獻提示；`/blog flow` 暴露了 30 個隨時可執行的提示，按階段索引。

<p align="center">
  <img src="https://file.nanoskill.ai/04-framework-B-7.svg" alt="FLOW 框架放射狀輪盤：四個階段（Find 用於主題發現、Leverage 用於資產放大、Optimize 用於內容改善、Win 用於讀者轉換）圍繞中心樞紐排列，外環有 10 個代表性提示" width="100%">
</p>

## 交付合約（v1.9.0）

<p align="center">
  <img src="https://file.nanoskill.ai/02-pipeline-A-8.svg" alt="5 閘門部落格交付合約管道：能力發現、格式完整性、視覺驗證、內容審查（阻擋性閘門，分數必須達到 90 分以上且沒有任何 P0 問題）以及資產與連結完整性。失敗時最多迭代 3 次，然後升級給使用者" width="100%">
</p>

每篇部落格文章在顯示給使用者之前，都會通過 5 閘門合約。使用者永遠不會是第一位審查者；閘門才是。

| 閘門 | 執行內容 | 實作方式 |
|---|---|---|
| 1. 能力發現 | 寫作前所需的工具和代理人就緒 | `scripts/blog_preflight.py --gate 1` |
| 2. 格式完整性 | `.md` + `.html` + `.pdf` + 真實的英雄圖 | `scripts/blog_render.py`、`scripts/generate_hero.py` |
| 3. 視覺驗證 | 無 SVG 溢出、有效的 JSON-LD、深色模式渲染正確 | `patchright` / `playwright` 在三種視埠寬度 |
| 4. 內容審查（阻擋） | `blog-reviewer` 分數 90+ 且無任何 P0 問題 | `agents/blog-reviewer.md`（阻擋，v1.9.0） |
| 5. 資產 + 連結完整性 | 每個 img 都正確解析、og:image 存在、連結回傳 200、字數差異在 5% 內 | `scripts/blog_preflight.py --gate 5` |

英雄圖階梯：Banana MCP、直接 Gemini API、進階圖庫（Unsplash、Pexels、Pixabay）、Openverse 公共 API。先可用的勝出。任何閘門失敗時，阻擋並最多迭代 3 次，然後升級給使用者。完整規格：[`skills/blog/references/blog-delivery-contract.md`](skills/blog/references/blog-delivery-contract.md)。

## 架構

<p align="center">
  <img src="https://file.nanoskill.ai/01-architecture-B-7.svg" alt="claude-blog 系統架構：從使用者指令經由編排器路由、子技能執行和代理人分派，到 5 閘門交付合約，最終傳遞給使用者的由左至右管道" width="100%">
</p>

claude-blog 以一個編排器加上 29 個子技能、5 個代理人、21 份參考資料、12 個範本和 9 個根層級腳本的形式發佈。編排器將使用者指令路由到子技能，子技能再衍生代理人並透過 Bash 呼叫腳本。

| 層級 | 數量 | 位置 |
|---|---:|---|
| 子技能（可由使用者調用） | 29 | `skills/blog-*/SKILL.md` |
| 子技能（內部使用） | 1 | `skills/blog-chart/SKILL.md` |
| 專用代理人 | 5 | `agents/blog-*.md` |
| 隨需參考資料 | 21 | `skills/blog/references/*.md` |
| 內容範本 | 12 | `skills/blog/templates/*.md` |
| 根層級 Python 腳本 | 9 | `scripts/*.py` |
| 測試 | 160 | `tests/test_*.py` |

完整目錄樹、資料流程圖、評分方法論和擴充點：[`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)。

## 需求

- 已安裝並設定好的 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI。
- Python 3.11+（用於品質評分、5 閘門交付合約執行器和程式碼檢查）。
- 選擇性：`pip install -r requirements.txt` 以進行進階分析（可讀性評分、schema 偵測）。

### 品質閘門（每個 PR 上由 CI 強制執行）

1. **pytest**：跨安全性、行為、回歸和交付合約套件的 160 項測試。
2. **外掛驗證**：`claude plugin validate .` 加上手工製作 JSON/正規表示式檢查。
3. **過期路徑檢查**：捕捉 `references/` 和 `templates/` 交叉引用中的漂移。
4. **散文衛生**：`scripts/lint_prose.py`（會區分程式碼區塊和反引號）強制執行 CONTRIBUTING.md 中的禁止長破折號、短破折號和 ` -- ` 的規則。
5. **版本一致性**：`tests/test_version_coherence.py` 斷言 `pyproject.toml`、`plugin.json`、`CITATION.cff` 和 `skills/blog/SKILL.md` 的前置資料全部相符。
6. **指令一致性**：`tests/test_command_coherence.py` 斷言 `skills/blog/SKILL.md` 和 `docs/COMMANDS.md` 宣告相同的指令集。

推送前先在本地端執行：
```bash
python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .
```

## 常見問答

### claude-blog 是什麼？
claude-blog 是一套用於寫作、最佳化和審查部落格內容的 Claude Code 技能組合。它透過 5 閘門交付合約運行 30 個子技能和 5 個代理人，以確保每篇文章在送到您面前之前都達到 90/100 的品質標準。

### claude-blog 與直接向 Claude 或 ChatGPT 下提示有何不同？
直接提示是透過一個提示給您一份草稿。claude-blog 提供一個結構化管道：附來源統計的研究、大綱核准、草稿產生、多輪品質評分、AI 內容偵測、事實查核、schema 注入，以及在交付前最多迭代 3 次的阻擋性審查。此技能能強制執行資深編輯原本需手動完成的工作。

### 我需要 AI Marketing Hub Pro 會籍才能使用 claude-blog 嗎？
不需要。在 [`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog) 的公開開源版本採用 MIT 授權，任何擁有 Claude Code 的人皆可免費使用。位於 `AI-Marketing-Hub/claude-blog` 的私有鏡像是專為希望搶先體驗開發中功能並與社群直接協作的 Pro 會員所設。

### claude-blog 支援哪些部落格平台？
Next.js MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby 和靜態 HTML。編排器會根據專案信號自動偵測平台，並相應調整前置資料、圖片嵌入和 schema 注入。

### claude-blog 會憑空杜撰統計數據嗎？
不會。每個引用的統計數據都會透過 `/blog factcheck` 流程，該指令會擷取來源網址並對聲明信心度進行評分（完全相符、改寫、找不到）。如果引用無法驗證，或 AI 內容偵測將散文標記為機器生成，`blog-reviewer` 代理人就會阻擋發佈。

### 什麼是 5 閘門部落格交付合約？
一個由程式碼強制執行的展示前管道，在每份草稿上運行：能力發現、格式完整性、在三種視埠寬度下的視覺驗證、內容審查（阻擋性；分數需達 90+ 且無 P0 問題），以及資產與連結完整性。編排器在任何閘門失敗時會讓寫作器最多迭代 3 次，然後再升級給您。完整規格在 [`skills/blog/references/blog-delivery-contract.md`](skills/blog/references/blog-delivery-contract.md)。

### 我可以用多種語言使用 claude-blog 嗎？
可以。`/blog multilingual <topic> --languages en,de,fr,es,ja` 會撰寫文章、在保留前置資料和 schema 的情況下進行翻譯、針對每個地區執行深度文化調適，並在單一指令中產出 hreflang 標籤和一個可供 CMS 使用的語言對照表。

### 如何在學術工作中引用 claude-blog？
請參閱下方的[如何引用](#how-to-cite)章節，或儲存庫根目錄中的 [`CITATION.cff`](CITATION.cff) 檔案。GitHub 會在公開鏡像頁面上透過「Cite this repository」按鈕展示結構化的引用檔案。

### 安裝 claude-blog 安全嗎？
安裝程式僅包含 Python 腳本和 markdown 檔案，除了 `pip install -r requirements.txt` 所帶入的內容外，絕不執行遠端程式碼，且每次變更都會根據專案的 [`SECURITY.md`](SECURITY.md) 政策進行審查。「先複製再 checkout 標籤」的安裝流程讓您能在執行前檢查 `install.sh`。完整的威脅模型請參閱 [`SECURITY.md`](SECURITY.md)。

## 路線圖

<p align="center">
  <img src="https://file.nanoskill.ai/05-roadmap-A-6.svg" alt="claude-blog 波浪路線圖，以水平時間軸呈現：v1.6.0 基礎（2026 年 3 月）、v1.7.0 FLOW 框架（2026 年 4 月）、v1.8.0 無懈可擊方法論（2026 年 5 月）、v1.9.0 交付合約（目前，2026 年 5 月）、v2.0.0 多 CMS 發佈（2026 年第三季）、v3.0.0 程式碼即部落格（2027 年第一季）" width="100%">
</p>

**v1.9.1（下一步）**
- 在 `blog_render` 和 `blog_preflight` 之間共用 `_count_body_words(html)` 函式，以解決 v1.9.0 的稽核殘留問題。
- `generate_hero.py` 的退出碼語意：在無圖片生成路徑時應回傳非零（目前回傳 JSON 錯誤但退出碼為 0）。
- 迭代迴圈覆蓋率測試，驗證編排器在審查員發出 3 次「阻擋」後會升級，而非 4 次。
- 全面掃描剩餘文件（CONTRIBUTORS、NOTICE、SECURITY、PRIVACY、TEMPLATES、TROUBLESHOOTING、MCP-INTEGRATION、DEMO），找出任何殘留的 v1.x 層級漂移。

**v1.10（願景）**
- 在寫作過程中，透過 DataForSEO 進行即時的 SERP 資訊大綱精煉。
- 評估工具，測量不同組態下的部落格品質（BRAND.md 是否存在、角色變體、多語言模式）。
- 由程式碼強制執行的迭代計數器（目前是編排器指令；提升到腳本層級）。

**v2.0（長期）**
- 無頭預覽伺服器整合：5 閘門合約針對真實網域預覽執行，而非本地 HTML。
- 針對各平台的 CMS 發佈連接器（WordPress、Ghost、Sanity），並支援在改寫時進行冪等重新發布。
- 即時 AI 引用追蹤儀表板（哪些文章被 ChatGPT、Perplexity、AI Overviews 引用；能見度熱圖）。

如果您想提出建議或投票，請使用 `roadmap` 標籤開啟一個 issue。

## 解除安裝

Unix/macOS：
```bash
chmod +x uninstall.sh && ./uninstall.sh
```

Windows (PowerShell)：
```powershell
.\uninstall.ps1
```

## 整合

圖表產生和 YouTube 影片嵌入是內建功能。Google API 資料需要免費的 API 金鑰（請參閱 `/blog google setup`）。

**選用的配套技能**（對已發佈頁面進行更深入的分析）：

| 技能 | 整合方式 |
|-------|-------------|
| `/seo` | 對已發佈的部落格頁面進行深度 SEO 分析 |
| `/seo-schema` | Schema 標記驗證和產生 |
| `/seo-geo` | AI 引用最佳化稽核 |
| `/seo-google` | Google API 資料（與 blog-google 共用設定） |

## 文件

詳細文件放在 [`docs/`](docs/)：

- [安裝指南](docs/INSTALLATION.md)：Unix、macOS、Windows、手動安裝。
- [指令參考](docs/COMMANDS.md)：附範例的完整指令參考。
- [架構](docs/ARCHITECTURE.md)：系統設計與元件概觀。
- [發佈工作流程](docs/PUBLISHING.md)：私有至公開的發佈流程（Pro 維護者）。
- [範本](docs/TEMPLATES.md)：範本參考與自訂。
- [疑難排解](docs/TROUBLESHOOTING.md)：常見問題與修復。
- [MCP 整合](docs/MCP-INTEGRATION.md)：選擇性的 MCP 伺服器設定。

## 如何引用

如果您在研究或生產環境中使用 claude-blog，請引用此專案：

```bibtex
@software{Agrici_claude_blog_2026,
  author       = {Agrici, Daniel},
  title        = {claude-blog: AI Blog Writing and SEO Optimization Skill for Claude Code},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}
```

GitHub 也會在公開鏡像頁面上透過「Cite this repository」展示結構化的 [`CITATION.cff`](CITATION.cff) 檔案。

## 安全性與行為準則

- **安全性政策 + 威脅模型**：[`SECURITY.md`](SECURITY.md)。v1.8.x 強化版已修正所有已知發現；v1.9.0 新增了 XSS 安全的 JSON-LD、O_NOFOLLOW 符號連結拒絕機制，以及前置資料驗證，全部經過突變測試驗證。若要私下回報漏洞，請遵循 [`SECURITY.md`](SECURITY.md) 中的揭露程序。
- **行為準則**：[`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md)。Contributor Covenant。請友善相待。

## 貢獻

歡迎貢獻。請參閱 [`CONTRIBUTING.md`](CONTRIBUTING.md) 了解指南。在開 PR 之前：

1. 執行 `python -m pytest tests/`（全部 160 個測試必須通過）。
2. 執行 `python3 scripts/lint_prose.py --root .`（零違規）。
3. 執行 `claude plugin validate .`（必須通過）。
4. 如果您更動了使用者可見的數量或行為，請一致地提升版本號（請參閱 [`docs/PUBLISHING.md`](docs/PUBLISHING.md)）。

## 授權

MIT 授權。詳情請參閱 [`LICENSE`](LICENSE)。

## 相關專案

- **[Rankenstein](https://rankenstein.pro)**：基於 GUI 的內容發佈工作流程；在同一個平台上從研究到發佈。
- **[FLOW 框架](https://github.com/AgriciDaniel/flow)**：證據導向的 Find、Optimize、Win 提示（CC BY 4.0）。透過 `/blog flow` 以子技能方式整合。
- **[Claude Ads](https://github.com/AgriciDaniel/claude-ads)** 和 **[Claude SEO](https://github.com/AgriciDaniel/claude-seo)**：共享相同品牌套件的姊妹技能（橫幅 + 使用品牌橘色調色盤生成的圖表）。
- **[AI Marketing Hub](https://www.skool.com/ai-marketing-hub)**：免費社群，擁有 2,800 多名會員。Pro 層級的私有鏡像由 [`ai-marketing-hub-pro`](https://www.skool.com/ai-marketing-hub-pro) 託管。

## 星標歷史

<a href="https://star-history.com/#AgriciDaniel/claude-blog&Date">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
    <img alt="AgriciDaniel/claude-blog 在 GitHub 上的星標歷史" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
  </picture>
</a>

如果 claude-blog 為您節省了時間，在[公開儲存庫](https://github.com/AgriciDaniel/claude-blog)上給個星標是最簡單的感謝方式（也能幫助其他內容工作者找到它）。

## 作者

由 [Daniel Agrici](https://agricidaniel.com/about) 使用 Claude Code 打造，他是 AI 工作流程架構師。

- [部落格](https://agricidaniel.com/blog)：深入探討 AI 行銷自動化。
- [YouTube](https://www.youtube.com/@AgriciDaniel)：教學與展示。
- [所有開源工具](https://github.com/AgriciDaniel)：其他 Claude Code 技能。
- [AI Marketing Hub](https://www.skool.com/ai-marketing-hub)：AI 驅動行銷的免費社群。

## FAQ

### 什麼是 claude-blog 技能？

claude-blog 是一套 Claude Code 的技能組合，旨在規模化地撰寫、優化和審核部落格內容。它確保每篇文章都針對 Google 排名和 AI 引用平台進行雙重優化。

### 這個 AI 部落格寫作技能適合誰使用？

適合希望高效發布高品質文章的個人部落客和創作者、管理大量內容組合的行銷團隊和代理商，以及尋求生產級技能架構參考的 Claude Code 技能開發者。

### 5 關交付合約如何運作？

5 關交付合約會根據能力、格式、視覺、內容審查和資產完整性等面向的 100 分評分表，為每份草稿打分。任何低於 90 分的草稿都會被阻擋，寫作者最多可修改三次，之後才會提報給您。

### claude-blog 會產出什麼樣的內容？

它會在單一資料夾中產出 8 項成品，包括一個含有標題、描述、日期、作者、標籤和標準網址的 Markdown 檔案，以及渲染後的 HTML、PDF、主圖、螢幕截圖、審查評分表和預檢審核報告。

### 這個技能可以處理多語言內容嗎？

是的，它支援多語言一鍵發佈，包括撰寫、翻譯、在地化和產出 hreflang 標籤。它還提供 SEO 優化翻譯，保留格式並針對每個地區進行深度文化調適。

### claude-blog 如何確保內容品質和準確性？

它使用五類品質評分系統、AI 內容偵測來標記機器生成的文字、角色驅動的寫作並強制風格，以及事實查核流程，根據引用來源驗證統計數據。