SkillMap

Oct 25, 2026

用 claude-blog 的 30 条 /blog 命令发布带门禁的博客文章

claude-blog 是一套 32 个目录的 Claude Code skill 套件——一个编排器加 31 个子 skill，对外是 30 条 /blog 命令——负责写作、改写、审计、翻译与刷新文章，并且在 5 道门禁的交付契约给出 90 分及以上之前，拒绝把草稿拿给你看。

#tutorial#seo#claude-code#productivity

大多数写博客的提示词让你成为模型所有产出的第一位审稿人。claude-blog 是 Daniel Agrici 的一套 3k 星、MIT 许可的 skill 套件，它把这件事反了过来：5 道门禁的 Blog Delivery Contract 按 100 分的评分表给每份草稿打分，低于 90 分就拦下不交付，核验产物与链接，最多迭代三次之后才升级到你这里。

为什么这个 Skill 重要

这套套件是一台覆盖全生命周期的博客引擎——策略、brief、提纲、写作、改写、分析、schema、AI 引用就绪度、站点审计、主题集群、多语言发布、音频朗读与内容衰退检测。它的 v2.3.1 形态（于 2026-10-13 准备）是 32 个 skill 目录：skills/blog/SKILL.md 里的一个编排器，加上 skills/blog-* 下的 31 个子 skill，对外暴露为 30 条面向用户的 /blog 命令（blog-chart 仅供内部使用），另有 5 个专门的 agent、22 份核心参考文档与 12 个模板。

编排器解析 /blog 输入，检测目标平台——Next.js MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby 或静态 HTML——只加载它需要的参考文档，路由到某个子 skill，并通过交付契约协调 agent 与脚本。每份草稿都以一个产物文件夹交付：markdown 源文件、渲染后的 HTML、PDF、一张真实的 hero.<ext>、三个视口的截图、review.md 与 preflight-report.json。

安装

插件安装，已在 Claude Code 2.1.296 上测试：

/plugin marketplace add AgriciDaniel/claude-blog
/plugin install claude-blog@agricidaniel-blog

README 把这些 skill 依赖的 ${CLAUDE_SKILL_DIR} 变量追溯到 Claude Code 2.1.69，所以这是它能够证明支持的最老版本。安装后重启 Claude Code。要求是 Claude Code CLI 以及用于评分、契约运行器、渲染器与 lint 的 Python 3.11+；pip install -r requirements.txt 是可选的，用于高级分析、可读性评分、schema 检测与媒体工作流。

另有一个面向 Unix、macOS 与 Windows 的独立安装器。README 推荐的流程是：克隆，git checkout <commit-sha-or-release-tag>，审阅 install.sh、uninstall.sh 与 scripts/installer_ownership.py，然后运行 ./install.sh。请留意它的警告：不要从 v2.2.0 tag 安装或卸载，该版本的 uninstall.sh 会递归删除整个 blog 与 blog-* skill 目录，包括你自己添加的文件；v2.3.0 是第一个带有所有权感知安装器的发布版。

实战：先定策略，再产出一篇通过门禁的文章

  1. README 的首次运行顺序是策略、写作、分析：
/blog strategy <niche>
/blog write <topic>
/blog analyze <file-or-url>
  1. /blog write 按固定顺序运行：起草，落实占位标记与视觉素材，渲染，签发审查 nonce，审查，跑门禁——任何编辑之后都要重新渲染、重新签发、重新审查，最多三次迭代。
  2. 第 1 道门（能力发现）在写作前确认所需的工具、agent、环境变量与可选依赖。第 2 道门（格式完整性）检查的内容包括：.md、.html、.pdf 与一张解码后不小于 1200×630 的主图都存在，没有残留的 [IMAGE]、[CHART] 或 [INTERNAL-LINK] 标记，HTML 里的 blog-source-sha256 与 .md 一致。第 3 道门（视觉核验）通过 patchright 或 playwright 在 375、768 与 1280 宽度下截图，并检查 JSON-LD 有效、深色模式正常、SVG 不溢出、没有被隐藏的正文。
  3. 第 4 道门（内容审查）是那道拦截式审查：blog-reviewer 必须打出 90 分及以上、零 P0 问题、nonce 匹配，并且在 nonce 签发后草稿没有改动——过期的审查算违规。第 5 道门（资源与链接完整性）检查图片可解析、og:image 存在、链接满足已核验 URL 政策，以及字数与 schema 的偏差在 5% 以内。
  4. 主图来自一条阶梯——Banana MCP、直连 Gemini API、付费图库 API，最后是 Openverse——第一个可用的来源胜出。

评分分五类：内容质量 30 分、SEO 优化 25 分、E-E-A-T 信号 15 分、技术要素 15 分、AI 引用就绪度 15 分。分段为卓越（90–100）、强（80–89）、可接受（70–79）、低于标准（60–69）与重写（60 以下）；契约拦下低于 90 分的交付。

技巧

  • /blog brand 写出 BRAND.md 与 VOICE.md，所有子 skill 都会自动加载；/blog style learn <paths> 从你自己的 5 到 10 篇文章里学出作者的声音画像。
  • /blog multilingual <topic> --languages <codes> 一条命令完成写作、翻译、本地化并输出 hreflang；/blog localize 面向 DACH、FR、ES、JA 或自定义地区做文化层面的深度适配，/blog locale-audit <directory> 检查完整性、hreflang、内容对等与新鲜度。
  • /blog factcheck <file> 抓取被引用的来源 URL，把每条论断评为精确匹配、转述或未找到；blog-reviewer 把缺少充分来源支撑的关键论断视为 P0，直接拦下交付。
  • /blog decay <current-gsc> <previous-gsc> 从 Search Console 导出数据里标出季度环比下降 20% 及以上的流量，并建议刷新、合并或剪除。
  • /blog update <file> 是路由到 blog-rewrite 的新鲜度别名——这就是为什么 README 的表格有 31 行，而命令数记作 30 条。
  • 第 5 道门检查外链时需要网络。一篇完全本地的文章可以离线通过，因为渲染器自己的页脚链接只检查 scheme，而外链失败也可能是网络或 DNS 问题，而不是死链。
  • 在 Claude Code 2.1.292 及更新版本上，claude plugin validate 会报告 Plugin name "claude-blog" is reserved，因为以 claude- 开头的第三方插件名被保留给 Anthropic。在维护者的测试中，插件仍然可以安装和加载；README 称这是一个校验错误而非观察到的安装失败，并提到未来的版本可能会在安装时强制执行。

何时不用这个 Skill

README 自己的维护者意见——署明 2026-10-12、并标注"不是基准测试"——划出了界线：单篇用完即弃的草稿，直接提示更快；托管写作工具对非开发者更容易上手；自己搭流水线对特殊需求更灵活。claude-blog 面向的是已经在用 Claude Code 并且想要一套可重复、有门禁、读得懂也改得动的工作流的人。这些门禁也默认了各自的工具链：第 3 道门需要 patchright 或 playwright，主图阶梯要去拿 Banana MCP、Gemini、图库 API 或 Openverse，而第 1 道门存在的意义就是在动笔之前告诉你缺了什么。

查看 排行榜 了解更多 skill。