claude-blog五道质量闸门深度解析Blog Delivery Contract如何拦截低分文章交付【免费下载链接】claude-blogClaude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at AI-Marketing-Hub/claude-blog (AI Marketing Hub Pro community); public releases ship here.项目地址: https://gitcode.com/gh_mirrors/cl/claude-blogclaude-blog是一个面向 Claude Code 的 AI 博客写作与 SEO 优化技能套件它的核心卖点不是写得多快而是交付得多稳内置的Blog Delivery Contract博客交付契约会在文章交付前自动触发五道质量闸门对每篇草稿执行 100 分制评分低于 90 分或存在 P0 级问题立即拦截并最多自动迭代 3 次确保用户永远不是文章的第一位审稿人 ️。为什么需要五道质量闸门如果你用过 AI 写博客大概率踩过这些坑✅ 草稿写得不错但头图hero image忘了生成✅ HTML 渲染出来图表溢出了但没人在意✅ 链接、JSON-LD 结构数据里埋着一堆 404✅ 审稿 Agent 给了意见但写作者无视继续交付claude-blog 在 v1.9.0 之前的版本就吃过这种亏审稿环节只是建议写作者完全可以带病交付。于是项目给出的答案不是更努力而是基础设施——把质量检查变成自动触发的代码闸门写作者想跳过都跳不过去。完整的规则定义在 blog-delivery-contract.md 中。五道闸门全景Blog Delivery Contract 一张表看懂每次执行/blog write或/blog rewrite产物在展示给你之前必须顺序通过以下闸门第一道失败的闸门立即叫停整条流水线闸门强制内容实现位置1️⃣ 能力发现必需工具、Agent、环境变量在写作前全部就绪scripts/blog_preflight.py --gate 12️⃣ 格式完整性.md.html.pdf 真实头图四件套齐全scripts/blog_render.py、scripts/generate_hero.py3️⃣ 视觉验证三档视口截图无溢出、无控制台报错、JSON-LD 合法scripts/blog_preflight.py --gate 34️⃣ 内容评审blog-reviewer评分 ≥ 90/100 且零 P0 问题agents/blog-reviewer.md5️⃣ 资产与链接完整性每张img可解析、每条外链返回 200、字数与 Schema 一致scripts/blog_preflight.py --gate 5通过全部闸门的草稿会带着preflight-report.json、review.md和三张视口截图一起交付。闸门一能力发现——开工前先清点装备这道闸门在写作开始前跑一次把项目可用能力写进capabilities.json后续四道闸门直接消费这份清单不重复探测MCP 服务器是否真正加载不是配置里写了就算API Key是否存在只检查键名绝不读取值审稿 Agentblog-reviewer是否可用——它缺失会直接 BLOCK因为没有它就无法执行闸门四简单说没有可用的头图生成路径、没有审稿 Agent文章根本不会开始写。闸门二格式完整性——四件套缺一不可每篇交付的博客必须同时包含 4 个产物产物作用slug.md唯一的事实来源canonical sourceslug.html自包含 HTML5含 BlogPosting 结构数据和 OG 社交卡片slug.pdf由渲染 HTML 生成的 PDF 版hero.(png\|jpg)1200×630 真实头图附带hero-credit.txt授权说明HTML 和 PDF 都从 Markdown 渲染而来结构上保证不会跑偏。头图则走一条阶梯式生成链AI 绘图 MCP → Gemini API → Unsplash/Pexels 等正版图库 → Openverse 公共接口第一个成功的来源生效全部失败则拦截并给出明确的配置指引。闸门三视觉验证——模拟真实用户看页面这道闸门用无头浏览器在375×812手机、768×1024平板、1280×800桌面三档视口渲染页面逐项检查保存整页截图到preview/*.png供人工复核检查所有 SVG 图表元素是否溢出父容器专治标签跑出图表区模拟深色模式重新渲染验证配色切换真的生效捕获浏览器控制台要求零报错解析script typeapplication/ldjson断言type: BlogPosting且必填字段齐全任何一项缺陷都会拦截截图全部保留作为证据 。闸门四内容评审——90 分线与 P0 双重红线这是最硬核的一道。blog-reviewerAgent 对渲染后的 HTML而非原始 Markdown打分判定规则是与的关系总分 90/100 → 拦截存在任何一条 P0 级问题如捏造统计数据→ 拦截即使总分高达 95评审结果以机器可读的BLOCKING: true/false行输出由 blog_preflight.py 直接解析编排器无需理解人类语言。完整评分细则见 quality-scoring.md。闸门五资产与链接完整性——诚实性检查最后一道闸门专抓看起来没问题、点一下就翻车的隐患每个img src必须能解析本地路径禁止符号链接逃逸外链检查先解析 DNS 再连接拒绝回环地址、内网地址和云元数据地址防 SSRF 攻击og:image社交分享图必须可访问JSON-LD 里声明的wordCount与正文实际字数偏差不得超过 ±5%——专门拦截声称 1715 字、实际只有 1400 字这类诚实性缺陷100 分质量评分体系低分文章如何被量化拦截闸门四的评分依据是一套五维 100 分模型维度分值考察重点内容质量30深度、可读性、原创性、读者价值SEO 优化25标题层级、关键词、内链、Meta 描述E-E-A-T 信号15作者署名、来源可溯、信任指标技术要素15Schema 基线、图片优化、页面性能、OG 标签AI 引用就绪度15可摘录段落、实体清晰度、AI 爬虫可访问性评分带与处置动作分数段评级交付契约的处置90–100Exceptional✅ 可直接交付80–89Strong 触发迭代重写70–79Acceptable 触发迭代重写 70不达标⛔ 先被 pre-commit 闸门拦下值得注意的细节项目里还有另一道闸门 quality_gate.py在提交代码时拦截 70 分以下的博客——两道闸门一个管仓库、一个管交付标准不同互不替代。拦截之后会发生什么最多 3 次自动迭代循环被拦截 ≠ 直接失败。编排器skills/blog/SKILL.md会驱动一个重试循环捕获诊断哪道闸门失败、具体哪一项检查、附截图或评分卡按闸门定向修复缺产物 → 重新渲染视觉溢出 → 调整布局分数不够 → 带着评审报告重新派发写作 Agent 先修最低分类链接 404 → 定向替换从闸门一全量重跑防止修复过程中能力发生变化通过 → 交付并标注经过 N 次迭代3 次仍失败 → 停止自动重试向用户展示全部失败诊断、部分草稿和最新评审报告明确提示需人工修复循环计数器只由编排器持有子技能永不自行循环避免两个 Agent 互相踢皮球导致无限迭代。快速上手三步体验五道质量闸门第一步克隆仓库并安装git clone https://gitcode.com/gh_mirrors/cl/claude-blog cd claude-blog bash install.sh要求已安装并配置 Claude Code CLI Python 3.11。详细安装说明见 docs/INSTALLATION.md。第二步重新打开 Claude Code让技能生效。第三步生成一篇受闸门保护的文章/blog write 你的主题完成后检查草稿文件夹preflight-report.json机器可读的闸门结果、review.md人工可读的评审报告、preview/*.png三档视口截图都在其中——这就是这篇文章为什么通过的完整证据链。常见问题 FAQQ1可以绕过五道闸门吗严格模式strict是默认值唯一的绕过方式是显式的--no-strict操作者标志。任何绕过都会大声记录警告日志且草稿 frontmatter 作为不可信内容永远不能自行关闭闸门。绕过只建议用于确认误报和查看中间产物两种场景不用于正式发布。Q2分数 95 但还是被拦了为什么只要存在一条 P0 级问题比如一个承重的捏造统计无论总分多高都会 BLOCK。P0 是独立于数值的绝对过滤器评分再高也平均不掉风险。Q3五道闸门和 70 分 pre-commit 闸门什么关系quality_gate.py 是仓库侧防线提交时拦截 70 分以下文章Blog Delivery Contract 是交付侧防线交付时要求 90 分 零 P0 四件套齐全。前者管能不能进仓库后者管能不能到你手上。小结claude-blog 的 Blog Delivery Contract 把审稿从一句建议变成了 5 道自动触发、不可跳过的代码闸门能力发现 → 格式完整性 → 视觉验证 → 内容评审 → 资产链接完整性配上 100 分制评分、90 分交付线和最多 3 次定向迭代。对新手来说这意味着你拿到的不再是一份看起来不错的草稿而是一套带完整质量证据的可交付产物。想深入了解建议从 skills/blog/references/blog-delivery-contract.md 和 docs/ARCHITECTURE.md 开始读起 。【免费下载链接】claude-blogClaude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at AI-Marketing-Hub/claude-blog (AI Marketing Hub Pro community); public releases ship here.项目地址: https://gitcode.com/gh_mirrors/cl/claude-blog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考