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

针对Claude Code的AI博客写作与SEO优化技能（claude-blog）

此技能有两个版本。 选择适合您工作方式的版本：

• 🌐 公开开源版本：AgriciDaniel/claude-blog。采用MIT许可，公开发布，对所有人开放。如果您需要稳定、可下载且无需会员资格的版本，请使用此版本。
• 🔒 社区私有镜像（本仓库）：AI-Marketing-Hub/claude-blog。可提前体验开发中的工作（v1.9.0+ 博客交付契约、英雄图像阶梯、经变异测试的回归覆盖），并与AI营销中心专业版社区直接协作。需要会员资格。

上方的徽章追踪的是公开仓库（AgriciDaniel/claude-blog），因为私有镜像对shields.io不可见。发布工作流程（私有开发、审查、公开发布）记录在docs/PUBLISHING.md中。

博客： 了解claude-blog是如何工作的

**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输出的简化样本：

---
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（完整的审计跟踪）。

目录

• 演示
• 快速开始
• 命令
• claude-blog对比如何？
• 特性
• 交付契约（v1.9.0）
• 架构
• 需求
• 常见问题
• 路线图
• 卸载
• 集成
• 文档
• 如何引用
• 安全性及行为准则
• 贡献
• 许可证
• 相关项目
• 作者

演示

在YouTube上观看演示

快速开始

ℹ️ 您要安装哪个版本？

• 不是AI营销中心专业版会员？ 从公开仓库安装：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社区中直接私信以获取添加。

插件安装（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是重写的别名）+ 1个仅内部使用的（blog-chart，由blog-write/blog-rewrite调用以生成内联SVG图表）。blog-image既可由用户调用，也可由内部调用。

claude-blog对比如何？

claude-blog是一个结构化的管道。直接使用LLM提示是一次性的。托管型SaaS工具是闭源的。以下是客观的权衡矩阵：

claude-blog并非在所有方面都更优。对于单次废弃性草稿，直接提示更快。对于非开发者而言，托管型SaaS更容易使用。自己构建对于独特的管道更灵活。claude-blog适用于那些希望以规模化的方式获得生产级内容，而又不想购买SaaS订阅的场景。

特性

12种内容模板

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

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的标签和分类同步。包括标签建议、同步和审计工作流。

双重优化

每篇文章同时针对谷歌排名和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/下的五份参考文件定义了应用于所有子技能的编辑和研究方法论。它们由调度器按需加载：

改编自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关交付契约运行器和代码检查）。
• 可选：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声明了相同的命令集。

在推送前本地运行：

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的公开开源版本采用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。

我可以用多种语言使用claude-blog吗？

可以。/blog multilingual <topic> --languages en,de,fr,es,ja会撰写文章，翻译时保留frontmatter和结构化数据，针对每个地区进行文化深度适配，并在单个命令中输出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次审查阻塞后升级，而非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）。

可选配套技能（对已发布页面进行更深入的分析）：

文档

详细文档位于docs/目录下：

• 安装指南：Unix、macOS、Windows、手动安装。
• 命令参考：包含示例的完整命令参考。
• 架构：系统设计和组件概述。
• 发布工作流：私有到公开的发布流程（面向专业版维护者）。
• 模板：模板参考和自定义。
• 故障排除：常见问题和解决方案。
• MCP集成：可选MCP服务器设置。

如何引用

如果您在研究或生产中使用claude-blog，请引用该项目：

@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文件。

安全性及行为准则

• 安全策略 + 威胁模型：SECURITY.md。v1.8.x强化环节关闭了所有已知发现；v1.9.0增加了XSS安全的JSON-LD、O_NOFOLLOW符号链接拒绝以及frontmatter验证，全部经过变异测试验证。如需私下报告漏洞，请遵循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营销中心：免费社区，2800多名成员。专业版位于ai-marketing-hub-pro，托管此技能的私有镜像。

Star历史

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

作者

由AI工作流架构师Daniel Agrici使用Claude Code构建。

• 博客：关于AI营销自动化的深度文章。
• YouTube：教程和演示。
• 所有开源工具：其他Claude Code技能。
• AI营销中心：面向AI驱动营销的免费社区。