道轲
·
Jekyll 博客自动化发文实践：一个可维护的 blog-post skill 是如何落地的
内容提要
本文探讨了为个人博客实现自动化发文的过程，重点在于适配现有结构、控制发布风险和确保脚本的确定性。通过分析博客仓库的实现约定，设计了结构化的命令行接口，支持创建和发布文章，确保生成的文章符合渲染约定。最终目标是简化发文流程，提高效率，并为未来的扩展奠定基础。
关键要点
-
为个人博客实现自动化发文能力，需适配现有结构、控制发布风险、确保脚本确定性。
-
目标是在 Jekyll 博客仓库中新增可被 Codex 和 Claude Code 共用的发文技能，支持创建文章和管理公开状态。
-
手动创建文章存在多个问题，如 front matter 字段遗漏、文件路径不稳定等，自动化方案需理解仓库的组织方式。
-
在设计脚本前，需确认博客的实现约定，确保生成的文章符合现有的渲染约定。
-
脚本应接收结构化参数而非自然语言，以提高可测试性和可维护性。
-
设计了三个明确的命令：sections、create 和 publish，分别负责列出文章分区、创建文章和修改已存在文章的状态。
-
front matter 生成需符合现有博客的约定，包括固定页面布局、自动补充描述和加入摘要分隔符。
-
当用户未提供完整正文时，脚本会生成一个最小可写的骨架，以确保文章结构稳定。
-
实现共享能力的核心思路是让仓库维护一套可执行的能力，减少环境差异。
-
发文自动化应视为站点工程的一部分，解决了博客发文流程中的关键环节结构化问题。
-
未来可扩展的方向包括自动校验标签与分类、增加图片资源目录的自动创建等。
延伸解读
自动化发文的必要性
在个人博客中，手动创建文章常常会导致 front matter 字段遗漏和文件路径不稳定等问题。通过自动化发文，不仅可以减少这些错误，还能提高发文效率，确保文章符合现有的渲染约定，进而提升用户体验。
脚本设计的关键
本文强调脚本应接收结构化参数而非自然语言，以提高可测试性和可维护性。这样的设计使得脚本的执行更加稳定，避免了自然语言解析带来的不确定性，从而确保了发文流程的顺畅。
未来扩展的方向
虽然当前的自动化发文能力已能满足基本需求，但仍有扩展空间。例如，未来可以增加自动校验标签与分类、图片资源目录的自动创建等功能。这些扩展将进一步提升博客管理的效率和灵活性。
延伸问答
如何为个人博客实现自动化发文能力？
需要适配现有结构、控制发布风险，并确保脚本的确定性。
自动化发文脚本的设计思路是什么？
设计脚本前需确认博客的实现约定，确保生成的文章符合现有的渲染约定。
为什么不直接使用自然语言来创建文章？
自然语言解析不稳定，影响脚本的可测试性和可维护性。
这套自动化发文技能的主要命令有哪些？
主要命令包括 sections、create 和 publish，分别用于列出文章分区、创建文章和修改文章状态。
如何确保生成的文章符合博客的渲染约定？
通过设计符合现有博客的 front matter 生成规则，确保布局和描述等信息的正确性。
未来自动化发文技能可以扩展哪些功能？
可以扩展自动校验标签与分类、增加图片资源目录的自动创建等功能。
