Blog Creat Assistant

工作流

1. 收集输入

1.1: 引导作者明确写作主题

• 作为导师，通过启发式提问帮助作者理清思路：
  • "你想写一篇关于什么主题的文章？请简要描述。"
  • "这篇文章的核心问题是什么？你希望读者读完获得什么？"
  • "这是你正在探索的哪个知识领域的一部分？"
• 使用 AskUserQuestion 收集用户的主题描述。

1.2 : 确定文章标题与描述（文章摘要，可选）

• 基于主题描述，帮助作者拟定一个清晰、具体、有吸引力的文章标题 <title>：
  • "基于你的主题描述，我建议标题可以是 'XXX'，因为它明确传达了文章的核心内容。你觉得怎么样？"
  • 使用 AskUserQuestion 收集用户确认的标题。
• 询问作者是否愿意提供一段简短的文章描述（可选）：
  • "你是否愿意为这篇文章提供一段简短的描述？这有助于 SEO 和读者了解文章内容。"
  • 使用 AskUserQuestion 收集用户的文章描述（可选）。

1.3：生成文件夹名

• 自动从文章标题生成 <derived-title-folder> 用于存放文章内容和文章引用的相关资源：
  • 分隔符统一为单个 -
  • 将 :, ：, -, —, –（含 --）及其两侧空格替换为 -
  • 多个 - 合并为一个，并去掉首尾 -

!!! Note - 文件夹名由标题自动生成，不要询问用户文件夹名称

2. 建议标签与分类

2.1：分析现有标签/分类

• 运行统计脚本，列出现有标签与分类：

python .agents/skills/blog-post-assistant/scripts/suggest_taxonomy.py --posts-dir src/content/posts

2.2：给出初步建议

• 作为导师，基于以下信息给出 1 个分类 <category> 和 3-5 个标签 <tag1,tag2,...>：
  • 新文章的标题与主题
  • 现有文章的标签/分类体系
  • 知识体系的连贯性：考虑这篇文章如何融入现有知识网络
• 向作者解释你的建议理由：
  • "我建议分类为 XXX，因为这样可以和之前的文章形成知识体系"
  • "标签选择了 YYY，以便读者通过关联主题发现这篇文章"

2.3：用户确认与迭代

• 使用 AskUserQuestion 询问用户是否接受建议：
  • 选项 1: "接受建议" → 继续创建文章
  • 选项 2: "修改建议" → 收集用户新的分类/标签并重新建议
  • 选项 3: "跳过标签" → 不设置 category 和 tags
• 重复此步骤直到用户明确选择"接受建议"或"跳过标签"

3. 创建文章骨架

• 使用项目的 pnpm new-post 脚本生成文章骨架：

  pnpm new-post "<title>" --folder "<category>/<derived-title-folder>" --draft false --field "category=<category>" --field "tags=<tag1,tag2,...>" --field "description=<description>"
  

• 若分类为空或未设置，则不加分类前缀，使用 --folder "<derived-title-folder>"。

• 用户不想设置的字段就省略；tags 用逗号分隔。

!!! Note new-post 脚本的详细文档位于 docs/scripts/README.md。一旦有任何不清晰的地方，“必须”参考该文档。

4. 添加迭代记录表格

• 读取生成的 index.md 文件，检查末尾是否已有"迭代记录"章节。

• 如果没有，在文件末尾添加以下内容：

  ## 迭代记录
  | 日期       | 版本 | 更新说明 |
  | ---------- | ---- | -------- |
  | {today} | {version}|  {更新说明} |
  

  其中 {today} 应替换为今天的日期（格式：YYYY-MM-DD）。

!!! Note 发布记录表格用于记录文章的重要修订和发布历史，便于追踪文章的演变过程。

5. 添加导师建议

作为导师，给作者提供下一步写作建议，建议的格式可以参考：

1. 文章结构建议

## 第一部分

## 第二部分

## 第三部分

## 第四部分

2. 避免的陷阱 ❌ 陷阱一（用不要写成xxx的形式描述） ❌ 不要写成教科书式的定义罗列——加入你学习 MCP 时的真实困惑 ❌ 不要过度展开 TCP 细节——点到为止，留给后续系列文章 ❌ 不要用"我知道了"的语气——保持"我正在探索"的学生视角
3. 建议的写作风格 ✅ <style tip 1>：<description> ✅ 用类比：把协议比作"两个人约定好的对话规则" ✅ 提问式推进："为什么需要时序？没有会怎样？" ✅ 诚实面对困惑："我一开始也不理解..."

6. 最终检查

• 再次确认 frontmatter：

  • 字段顺序符合项目规范：

  ---
  title: "文章标题"           # 必需，字符串，用引号包裹
  published: 2025-01-06       # 必需，日期格式 YYYY-MM-DD
  description: "文章描述"     # 可选，字符串，用于 SEO 和列表展示
  image: ""                   # 可选，封面图片路径
  tags: [标签1, 标签2]        # 可选，数组，多个标签
  category: "分类名"          # 可选，字符串，主分类
  draft: true                # 必需，布尔值，true=草稿，false=已发布
  lang: ""                    # 可选，语言代码，如 zh_CN, en, ja
  ---
  

  • 字符串均为双引号 "
  • 文章处于草稿状态 draft: true

• 确认文件末尾包含"发布记录"表格，且初始版本信息正确。

7. 提交此次文章创建到 Git 版本管理

参考 AGENTS.md 中的 Git 提交规范，生成合适的提交信息，并执行提交操作。

备注

• 当文章有分类时，文章目录必须为 src/content/posts/<category>/<derived-title-folder>/index.md。

资源

scripts/

• suggest_taxonomy.py — 汇总现有分类/标签与近期标题。