284 lines
12 KiB
Markdown
284 lines
12 KiB
Markdown
# AI博客创作技能
|
||
|
||
`博客` `AI写作` `SEO` `Claude Code` `内容管理`
|
||
|
||
# claude-blog - Claude Code 的 AI 博客创作技能
|
||
|
||
|
||
|
||
[](https://github.com/AgriciDaniel/claude-blog/actions/workflows/ci.yml)
|
||
[](https://github.com/AgriciDaniel/claude-blog/releases/latest)
|
||
|
||
|
||
|
||
|
||
|
||
> **博客：** [了解 claude-blog 的工作原理](https://agricidaniel.com/blog/claude-code-blog-writer)
|
||
|
||
claude-blog 是一个 Claude Code 技能生态系统，用于大规模创建、优化和管理博客内容。它能生成完整文章、内容简报、编辑日历和结构化数据，同时针对 Google 排名和 AI 引用平台（ChatGPT、Perplexity、AI Overviews）进行双重优化。
|
||
|
||
## 目录
|
||
|
||
- [演示](#演示)
|
||
- [快速开始](#快速开始)
|
||
- [命令](#命令)
|
||
- [功能](#功能)
|
||
- [架构](#架构)
|
||
- [环境要求](#环境要求)
|
||
- [卸载](#卸载)
|
||
- [集成](#集成)
|
||
- [文档](#文档)
|
||
- [贡献](#贡献)
|
||
- [许可证](#许可证)
|
||
|
||
## 演示
|
||
|
||
[在 YouTube 上观看演示](https://www.youtube.com/watch?v=AeLC4iutG8w)
|
||
|
||
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
**插件安装（Claude Code 1.0.33+）：**
|
||
|
||
```bash
|
||
# 添加插件市场（一次性操作）
|
||
/plugin marketplace add AgriciDaniel/claude-blog
|
||
|
||
# 安装插件
|
||
/plugin install claude-blog@AgriciDaniel-claude-blog
|
||
```
|
||
|
||
**一键安装（Unix/macOS）：**
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/install.sh | bash
|
||
```
|
||
|
||
**或克隆后手动安装：**
|
||
|
||
```bash
|
||
git clone https://github.com/AgriciDaniel/claude-blog.git
|
||
cd claude-blog
|
||
chmod +x install.sh && ./install.sh
|
||
```
|
||
|
||
**Windows（PowerShell）：**
|
||
```powershell
|
||
.\install.ps1
|
||
```
|
||
|
||
安装后重启 Claude Code 以激活。
|
||
|
||
## 命令
|
||
|
||
|
||
|
||
| 命令 | 说明 |
|
||
|---------|-------------|
|
||
| `/blog write <主题>` | 从头开始撰写新博客文章 |
|
||
| `/blog rewrite <文件>` | 优化现有博客文章 |
|
||
| `/blog analyze <文件>` | 质量审计，输出 0-100 分 |
|
||
| `/blog brief <主题>` | 生成详细的内容简报 |
|
||
| `/blog calendar` | 生成编辑日历 |
|
||
| `/blog strategy <领域>` | 博客策略与选题创意 |
|
||
| `/blog outline <主题>` | 基于 SERP 数据的内容大纲 |
|
||
| `/blog seo-check <文件>` | 写作后的 SEO 验证 |
|
||
| `/blog schema <文件>` | 生成 JSON-LD 结构化数据 |
|
||
| `/blog repurpose <文件>` | 改编为社交媒体、邮件、YouTube 内容 |
|
||
| `/blog geo <文件>` | AI 引用就绪性审计 |
|
||
| `/blog image [generate\|edit\|setup]` | 通过 Gemini 生成 AI 图像 |
|
||
| `/blog audit [目录]` | 全站博客健康度评估 |
|
||
| `/blog cannibalization [目录]` | 检测文章间关键词重叠 |
|
||
| `/blog factcheck <文件>` | 核实引用来源中的统计数据 |
|
||
| `/blog persona [create\|list\|apply]` | 管理写作人设和风格档案 |
|
||
| `/blog taxonomy [sync\|audit\|suggest]` | 标签/分类 CMS 管理 |
|
||
| `/blog notebooklm <问题>` | 通过 NotebookLM 进行来源可靠的研究查询 |
|
||
| `/blog audio [generate\|voices\|setup]` | 通过 Gemini TTS 生成音频旁白 |
|
||
| `/blog google [命令] [参数]` | Google API 数据：PSI、CrUX、GSC、GA4、NLP、YouTube、关键词 |
|
||
|
||
> **共 22 个子技能**：上方 20 个面向用户的命令 + `blog-chart`（内部 SVG 图表生成）+ `blog-image`（也可由 write/rewrite 内部调用）。
|
||
|
||
## 功能
|
||
|
||
### 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）。
|
||
|
||
### AI 内容检测
|
||
突发性评分、已知 AI 用语检测（17 个短语）、词汇多样性分析（TTR）。标记具有 AI 生成特征的内容。
|
||
|
||
### 人设驱动写作
|
||
可配置的写作人设，采用 NNGroup 四维语气框架。支持按博客或作者管理风格档案，包含可读性层次（消费者/专业/技术）和风格规范。
|
||
|
||
### 事实核查流程
|
||
统计数据验证，获取引用来源 URL 并评估声明可信度（精确匹配、释义、未找到）。确保内容中每个数据点均准确可溯源。
|
||
|
||
### 关键词蚕食检测
|
||
使用本地 grep 分析或 DataForSEO API 识别博客文章间的关键词重叠。提供严重程度评分及合并/差异化建议，防止文章间相互竞争。
|
||
|
||
### CMS 分类法管理
|
||
标签和分类管理，支持 WordPress REST、Shopify GraphQL、Ghost、Strapi 和 Sanity。包含标签建议、同步和审计工作流。
|
||
|
||
### 双重优化
|
||
每篇文章同时针对 Google 排名和 AI 引用平台进行优化：
|
||
- **Google**：符合 2025 年 12 月核心更新要求、E-E-A-T、结构化数据、内链
|
||
- **AI 引用**：答案优先格式（引用率提升 340%）、引用胶囊、段落级可引用性、FAQ 结构化数据（引用率提升 28%）
|
||
|
||
### 视觉媒体
|
||
- Pixabay/Unsplash/Pexels 图片来源及 alt 文本
|
||
- 通过 Gemini 生成 AI 图像（题图、正文插图、社交卡片），可选，需免费 Google AI API 密钥
|
||
- 内置 SVG 图表生成（条形图、分组条形图、棒棒糖图、环形图、折线图、面积图、雷达图）
|
||
- YouTube 视频嵌入，支持 srcdoc 懒加载、noscript AI 爬虫回退及质量评分
|
||
- 按内容类型设定图片密度目标
|
||
- 图片 URL 验证（嵌入前检查 HTTP 200 状态）
|
||
|
||
### Google API 集成（v1.6.5 新增）
|
||
跨 4 个凭据层级的 13 个命令，正常使用均免费：
|
||
- **第 0 层**（API 密钥）：PageSpeed Insights、CrUX 核心 Web 指标（25 周历史数据）、YouTube 视频搜索、NLP 实体分析
|
||
- **第 1 层**（OAuth）：Search Console 效果数据、URL 检查、Indexing API
|
||
- **第 2 层**（GA4）：自然流量报告
|
||
- **第 3 层**（Ads）：Google Ads 关键词规划工具
|
||
|
||
### NotebookLM 研究
|
||
查询 Google NotebookLM，从用户上传的文档中获取来源可靠的研究内容。第 1 层数据质量，零幻觉风险。
|
||
|
||
### 音频旁白
|
||
通过 Gemini TTS 生成音频旁白。三种模式：摘要（200-300 字）、完整文章和双人对话。支持 30 种声音、80 余种语言。
|
||
|
||
### 平台支持
|
||
Next.js/MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby 及静态 HTML。
|
||
|
||
## 架构
|
||
|
||
```
|
||
claude-blog/
|
||
├── .claude-plugin/
|
||
│ └── plugin.json # 插件元数据（名称、描述、作者）
|
||
├── skills/
|
||
│ ├── blog/ # 主编排器
|
||
│ │ ├── SKILL.md # 路由全部 21 个命令
|
||
│ │ ├── references/ # 13 个按需参考文档
|
||
│ │ └── templates/ # 12 种内容类型模板
|
||
│ ├── blog-write/SKILL.md # 子技能（21 个面向用户 + 1 个内部）
|
||
│ ├── blog-rewrite/SKILL.md
|
||
│ ├── blog-analyze/SKILL.md
|
||
│ ├── blog-brief/SKILL.md
|
||
│ ├── blog-calendar/SKILL.md
|
||
│ ├── blog-strategy/SKILL.md
|
||
│ ├── blog-outline/SKILL.md
|
||
│ ├── blog-seo-check/SKILL.md
|
||
│ ├── blog-schema/SKILL.md
|
||
│ ├── blog-repurpose/SKILL.md
|
||
│ ├── blog-geo/SKILL.md
|
||
│ ├── blog-audit/SKILL.md
|
||
│ ├── blog-chart/SKILL.md # 内部：SVG 图表生成
|
||
│ ├── blog-image/ # 通过 Gemini 生成 AI 图像
|
||
│ │ ├── SKILL.md
|
||
│ │ ├── references/ # 3 个参考文档（模型、工具、提示词）
|
||
│ │ └── scripts/ # MCP 设置和验证脚本
|
||
│ ├── blog-cannibalization/SKILL.md # 关键词重叠检测
|
||
│ ├── blog-factcheck/SKILL.md # 统计数据验证
|
||
│ ├── blog-persona/SKILL.md # 写作人设管理
|
||
│ ├── blog-taxonomy/SKILL.md # CMS 分类法管理
|
||
│ ├── blog-notebooklm/ # NotebookLM 来源可靠研究
|
||
│ │ ├── SKILL.md
|
||
│ │ ├── references/
|
||
│ │ └── scripts/ # 10 个 Python 脚本 + venv 包装器
|
||
│ ├── blog-audio/ # 通过 Gemini TTS 生成音频旁白
|
||
│ │ ├── SKILL.md
|
||
│ │ ├── references/
|
||
│ │ └── scripts/ # 5 个 Python 脚本 + venv 包装器
|
||
│ └── blog-google/ # Google API 集成（v1.6.5 新增）
|
||
│ ├── SKILL.md # 13 个命令，4 个凭据层级
|
||
│ ├── references/ # 3 个参考文档（认证、API、配额）
|
||
│ ├── scripts/ # 11 个 Google API 脚本 + venv 包装器
|
||
│ └── assets/templates/ # 3 个报告模板
|
||
├── agents/ # 4 个专用智能体
|
||
│ ├── blog-researcher.md
|
||
│ ├── blog-writer.md
|
||
│ ├── blog-seo.md
|
||
│ └── blog-reviewer.md
|
||
├── scripts/
|
||
│ └── analyze_blog.py # Python 质量分析（5 维度评分）
|
||
├── tests/ # pytest 测试套件
|
||
│ ├── conftest.py
|
||
│ └── test_analyze_blog.py
|
||
├── docs/ # 6 个文档文件
|
||
├── .github/workflows/ci.yml # CI 流水线
|
||
├── install.sh # Unix/macOS 安装程序（备用）
|
||
├── install.ps1 # Windows PowerShell 安装程序
|
||
├── pyproject.toml # Python 项目配置
|
||
├── requirements.txt # Python 依赖
|
||
├── CONTRIBUTING.md
|
||
├── CHANGELOG.md
|
||
├── LICENSE
|
||
└── README.md
|
||
```
|
||
|
||
## 环境要求
|
||
|
||
- 已安装并配置 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI
|
||
- Python 3.11+（用于 `analyze_blog.py` 质量评分脚本）
|
||
- 可选：`pip install -r requirements.txt` 用于高级分析（可读性评分、结构化数据检测）
|
||
|
||
## 卸载
|
||
|
||
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/TEMPLATES.md)：模板参考与自定义说明
|
||
- [故障排查](docs/TROUBLESHOOTING.md)：常见问题与解决方案
|
||
- [MCP 集成](docs/MCP-INTEGRATION.md)：可选 MCP 服务器设置
|
||
|
||
## 贡献
|
||
|
||
欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。
|
||
|
||
## 许可证
|
||
|
||
MIT 许可证。详情请参阅 [LICENSE](LICENSE)。
|
||
|
||
---
|
||
|
||
由 [AgriciDaniel](https://github.com/AgriciDaniel) 使用 Claude Code 构建。 |