Hugo Blog Publisher

SKILL.md

---
name: hugo-blog-publisher
version: 1.1.0
description: 发布文章到 Hugo 博客。用于当用户说"发布博客"、"推送到blog"、"post to blog"、"发布文章"等。自动完成 front matter 渲染、<!--more--> 标记添加、git 推送流程。
---

# Hugo Blog Publisher

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

## 自动读取配置

此 Skill 会自动尝试从以下位置读取博客配置：
1. 用户记忆文件（MEMORY.md / USER.md）中的博客域名、路径等
2. 博客目录下的 .git 配置

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

## 使用前提

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. frontmatter 中使用英文 slug：
   ```yaml
   tags: ["ssg", "ssr"]
   categories: ["tech"]
   ```

2. 如果遇到新标签/分类没有映射文件，需要创建：
   ```
   content/tags/<slug>/_index.md
   content/categories/<slug>/_index.md
   ```

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. 添加 <!--more--> 截断标记

在第一段或导言后添加 `<!--more-->`，让列表页显示摘要。

位置通常在：
- 第一段结束后的空行
- 导言和正文之间

### 6. Git 推送

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

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

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

### 7. 返回部署链接

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

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

## 使用示例

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

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

## 注意事项

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