以claude-blog为样本学习Agent Skills开发从编排路由到代码级质量门禁的完整指南【免费下载链接】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 Agent Skills 的新手来说claude-blog 是一个难得的完整样本32 个技能目录1 个编排器 31 个子技能、5 个专职 Agent、5 道代码级质量门禁全部开源可读。本文带你从编排路由、按需加载到质量门禁拆解它构建 Agent Skills 的 5 个核心方法。1. 架构总览技能、Agent、脚本三层协作打开 docs/ARCHITECTURE.md你会发现整个系统分三层层级数量位置技能目录32skills/blogskills/blog-*专职 Agent5agents/blog-*.mdPython 脚本14scripts/*.py参考文档22skills/blog/references/*.md核心思想一句话Markdown 负责教脚本负责管。SKILL.md 用自然语言写清工作流程而所有关键校验都由 Python 脚本强制执行不依赖模型自觉。2. 编排路由一个入口解析全部 30 个命令学习 Agent Skills 开发第一步是理解路由。主编排器 skills/blog/SKILL.md 承担了四件事解析命令用户输入/blog 子命令编排器根据路由表分发比如write→blog-write、analyze→blog-analyze、geo→blog-geo平台检测根据文件后缀和项目结构如hugo.toml、wp-content/自动识别博客平台适配输出格式按需加载参考文档下节详述执行质量门禁任何子技能产出的内容都必须过门禁才能交付给用户的只是 30 个/blog命令完整清单见 docs/COMMANDS.md而blog-chart这类内部子技能不暴露——命令面越收敛用户心智负担越低这是新手最容易忽略的设计点。3. 按需加载用 RAG 模式控制上下文体积30 个子技能、22 篇参考文档如果全部塞进上下文既贵又慢。claude-blog 的做法是任务映射表/blog write→ 只加载content-rules.md、visual-media.md、quality-scoring.md/blog schema→ 只加载schema-stack.md/blog analyze→ 只加载quality-scoring.md这套RAG 式按需加载模式映射表写在 docs/ARCHITECTURE.md 的 On-Demand Reference Loading 一节值得直接抄每个 SKILL.md 里维护一张任务 → 参考文件的表用到才读。4. 多 Agent 分工最小权限原则5 个 Agent 定义在agents/目录下每个都有独立的 YAML frontmatter 声明职责和受限工具集Agent角色可用工具blog-researcher找统计数据和来源WebSearch, WebFetch, Read, Grepblog-writer撰写正文Read, Write, Editblog-seo页面 SEO 校验Read, Grepblog-reviewer100 分制质量评审Read, Grepblog-translator多语言翻译Read, Write, Edit两个新手要点评审者只读agents/blog-reviewer.md 没有 Write 和 Bash 权限保证它只能打分、不能改稿评审与写作彻底隔离写作 → 评审 → 打分是标准流水线/blog write的执行顺序是解析 → 研究 → 大纲 → 写作 → SEO 校验 → 评分 → 门禁交付见 skills/blog/SKILL.md 的 Execution Flow 一节5. 代码级质量门禁5-Gate 交付契约这是 claude-blog 最有价值的部分。它的 v1.9.0 交付契约完整规格见 skills/blog/references/blog-delivery-contract.md在内容生成和交付用户之间插了 5 道自动门禁门禁校验内容执行者Gate 1 能力探测工具、Agent、依赖是否齐备scripts/blog_preflight.pyGate 2 格式完整.md.html.pdf 封面图四件套齐全scripts/blog_render.pyGate 3 视觉验证三种视口截图、无 SVG 溢出、JSON-LD 合法blog_preflight.py --gate 3Gate 4 内容评审评分 ≥ 90 且无 P0 问题阻断式blog-reviewer输出BLOCKING:行Gate 5 资源与链接图片可解析、链接 200、字数与 schema 误差 ≤ 5%blog_preflight.py --gate 5三条关键设计建议逐条记住门禁失败触发迭代循环任何门禁失败都自动打回重写最多 3 轮第 3 轮仍失败则停止向用户展示诊断报告而不是强行交付。循环计数器由编排器持有子技能不许自己循环阻断式评审blog-reviewer输出以机器可读的BLOCKING: true|false行结尾由脚本解析不靠模型自由发挥绕过必须显式只有--no-strict才能跳过门禁且会大声打印警告日志——草稿 frontmatter 无权禁用门禁此外还有第二道防线scripts/quality_gate.py 作为 pre-commit 钩子在git commit时自动拦截评分低于 70 的博客文章。生成时门禁 提交时门禁双层防护是代码级质量管理的完整形态。6. 用测试锁住文档与实现不漂移最后一个新手容易忽视的环节Agent Skills 的文档本身也需要 CI。仓库的 tests/ 目录有 250 个用例其中几个针对 Skill 工程本身tests/test_blog_delivery_contract.py断言交付契约文档与其脚本实现保持一致test_reference_count_coherence断言 SKILL.md 声称的参考文档数量与实际文件数一致test_command_coherence断言编排器路由表与 docs/COMMANDS.md 声明的命令集完全相同scripts/lint_prose.py连行文规范如禁止 em dash都有脚本强制动手清单构建你自己的 Agent Skills对照 claude-blog一个合格的 Skills 项目应该包含一个主编排器 SKILL.md命令路由表 平台/输入检测 任务 → 参考文档映射单一职责子技能目录每个skills/name/SKILL.md自带 frontmatter、流程、质量检查受限工具的专职 Agent评审者只读写作者最小写权限一律去掉 Bash代码级门禁脚本把规则翻译成可执行断言preflight式失败进迭代循环而非靠提示词约束一致性测试用 pytest 锁死文档、路由表、脚本三者不漂移把这套方法搬过去你的 Skill 就不再是一堆提示词而是一条可审计、可回归的流水线。【免费下载链接】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），仅供参考