# Claude Code 的 AI 博客写作代理技能

> 使用这款适用于克劳德代码的AI博客写作代理技能，大规模生成、优化和审核博客内容。它能产出同时针对谷歌排名和AI引用平台进行双重优化的文章，确保每次都能生成高质量、利于SEO的内容。

- Canonical: https://nanoskill.ai/zh/skills/ai-blog-writing-skill
- Markdown: https://nanoskill.ai/zh/skills/ai-blog-writing-skill.md
- Author: AgriciDaniel
- Published: 2026-05-24T06:35:19.314Z
- Updated: 2026-08-06T22:32:06.722Z
- Language: zh-CN
- 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

这款适用于克劳德代码的AI博客写作与SEO优化技能，名为claude-blog，是一套全面的套件，旨在自动化和增强您的内容创作流程。这一强大的技能能大规模撰写、优化和审核博客内容，确保每篇文章都经过精心打磨，以符合谷歌搜索排名和AI引用平台的双重要求。对于那些希望持续高效地生成高质量、对SEO友好内容的用户而言，它是不可或缺的工具。

claude-blog以其强大的5道关卡交付契约著称，通过根据100分评分标准对每份草稿打分并拦截所有低于90分的内容，来确保内容质量。它提供双重优化，旨在符合2025年12月核心更新要求，并针对谷歌的E-E-A-T信号进行优化，同时为ChatGPT和Perplexity等AI引用平台准备内容。凭借30个子技能、5个代理和12个内容模板，它处理从研究和提纲撰写到模式生成和引用验证的整个内容生命周期。

无论您是希望每周发布一篇高质量博文的独立博主，还是管理多样化内容组合的营销团队，或是寻求生产级参考的克劳德代码技能构建者，claude-blog都能提供量身定制的解决方案。它支持主题聚类规划、多语言发布、基于用户画像的语调配置文件，并包含关键词内部竞争检测和事实核查管道等高级功能，以确保准确性并防止内容冲突。

## Key features

- **5门交付契约**: 每份初稿都经过严格的5门交付契约（能力、格式、视觉、内容审核、资产完整性），采用100点评分标准，任何低于90分的都不会到您手中。
- **搜索引擎优化与人工智能引用的双重优化**: 每篇文章都针对谷歌排名（2025年12月核心更新，经验-专业-权威-信任）和人工智能引用平台（聊天机器人、珀普莱克西蒂、人工智能概览）进行了优化，最大限度地提高了可见度和可引用性。
- **全面的内容生成**: 一个覆盖完整生命周期的博客引擎，拥有30个子技能、5个代理和12个内容模板，只需一次调用即可涵盖研究、提纲、初稿、架构、内部链接和引用验证。
- **基于人物的写作与事实核查**: 管理可配置的写作人物角色，并配有语气框架和可读性范围，同时还有一个事实核查流程，根据引用的来源验证统计数据以确保准确性。
- **关键词自相残杀检测**: 通过严重程度评分和建议，识别和解决博客文章之间的关键词重叠，以防止内容在搜索结果页面中自相残杀。

## Use cases

- **生成高质量的博客文章**: 独立博主和创作者可以每周发布一篇高质量的文章，无需手动搜索引擎优化清单，即可处理研究、提纲、初稿、架构、内部链接和引用验证。
- **为团队大规模管理内容**: 营销团队和机构可以跨主题和语言管理大量文章，具备主题集群规划、多语言发布和基于人物的语音配置文件等功能。
- **审核和优化现有内容**: 使用该技能，通过0-100的质量分数分析现有的博客文章，进行写作后的搜索引擎优化验证，并检测站点范围内的关键词自相残杀。

## Result preview

查看由该代理技能创建的一篇关于最佳AI PPT工具的真实清单文章。

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

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

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

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

## Result walkthrough

### 第1步：安装

将技能添加到您的代理。

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

### 第2步：生成内容

使用特定命令生成博客内容。

![blog-writing-step-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营销中心专业版](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技能套件，用于大规模撰写、优化和审核博客内容。**每篇文章都针对谷歌排名（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年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关卡的生产级参考。该仓库展示了复杂等级4的Agent Skills开放标准，包含160个测试、版本一致性强制执行、安装程序同步回归测试以及v1.9.0的5关契约模式。阅读源码以获取灵感；将这些模式复刻到您自己的技能中。

## claude-blog产出什么？

每篇草稿在一个文件夹中生成8个工件。以下是`.md`输出的简化样本：

```markdown
---
title: "克劳德代码技能插件应安装在哪里？"
description: "对安装路径问题的一个实用答案..."
date: "2026-05-18"
author: "丹尼尔·阿格里奇"
tags: [claude-code, skills, plugins, installation]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# 克劳德代码技能插件应安装在哪里？

简短回答：大多数用户可安装的Claude Code技能插件应将技能内容发送到`~/.claude/skills/<name>/`，将代理发送到`~/.claude/agents/<name>.md`，并将任何Python助手发送到`~/.claude/scripts/<helper>.py`。

## 关键要点
- `~/.claude/skills/`是SKILL.md的表面区域。
- `~/.claude/agents/`存放代理标记文件。
- ...（完整文章，含引用来源、FAQ、结构化数据JSON-LD）
```

除了`.md`文件，该契约还会生成：渲染的`.html`（XSS安全的JSON-LD，暗黑模式感知的CSS）、`.pdf`（通过Playwright或weasyprint生成）、`hero.<ext>`（1200x630，通过Banana MCP、Gemini、 stock 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://file.nanoskill.ai/blog-command-demo-1.gif" alt="claude-blog命令演示：通过调度器路由/blog子命令" width="100%">
</p>

---

## 快速开始

> ℹ️ **您要安装哪个版本？**
>
> - **不是AI营销中心专业版会员？** 从公开仓库安装：[`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog)。以下所有安装命令均适用于该仓库。只需将`AI-Marketing-Hub/claude-blog`替换为`AgriciDaniel/claude-blog`，并将插件slug `claude-blog@ai-marketing-hub-claude-blog` 替换为 `claude-blog@agricidaniel-claude-blog`。公开版本在那里发布；此私有镜像版本更超前。
> - **专业版会员？** 以下命令将安装**社区版本**，可提前体验开发中的功能。这些命令需要经过身份验证的 `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
# 添加市场（一次性）
/plugin marketplace add AI-Marketing-Hub/claude-blog

# 安装插件
/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          # 锁定到发行标签（截至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会赋予脚本在您机器上的执行权限。克隆然后检出标签的流程更安全，因为您可以检查将运行的内容。两种流程均使用您现有的`gh auth` / GitHub凭据对私有仓库进行身份验证。

**验证安装程序完整性（推荐，VULN-IAC-001加固）：**

```bash
# 下载，验证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`文件。运行前请对照[规范文件](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://file.nanoskill.ai/blog-write-demo-1.gif" alt="claude-blog /blog write演示：使用5关交付契约进行端到端文章生成" width="100%">
</p>

<p align="center">
  <img src="https://file.nanoskill.ai/03-sub-skill-map-B-1.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结构化数据标记 |
| `/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`是重写的别名）+ 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`获取来源URL | ❌ 产生幻觉 | ❌ | ⚠️ 手动 |
| 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更容易使用。自己构建对于独特的管道更灵活。claude-blog适用于那些希望以规模化的方式获得生产级内容，而又不想购买SaaS订阅的场景。

## 特性

### 12种内容模板
根据主题和意图自动选择：操作指南、清单体、案例研究、对比文章、核心页面、产品评测、思想领导力、整理汇总、教程、新闻分析、数据研究、FAQ知识库。

### 5类质量评分（100分制）
| 类别 | 分值 | 关注点 |
|----------|--------|-------|
| 内容质量 | 30 | 深度、可读性、原创性、参与度 |
| SEO优化 | 25 | 标题、文章标题、关键词、链接、元数据 |
| E-E-A-T信号 | 15 | 作者、引用、信任度、经验 |
| 技术要素 | 15 | 结构化数据、图片、速度、移动端、OG标签 |
| AI引用准备度 | 15 | 可引用性、问答格式、实体清晰度 |

评分等级：卓越（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的标签和分类同步。包括标签建议、同步和审计工作流。

### 双重优化
每篇文章同时针对谷歌排名和AI引用平台：
- **谷歌**：符合2025年12月核心更新要求、E-E-A-T信号、结构化数据标记、内部链接、通过blog-google实现的Core Web Vitals感知。
- **AI引用**：答案优先格式、引用胶囊、段落级可引用性（120-180词块）、FAQ结构化数据、实体清晰度。

### 视觉媒体
- 通过Pixabay、Unsplash和Pexels获取图片，并进行HTTP 200验证和自动生成替代文本。
- 通过Gemini进行AI图像生成，用于英雄图像、内联插图和社交卡片。需要免费的Google AI API密钥。
- 内置7种风格的SVG图表生成（柱状图、分组柱状图、棒棒糖图、环形图、折线图、面积图、雷达图）。
- YouTube视频嵌入，采用`srcdoc`懒加载和noscript AI爬虫回退。
- 根据内容类型校准的图像密度目标。

### Google API集成（v1.6.5+）
13条命令覆盖4个凭据层级，正常使用均免费：
- **层级0**（API密钥）：PageSpeed Insights、CrUX Core Web Vitals（25周历史记录）、YouTube视频搜索、NLP实体分析。
- **层级1**（OAuth）：Search Console表现、URL检查、索引API。
- **层级2**（GA4）：自然流量报告。
- **层级3**（广告）：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条基于尼尔森的自适应启发式方法，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框架（发现、利用、优化、赢得）是与[`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-1.svg" alt="FLOW框架径向轮：四个阶段（发现用于主题发现、利用用于资产放大、优化用于内容改进、赢得用于读者转化）围绕中心枢纽排列，外圈有10个代表性提示" width="100%">
</p>

## 交付契约（v1.9.0）

<p align="center">
  <img src="https://file.nanoskill.ai/02-pipeline-A-1.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`在3种视口宽度下 |
| 4. 内容审查（阻塞） | `blog-reviewer`评分90+且零P0问题 | `agents/blog-reviewer.md`（阻塞，v1.9.0） |
| 5. 资产和链接完整性 | 每张图片都能解析，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-1.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`以进行高级分析（可读性评分、结构化数据检测）。

### 质量关卡（每次PR均通过CI强制执行）

1. **pytest**：160个测试，涵盖安全性、行为、回归和交付契约套件。
2. **插件验证**：`claude plugin validate .`以及手工编写的JSON/regex检查。
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`的frontmatter全部匹配。
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内容检测、事实核查、结构化数据注入，以及在交付前最多迭代3次的阻塞性审查。该技能强制执行了高级编辑原本需要手动完成的工作。

### 我需要AI营销中心专业版会员资格才能使用claude-blog吗？
不需要。位于[`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog)的公开开源版本采用MIT许可，并对任何拥有Claude Code的人免费开放。位于`AI-Marketing-Hub/claude-blog`的私有镜像是为希望提前体验开发中的功能并与社区直接协作的专业版会员准备的。

### claude-blog支持哪些博客平台？
Next.js MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby和静态HTML。调度器会根据项目信号自动检测平台，并相应地调整frontmatter、图像嵌入和结构化数据注入。

### claude-blog会产生统计数据的幻觉吗？
不会。每个引用的统计数据都会经过`/blog factcheck`处理，该命令会获取来源URL并对声明的置信度进行评分（完全匹配、转述、未找到）。如果引用无法验证，或者AI内容检测标记出文章是机器生成的，`blog-reviewer`代理会阻止发布。

### 什么是5关博客交付契约？
一个由代码强制执行的预展示管道，在每篇草稿上运行：能力发现、格式完整性、3种视口宽度下的视觉验证、内容审查（阻塞；评分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`会撰写文章，翻译时保留frontmatter和结构化数据，针对每个地区进行文化深度适配，并在单个命令中输出hreflang标签以及可供CMS使用的语言映射。

### 如何在学术工作中引用claude-blog？
请参阅下方的[如何引用](#how-to-cite)部分或仓库根目录中的[`CITATION.cff`](CITATION.cff)文件。GitHub通过公共镜像页面上的“引用此仓库”按钮，可展示结构化的引用文件。

### 安装claude-blog安全吗？
安装程序仅包含Python脚本和markdown文件，绝不会执行超出`pip install -r requirements.txt`引入范围之外的远程代码，并且每次变更都会根据项目的[`SECURITY.md`](SECURITY.md)策略进行审查。克隆然后检出标签的安装流程让您能在运行之前检查`install.sh`。完整威胁模型请参阅[`SECURITY.md`](SECURITY.md)。

## 路线图

<p align="center">
  <img src="https://file.nanoskill.ai/05-roadmap-A-1.svg" alt="claude-blog波浪路线图，横向时间轴：v1.6.0基础（2026年3月）、v1.7.0 FLOW框架（2026年4月）、v1.8.0 impeccable方法论（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` | 结构化数据标记验证和生成 |
| `/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)：私有到公开的发布流程（面向专业版维护者）。
- [模板](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: 针对Claude Code的AI博客写作与SEO优化技能},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}
```

GitHub还会通过公共镜像页面上的“引用此仓库”按钮，展示结构化的[`CITATION.cff`](CITATION.cff)文件。

## 安全性及行为准则

- **安全策略 + 威胁模型**：[`SECURITY.md`](SECURITY.md)。v1.8.x强化环节关闭了所有已知发现；v1.9.0增加了XSS安全的JSON-LD、O_NOFOLLOW符号链接拒绝以及frontmatter验证，全部经过变异测试验证。如需私下报告漏洞，请遵循[`SECURITY.md`](SECURITY.md)中的披露程序。
- **行为准则**：[`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md)。贡献者公约。相互尊重。

## 贡献

欢迎贡献。请参阅[`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)**：基于证据的发现、优化、赢得提示（CC BY 4.0）。通过`/blog flow`作为子技能集成。
- **[Claude Ads](https://github.com/AgriciDaniel/claude-ads)**和**[Claude SEO](https://github.com/AgriciDaniel/claude-seo)**：共享同一品牌套件的姊妹技能（使用品牌橙色调色板生成的横幅和图表）。
- **[AI营销中心](https://www.skool.com/ai-marketing-hub)**：免费社区，2800多名成员。专业版位于[`ai-marketing-hub-pro`](https://www.skool.com/ai-marketing-hub-pro)，托管此技能的私有镜像。

## Star历史

<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="GitHub上AgriciDaniel/claude-blog的Star历史" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
  </picture>
</a>

如果claude-blog节省了您的时间，在[公开仓库](https://github.com/AgriciDaniel/claude-blog)上点个Star是表达感谢的最简单方式（也有助于其他内容工作者找到它）。

## 作者

由AI工作流架构师[Daniel Agrici](https://agricidaniel.com/about)使用Claude Code构建。

- [博客](https://agricidaniel.com/blog)：关于AI营销自动化的深度文章。
- [YouTube](https://www.youtube.com/@AgriciDaniel)：教程和演示。
- [所有开源工具](https://github.com/AgriciDaniel)：其他Claude Code技能。
- [AI营销中心](https://www.skool.com/ai-marketing-hub)：面向AI驱动营销的免费社区。

## FAQ

### 什么是克劳德博客技能？

克劳德博客是一套克劳德代码技能套件，旨在大规模撰写、优化和审核博客内容。它确保每篇文章都能针对谷歌排名和人工智能引用平台进行双重优化。

### 这个用于人工智能博客写作的技能适合谁？

它是为希望高效发布高质量帖子的独立博主和创作者、管理大量内容组合的营销团队和机构，以及寻求技能架构生产级参考的克劳德代码技能构建者而设计的。

### 5门交付契约如何运作？

5门交付契约会根据能力、格式、视觉、内容审核和资产完整性五个方面的100点评分标准对每份初稿进行评分。任何评分低于90的初稿都会被阻止，撰写者最多迭代三次，然后升级给你。

### 克劳德博客能产生什么样的内容？

它在一个文件夹中生成8个制品，包括一个包含标题、描述、日期、作者、标签和规范网址的标记文档文件，以及渲染的超文本标记语言、便携式文档格式、主图、截图、审核记分卡和预检审计报告。

### 该技能能处理多语言内容吗？

是的，它支持多语言的一键发布，包括撰写、翻译、本地化和输出语言标签。它还提供搜索引擎优化优化的翻译，保留格式，并针对每个区域进行文化深度适应。

### 克劳德博客如何确保内容质量和准确性？

它使用一个五类别的质量评分系统、用于标记机器生成文章的人工智能内容检测、带有风格强制执行的基于人物的写作，以及一个事实核查流程，该流程会根据引用的来源来验证统计数据。