Hugo Blog Publisher

将 Markdown 文章发布到 Hugo 博客并推送到 GitHub。

自动读取配置

此 Skill 会自动尝试从以下位置读取博客配置：

1. 1. 用户记忆文件（MEMORY.md / USER.md）中的博客域名、路径等
2. 博客目录下的 .git 配置

如果未找到配置，才询问用户。

使用前提

1. 1. 本地运行：此 Skill 需要在能够访问博客目录的机器上运行
2. Git 配置：确保机器上有 Git 和 GitHub 访问权限

发布流程

1. 分析内容

从用户提供的文章内容中自动提取：

• - 标题：从 front matter 或内容中提取
• 标签：根据内容主题自动判断（如 AI → [ai]）
• 分类：根据内容类型判断（如技术文章 → [tech]）

2. 生成文件名

• - 格式: content/posts/{slug}.md
• slug: 标题转为 URL 友好格式（小写、连字符、去除特殊字符）
• 注意：文件名不要包含日期，日期在 front matter 的 date 字段中指定

3. 渲染 Front Matter

yaml

---

title: 文章标题
date: YYYY-MM-DD
draft: false
tags: [tag1, tag2]
categories: [Category]
description: 文章描述

---

重要规则：

• - categories：使用已有分类（小写英文 slug），如 tech, investment, ai, photo
• tags：使用小写英文 slug，不要用中文
• slug：文件名使用小写英文，不要用中文

4. 标签/分类映射（重要）

文章 frontmatter 用英文 slug，页面展示用中文，通过 Hugo Taxonomy Branch Bundle 实现：

1. 1. frontmatter 中使用英文 slug：

yaml tags: [ssg, ssr] categories: [tech]

1. 2. 如果遇到新标签/分类没有映射文件，需要创建：

content/tags//_index.md
content/categories//_index.md

1. 3. 文件内容极简：

yaml

---

title: 显示的中文名

---

不用 i18n，全部用 _index.md 映射！

常用分类 (categories)

Slug	中文显示
tech	技术
photo

摄影 |

| ai | AI | | investment | 投资 | | tech-news | 科技资讯 | | science | 科学 | | art | 艺术 | | life | 生活 | | reading-notes | 读书笔记 |

常用标签 (tags)

Slug	中文显示
ai	AI
llm

大语言模型 |

| agent | 智能体 | | programming | 编程 | | thinking | 思考 | | photography | 摄影 | | camera | 相机 | | photo | 照片 | | options | 期权 | | trading | 交易 | | investment | 投资 | | stock | 股票 | | php | PHP | | go | Go | | kubernetes | Kubernetes | | rag | RAG |

专属名词（保持英文显示）

• - AI、RAG、NLP、Kubernetes、Go、Elasticsearch、PHP、SQL、Kimi、DeepSeek、Claude、GPT、SSG、SSR 等技术名称用英文 slug

5. 添加 截断标记

在第一段或导言后添加 ，让列表页显示摘要。

位置通常在：

• - 第一段结束后的空行
• 导言和正文之间

6. Git 推送

从博客目录自动检测 git 状态并推送：

bash
cd {博客路径}
git add content/posts/{文件名}
git commit -m 新增：{文章标题}
git push

如果 git push 需要认证，确保用户已配置 SSH key 或 git credentials。

7. 返回部署链接

告知用户文章已发布成功。

注意：不要硬编码域名，应该根据用户提供的博客信息返回相应链接。

使用示例

用户：帮我发布这篇blog（附文章内容）

系统自动完成：

1. 1. 分析内容，提取标题、标签、分类
2. 生成文件名（slug）
3. 添加 front matter 和 标记
4. 如需新标签/分类，创建 _index.md 映射文件
5. 检测博客目录并推送
6. 返回部署链接

注意事项

• - slug 生成：英文直接用，中文可用拼音或英文关键词
• 位置：根据文章结构选择合适位置
• commit message：建议用 新增: 前缀
• 如果用户没有提供博客路径，默认用当前目录的 blog 子目录
• 所有标签/分类映射都用 _index.md 文件方式，不用 i18n/zh.toml！