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

適用於 Claude Code 的 AI 部落格寫作與 SEO 優化技能 (claude-blog)

此技能有兩個版本。 選擇適合您工作方式的版本：

• 🌐 公共開源版本：AgriciDaniel/claude-blog。MIT 許可證，公開發布，對所有人開放。如果您想要穩定、可下載、無需會員資格的版本，請使用此版本。
• 🔒 社群私人鏡像（此儲存庫）：AI-Marketing-Hub/claude-blog。搶先體驗開發中的工作（v1.9.0+ 部落格交付合約、英雄階梯、變異測試回歸覆蓋），並與 AI Marketing Hub Pro 社群直接協作。需要會員資格。

上述徽章追蹤的是公共儲存庫 (AgriciDaniel/claude-blog)，因為私人鏡像對 shields.io 不可見。發布工作流程（私人開發、審查、公開發布）記錄在 docs/PUBLISHING.md 中。

部落格： 了解 claude-blog 如何運作

claude-blog 是一個 Claude Code 技能套件，能夠大規模地撰寫、優化和審核部落格內容。 每篇文章都針對 Google 排名（2025 年 12 月核心更新、E-E-A-T）和 AI 引用平台（ChatGPT、Perplexity、AI 概述）進行雙重優化。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 年 5 月 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 複雜度的代理技能開放標準，包含 160 個測試、版本一致性強制執行、安裝程式同步回歸測試以及 v1.9.0 5 階段合約模式。閱讀源碼以獲取靈感；將模式分叉到您自己的技能中。

claude-blog 產生什麼？

每份草稿都以 8 個工件的形式儲存在一個資料夾中。.md 輸出的簡要範例：

---
title: "Claude Code 技能插件應該安裝在哪裡？"
description: "關於安裝路徑問題的一個可行答案..."
date: "2026-05-18"
author: "Daniel Agrici"
tags: [claude-code, skills, plugins, installation]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# Claude Code 技能插件應該安裝在哪裡？

簡短的答案：大多數使用者可安裝的 Claude Code 技能插件
應該將技能內容發布到 `~/.claude/skills/<name>/`，
代理發布到 `~/.claude/agents/<name>.md`，以及
任何 Python 輔助程式發布到 `~/.claude/scripts/<helper>.py`。

## 主要重點
- `~/.claude/skills/` 是 SKILL.md 的表面區域。
- `~/.claude/agents/` 儲存代理 markdown 文件。
- ... (完整文章、引用來源、常見問題、架構 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（包含 BLOCKING 行的 5 類計分卡）和 preflight-report.json（完整的審核軌跡）。

目錄

• 演示
• 快速入門
• 指令
• claude-blog 如何比較？
• 功能
• 交付合約 (v1.9.0)
• 架構
• 要求
• 常見問題
• 路線圖
• 解除安裝
• 整合
• 文件
• 如何引用
• 安全與行為準則
• 貢獻
• 許可證
• 相關專案
• 作者

演示

在 YouTube 上觀看演示

快速入門

ℹ️ 您要安裝哪個版本？

• 不是 AI Marketing Hub Pro 會員？ 從公共儲存庫安裝：AgriciDaniel/claude-blog。所有下面的安裝指令都適用於該處。只需將 AI-Marketing-Hub/claude-blog 替換為 AgriciDaniel/claude-blog，並將插件 slug 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 社群 中發送私訊以加入。

插件安裝 (Claude Code 1.0.33+)：

# 新增市集 (一次性)
/plugin marketplace add AI-Marketing-Hub/claude-blog

# 安裝插件
/plugin install claude-blog@ai-marketing-hub-claude-blog

建議：克隆、驗證，然後安裝（讓您可以檢查 install.sh 並固定發布標籤）：

git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0          # 固定到發布標籤 (截至 2026-05-18 的最新版本)
chmod +x install.sh && ./install.sh

一鍵安裝 (Unix/macOS)：

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

一鍵安裝 (Windows PowerShell)：

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

將 curl 或 irm 管道傳輸到 shell 會賦予腳本在您的機器上執行權限。克隆然後簽出標籤的流程更安全，因為您可以檢查執行的內容。這兩種流程都使用您現有的 gh auth / GitHub 憑證對私人儲存庫進行身份驗證。

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

# 下載、驗證 SHA-256，然後在雜湊匹配時運行。
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。在運行之前，請根據 規範文件 進行驗證。install.ps1 的伴隨雜湊是 6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98。每次安裝程式更改時，此 README 中的雜湊都會更新。

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

指令

🚀 第一次使用？請先嘗試這三個指令：/blog strategy <niche> 來規劃您的部落格範圍，/blog write <topic> 來生成您的第一篇文章（5 階段合約會自動運行），以及 /blog analyze <file> 來根據 100 分的評分標準對其進行評分。

總共有 30 個子技能目錄：29 個使用者可調用（28 個不同的斜線指令 + /blog update 別名為 rewrite）+ 1 個內部專用（blog-chart，由 blog-write/blog-rewrite 調用以生成內聯 SVG 圖表）。blog-image 既可由使用者調用，也可在內部調用。

claude-blog 如何比較？

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

claude-blog 並非在所有方面都更好。對於單次拋棄式草稿，直接提示更快。對於非開發人員來說，託管的 SaaS 更容易。DIY 對於獨特的管道更靈活。claude-blog 適用於您希望大規模生產級內容而無需 SaaS 訂閱的情況。

功能

12 個內容模板

根據主題和意圖自動選擇：操作指南、清單文章、案例研究、比較、支柱頁面、產品評論、思想領導力、總結、教學、新聞分析、數據研究、常見問題知識庫。

5 類品質評分 (100 分)

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

AI 內容檢測

對句子長度變異性進行突發性評分，已知 AI 詞組檢測（17 個詞組），以及詞彙多樣性（TTR）。在內容到達審閱者之前，標記讀起來像機器生成的內容。

以人物角色為導向的寫作

可配置的寫作人物角色，採用 NNGroup 4 維度語氣框架（正式/休閒、嚴肅/有趣、尊重/輕蔑、實事求是/熱情）。管理每個部落格或作者的語音設定檔，並在草稿時強制執行可讀性區間（消費者、專業、技術）和風格。

事實查核流程

/blog factcheck 獲取每個引用的來源 URL，並將聲明信心評分為完全匹配、意譯或未找到。確保每個數據點都準確可追溯，而非憑空捏造。

關鍵字蠶食檢測

/blog cannibalization 使用本地 grep 分析或 DataForSEO API 識別部落格文章之間的關鍵字重疊。嚴重性評分以及合併或區分建議可防止文章在 SERP 中相互競爭。

CMS 分類管理

支援 WordPress REST、Shopify GraphQL、Ghost、Strapi 和 Sanity 的標籤和類別同步。包括標籤建議、同步和審核工作流程。

雙重優化

每篇文章都針對 Google 排名和 AI 引用平台進行優化：

• Google：符合 2025 年 12 月核心更新、E-E-A-T 信號、架構標記、內部連結、透過 blog-google 了解核心網頁指標。
• AI 引用：答案優先格式、引用膠囊、段落級可引用性（120-180 字塊）、FAQ 架構、實體清晰度。

視覺媒體

• Pixabay、Unsplash 和 Pexels 圖像來源，帶有 HTTP 200 驗證和自動生成的 alt 文本。
• 透過 Gemini 生成 AI 圖像，用於英雄圖像、內聯插圖和社群卡片。需要免費的 Google AI API 金鑰。
• 內建 7 種樣式（條形圖、分組條形圖、棒棒糖圖、甜甜圈圖、折線圖、面積圖、雷達圖）的 SVG 圖表生成。
• 帶有 srcdoc 延遲載入和 noscript AI 爬蟲備用的 YouTube 影片嵌入。
• 根據內容類型校準的圖像密度目標。

Google API 整合 (v1.6.5+)

13 個指令，跨 4 個憑證層級，正常使用下均免費：

• 第 0 層 (API 金鑰)：PageSpeed Insights、CrUX 核心網頁指標 (25 週歷史記錄)、YouTube 影片搜尋、NLP 實體分析。
• 第 1 層 (OAuth)：Search Console 效能、URL 檢查、索引 API。
• 第 2 層 (GA4)：自然流量報告。
• 第 3 層 (Ads)：Google Ads 關鍵字規劃工具。

NotebookLM 研究

查詢 Google NotebookLM 以從使用者上傳的文件中進行來源基礎研究。由於答案是從您上傳的文件中提取的，因此數據品質為 Tier 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/ 下的五份參考文件定義了所有子技能中應用的編輯和研究方法論。它們由協調器按需載入：

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

FLOW 框架

FLOW 框架（尋找、利用、優化、獲勝）是與 AgriciDaniel/flow (CC BY 4.0) 共享的證據導向工作流程。每個階段都為協調器管道提供提示；/blog flow 暴露了 30 個按階段索引的即時運行提示。

交付合約 (v1.9.0)

每篇部落格文章在呈現給使用者之前都必須通過 5 階段合約。使用者永遠不是第一個審閱者；門檻才是。

英雄圖像階梯：Banana MCP、直接 Gemini API、高級圖庫（Unsplash、Pexels、Pixabay）、Openverse 公共 API。第一個可用的獲勝。在任何門檻失敗時，最多阻擋並迭代 3 次，然後再升級給使用者。完整規格：skills/blog/references/blog-delivery-contract.md。

架構

claude-blog 以一個協調器加上 29 個子技能、5 個代理、21 個參考資料、12 個模板和 9 個根級腳本的形式發布。協調器將使用者指令路由到子技能，子技能透過 Bash 產生代理並呼叫腳本。

完整的目錄樹、數據流圖、評分方法和擴展點：docs/ARCHITECTURE.md。

要求

• 已安裝並配置 Claude Code CLI。
• Python 3.11+ (用於品質評分、5 階段交付合約運行器和 lint)。
• 可選：pip install -r requirements.txt 用於進階分析（可讀性評分、架構檢測）。

品質門檻 (在每個 PR 上強制執行 CI)

1. pytest：跨安全、行為、回歸和交付合約套件的 160 個測試。
2. 插件驗證：claude plugin validate . 加上手動編寫的 JSON/正則表達式檢查。
3. 過時路徑 lint：捕獲 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 聲明相同的指令集。

在推送之前在本地運行：

python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .

常見問題

什麼是 claude-blog 技能？

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

claude-blog 與直接提示 Claude 或 ChatGPT 有何不同？

直接提示只會從一個提示中給您一份草稿。claude-blog 則提供結構化的管道：帶有來源統計數據的研究、大綱批准、草稿生成、多輪品質評分、AI 內容檢測、事實驗證、架構注入，以及在交付前迭代最多 3 次的阻擋式審查。該技能強制執行資深編輯原本會手動執行的工作。

我需要 AI Marketing Hub Pro 會員資格才能使用 claude-blog 嗎？

不需要。位於 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。協調器會根據專案信號自動檢測平台，並相應調整前置內容、圖像嵌入和架構注入。

claude-blog 會產生幻覺統計數據嗎？

不會。每個引用的統計數據都會經過 /blog factcheck，該指令會獲取來源 URL 並評估聲明信心（完全匹配、意譯、未找到）。如果引用無法驗證或 AI 內容檢測將語法標記為機器生成，blog-reviewer 代理會阻止發布。

什麼是 5 階段部落格交付合約？

這是一個在每個草稿上運行的程式碼強制預呈現管道：能力發現、格式完整性、3 種視窗寬度下的視覺驗證、內容審查（阻擋；分數 90+ 且無 P0 問題），以及資產 + 連結完整性。協調器會在任何門檻失敗時，最多迭代寫作者 3 次，然後再升級給您。完整規格請參閱 skills/blog/references/blog-delivery-contract.md。

我可以使用 claude-blog 處理多種語言嗎？

是的。/blog multilingual <topic> --languages en,de,fr,es,ja 會撰寫文章、翻譯並保留前置內容和架構、針對每個地區進行文化深度適應，並在單一指令中發出 hreflang 標籤以及 CMS 就緒的語言地圖。

我如何在學術著作中引用 claude-blog？

請參閱下面的 如何引用 部分或儲存庫根目錄中的 CITATION.cff 文件。GitHub 透過公共鏡像頁面上的「引用此儲存庫」按鈕顯示結構化的引用文件。

安裝 claude-blog 安全嗎？

安裝程式只發布 Python 腳本和 markdown 文件，從不執行 pip install -r requirements.txt 引入的遠端程式碼之外的任何程式碼，並且在每次更改時都會根據專案的 SECURITY.md 政策進行審查。克隆然後簽出標籤的安裝流程讓您可以在運行 install.sh 之前檢查它。有關完整的威脅模型，請參閱 SECURITY.md。

路線圖

v1.9.1 (下一個版本)

• blog_render 和 blog_preflight 之間共用 _count_body_words(html) 函數，以解決 v1.9.0 審核殘留問題。
• generate_hero.py 退出程式碼語義：在沒有圖像生成路徑時非零（目前返回 JSON 錯誤，退出碼為 0）。
• 迭代循環覆蓋測試，驗證協調器在 3 次審閱者 BLOCK 後升級，而不是 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 概述引用；可見性熱圖）。

如果您想提出或投票，請開啟一個帶有 roadmap 標籤的問題。

解除安裝

Unix/macOS：

chmod +x uninstall.sh && ./uninstall.sh

Windows (PowerShell)：

.\uninstall.ps1

整合

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

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

文件

詳細文件位於 docs/：

• 安裝指南：Unix、macOS、Windows、手動安裝。
• 指令參考：完整的指令參考和範例。
• 架構：系統設計和元件概述。
• 發布工作流程：從私人到公開的發布流程 (專業維護者)。
• 模板：模板參考和自定義。
• 故障排除：常見問題和解決方案。
• MCP 整合：可選的 MCP 伺服器設定。

如何引用

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

@software{Agrici_claude_blog_2026,
  author       = {Agrici, Daniel},
  title        = {claude-blog: AI 部落格寫作與 SEO 優化技能，適用於 Claude Code},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}

GitHub 也透過公共鏡像頁面上的「引用此儲存庫」按鈕顯示結構化的 CITATION.cff 文件。

安全與行為準則

• 安全政策 + 威脅模型：SECURITY.md。v1.8.x 強化通過解決了所有已知問題；v1.9.0 新增了 XSS 安全的 JSON-LD、O_NOFOLLOW 符號連結拒絕和前置內容驗證，所有這些都經過變異測試驗證。要私下報告漏洞，請遵循 SECURITY.md 中的披露程序。
• 行為準則：CODE_OF_CONDUCT.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）。

許可證

MIT 許可證。詳情請參閱 LICENSE。

相關專案

• Rankenstein：基於 GUI 的內容發布工作流程；從研究到發布都在一個平台中完成。
• FLOW 框架：證據導向的尋找、優化、獲勝提示 (CC BY 4.0)。透過 /blog flow 整合為子技能。
• Claude Ads 和 Claude SEO：共享相同品牌套件（使用品牌橙色調色板生成的橫幅 + 圖表）的姊妹技能。
• AI Marketing Hub：免費社群，2,800 多名成員。Pro 層級位於 ai-marketing-hub-pro，託管此技能的私人鏡像。

星星歷史

如果 claude-blog 為您節省了時間，在 公共儲存庫 上點擊星星是表達感謝最簡單的方式（也有助於其他內容工作者找到它）。

作者

由 Daniel Agrici，AI 工作流程架構師，使用 Claude Code 建置。

• 部落格：深入探討 AI 行銷自動化。
• YouTube：教學和演示。
• 所有開源工具：其他 Claude Code 技能。
• AI Marketing Hub：AI 驅動行銷的免費社群。