NanoSkill
提交你的 Skill

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

作者AgriciDaniel818GitHub 星標GitHub

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

部落格安全掃描通過
結果預覽

完整 Demo

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

開始使用

完成第一個任務

  1. 部落格文章撰寫步驟 1
    01

    步驟 1：安裝

    將技能新增到您的代理。

  2. 部落格寫作步驟-2
    02

    步驟 2：生成內容

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

  3. blog-writing-step-03
    03

    步驟 3：審查與編輯

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

安裝指令

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

關於

適用於 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 都能提供量身打造的解決方案。它支援主題群集規劃、多語言發布、基於人物誌的語調設定，並包含關鍵字蠶食偵測和事實查核流程等進階功能，以確保準確性並防止內容衝突。

核心功能

它的強大之處

  • 5 關交付合約

    每份草稿都會通過嚴格的 5 關交付合約（能力、格式、視覺、內容審查、資產完整性），並以 100 分評分表評估，任何低於 90 分的內容都不會送到您手中。

  • SEO 與 AI 引用的雙重優化

    每篇文章都針對 Google 排名（2025 年 12 月核心更新、E-E-A-T）和 AI 引用平台（ChatGPT、Perplexity、AI Overviews）進行優化，最大限度地提高可見度和可引用性。

  • 全方位內容生成

    一個全生命週期的部落格引擎，擁有 30 個子技能、5 個代理和 12 個內容模板，涵蓋研究、大綱、草稿、結構化資料、內部連結和引用驗證，一次調用即可完成。

  • 角色驅動寫作與事實查核

    管理可設定的寫作角色，包含語氣框架和可讀性範圍，以及事實查核流程，根據引用來源驗證統計數據以確保準確性。

  • 關鍵字蠶食偵測

    識別並解決部落格文章之間的關鍵字重疊問題，提供嚴重性評分和建議，防止內容在搜尋引擎結果頁中互相競爭。

使用場景

什麼時候適合使用

  • 生成高品質部落格文章

    個人部落客和創作者每週可以發布一篇高品質文章，無需手動 SEO 檢查清單，涵蓋研究、大綱、草稿、結構化資料、內部連結和引用驗證。

  • 為團隊大規模管理內容

    行銷團隊和代理商可以透過主題叢集規劃、多語言發布和角色驅動的語調設定檔等功能，跨主題和語言管理大量文章。

  • 審核並優化現有內容

    使用此技能分析現有部落格文章，給予 0 到 100 的品質評分，執行寫作後的 SEO 驗證，並偵測整個網站中的關鍵字蠶食現象。

SKILL.md

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 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 輸出的精簡範例：

---
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（完整的稽核軌跡）。

目錄

  • 展示
  • 快速開始
  • 指令
  • claude-blog 比較起來如何？
  • 功能
  • 交付合約（v1.9.0）
  • 架構
  • 需求
  • 常見問答
  • 路線圖
  • 解除安裝
  • 整合
  • 文件
  • 如何引用
  • 安全性與行為準則
  • 貢獻
  • 授權
  • 相關專案
  • 作者

展示

在 YouTube 觀看展示

<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。以下所有安裝指令在那裡都適用。只需將 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 社群 內發送私訊以加入。

外掛安裝（Claude Code 1.0.33+）：

# 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 並釘選發行標籤）：

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）：

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 會賦予腳本在您機器上的執行權限。先複製再 checkout 標籤的流程較為安全，因為您可以檢查會執行的內容。兩種流程都使用您現有的 gh auth / GitHub 憑證來對私有儲存庫進行身份驗證。

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

# 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。執行前請對照官方檔案進行驗證。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作者、引用、信任感、經驗
技術元素15Schema、圖片、速度、行動版、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.md10 項 Nielsen 調適的啟發法，附 0-4 評分 + P0-P3 嚴重性標記blog-analyze --rubric
cognitive-load.md每節概念密度（實體、數字、術語、向前引用、子句深度）blog-analyze --cognitive-load、scripts/cognitive_load.py
research-quality.md5 維度研究評鑑 + 4 種預檢關鍵字陷阱類別 + 新鮮度門檻blog-researcher、blog-discourse、blog-brief、blog-strategy
synthesis-contract.md6 條研究綜合法則（禁止末尾「來源」區塊、行內引用等）所有研究綜合子技能

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

FLOW 框架

FLOW 框架（Find、Leverage、Optimize、Win）是與 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。

架構

<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 呼叫腳本。

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

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

需求

  • 已安裝並設定好的 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 宣告相同的指令集。

推送前先在本地端執行：

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 的公開開源版本採用 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。

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

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

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

請參閱下方的如何引用章節，或儲存庫根目錄中的 CITATION.cff 檔案。GitHub 會在公開鏡像頁面上透過「Cite this repository」按鈕展示結構化的引用檔案。

安裝 claude-blog 安全嗎？

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

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

Windows (PowerShell)：

.\uninstall.ps1

整合

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

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

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

文件

詳細文件放在 docs/：

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

如何引用

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

@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 檔案。

安全性與行為準則

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

貢獻

歡迎貢獻。請參閱 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 框架：證據導向的 Find、Optimize、Win 提示（CC BY 4.0）。透過 /blog flow 以子技能方式整合。
  • Claude Ads 和 Claude SEO：共享相同品牌套件的姊妹技能（橫幅 + 使用品牌橘色調色盤生成的圖表）。
  • AI Marketing Hub：免費社群，擁有 2,800 多名會員。Pro 層級的私有鏡像由 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 為您節省了時間，在公開儲存庫上給個星標是最簡單的感謝方式（也能幫助其他內容工作者找到它）。

作者

由 Daniel Agrici 使用 Claude Code 打造，他是 AI 工作流程架構師。

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

常見問題