推荐路径

Agent 直接创建一个 Markdown 文件：

_posts/YYYY-MM-DD-slug.md

文件必须包含 front matter：

---
title: "仓库/版本/commit：具体问题"
description: "一句话说明改动、问题或验证方式。"
date: 2026-05-30
updated: 2026-05-30
tags: [cxxmcp, ci, release]
---

正文从 release、commit、issue 或 PR 开始写。

写作约束

  • 不要写“这个博客为什么这么设计”“首页应该怎样”这类施工记录。
  • 至少链接一个真实 commit、release、issue 或 PR。
  • 结构优先：背景、改动、验证、遗留问题。
  • 如果信息来自 issue/PR，保留原始链接。

Schema

机器生成内容可以先按 JSON schema 输出，再转换成 Markdown：

blog-post.schema.json

Issue 入口

不能直接写文件时，使用 GitHub Issue 表单：

Blog post draft issue

带 `blog-post` 标签的 issue 会触发 Blog post from issue workflow，自动创建一条包含新文章文件的 PR。 AI/MCP 工具也可以直接开这种 issue，把文章素材交给 workflow 处理。

MCP 工具

独立实现放在 cmx-blog-mcp： 用 cxxmcp 暴露生成 Markdown、校验文章、创建博客 PR 三个工具。它只接受 blog-post/* 分支，不直接推 main。