Documents

Hugo博客发布免费版

面向个人博主的 Hugo 博客发布工具，简化文章发布流程。核心能力: - 自动分析文章内容，提取标题、标签、分类 - 生成符合 Hugo 规范的 Front Matter - 自动添加截断标记（more） - Git 推送发布到远程仓库适用场景: - 个人技术博客文章发布 - Markdown 文章的 Front Matter 自动生成 - 博客内容的版本管理与推送差异化: 免费版聚焦个人博主的单篇文章发布场景，提供自动化的 Front Matter 生成与推送流程，开箱即用

What it does

The skill document

Hugo 博客发布工具（免费版）

概述

本工具为个人博主提供 Hugo 博客文章发布的自动化流程，将 Markdown 文章自动转换为符合 Hugo 规范的博客文章并推送到远程仓库。通过自动分析内容提取标题、标签、分类，生成标准化的 Front Matter，添加截断标记，并执行 Git 推送，简化从写作到发布的全流程。免费版聚焦单篇文章的发布场景，提供开箱即用的发布模板与标签映射.

核心能力

能力模块	描述	典型用法
内容分析	自动提取标题、标签、分类	`帮我发布这篇博客`
Front Matter 生成	生成 Hugo 标准格式	自动创建 YAML 头部
截断标记	自动添加 `<!--more-->`	列表页显示摘要
Git 推送	自动提交并推送	`git push`
标签映射	英文 slug 映射中文显示	自动创建 `_index.md`
技术实现要点：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置.

核心功能执行

用input_params参数进行配置.

处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.

执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志.

执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志.

执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Markdown、文章发布到、自动生成、并推送到远程仓库、面向个人博主的、博客发布工具、简化文章发布流程、自动分析文章内容、生成符合、规范的、自动添加截断标记、推送发布到远程仓等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

使用场景

场景一：发布技术文章

博主写完一篇技术文章，需要发布到 Hugo 博客.

用户：帮我发布这篇 blog（附文章内容）
# ...
助手：自动完成以下步骤
# ...
1. 分析内容
   - 标题：从内容中提取
   - 标签：根据主题判断（如 AI → ["ai"]）
   - 分类：根据类型判断（如技术文章 → ["tech"]）
# ...
2. 生成文件名
   - 格式：content/posts/{slug}.md
   - slug：标题转为 URL 友好格式（小写、连字符）
# ...
3. 渲染 Front Matter
   ---
   title: "文章标题"
   date: 2026-07-18
   draft: false
   tags: ["ai", "programming"]
   categories: ["tech"]
   description: "文章描述"
   ---
# ...
4. 添加截断标记
   在第一段后添加 <!--more-->
# ...
5. Git 推送
   cd {博客路径}
   git add content/posts/{文件名}
   git commit -m "新增：{文章标题}"
   git push
# ...
6. 返回部署链接

场景二：新标签创建

文章使用了一个博客中还不存在的标签，需要创建映射文件.

# frontmatter 中使用英文 slug
# tags: ["ssg", "ssr"]
# categories: ["tech"]
# ...
# 如果遇到新标签没有映射文件，创建 _index.md
# 标签映射文件
cat > content/tags/new-tag/_index.md << 'EOF'
---
title: "新标签中文名"
---
EOF
# ...
# 分类映射文件
cat > content/categories/new-category/_index.md << 'EOF'
---
title: "新分类中文名"
---
EOF

场景三：本地预览后发布

博主想在发布前先本地预览效果.

# 1. 本地预览
cd {博客路径}
hugo server -D  # -D 包含草稿
# ...
# 2. 浏览器访问 http://localhost:1313 预览
# ...
# 3. 确认无误后发布
# 将 draft 改为 false
sed -i 's/draft: true/draft: false/' content/posts/{文件名}.md
# ...
# 4. 推送发布
git add content/posts/{文件名}.md
git commit -m "新增：{文章标题}"
git push

不适用场景

以下场景Hugo博客发布免费版不适合处理：

纯技术文档撰写
学术论文写作
法律文书起草

触发条件

需要生成营销文案、写作内容、标题优化、内容创作时使用。不适用于非本工具能力范围的需求.

快速开始

Front Matter 规范

---
title: "文章标题"
date: 2026-07-18
draft: false
tags: ["tag1", "tag2"]
categories: ["Category"]
description: "文章描述"
---

重要规则：

categories：使用已有分类（小写英文 slug），如 tech, ai
tags：使用小写英文 slug，不要用中文
slug：文件名使用小写英文，不要用中文
date：日期在 front matter 的 date 字段中指定，文件名不包含日期

常用分类速查

Slug	中文显示
tech	技术
photo	摄影
ai	AI
investment	投资
tech-news	科技资讯
science	科学
art	艺术
life	生活
reading-notes	读书笔记

常用标签速查

Slug(续)	中文显示
ai	AI
llm	大语言模型
agent	智能体
programming	编程
thinking	思考
photography	摄影
camera	相机
photo	照片
go	Go
kubernetes	Kubernetes
rag	RAG

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

AI、RAG、NLP、Kubernetes、Go、Elasticsearch、PHP、SQL、SSG、SSR 等技术名称用英文 slug

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

示例

截断标记位置

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

---
title: "我的文章"
date: 2026-07-18
draft: false
tags: ["programming"]
categories: ["tech"]
---
# ...
这是文章的导言部分，会在列表页显示.
# ...
<!--more-->
# ...
这是正文内容，不会在列表页显示.

Git 推送流程

# 从博客目录自动检测 git 状态并推送
cd {博客路径}
# ...
# 添加新文章
# ...
# 提交（建议用"新增:"前缀）
git commit -m "新增：{文章标题}"
# ...
# 推送到远程
git push

配置自动读取

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

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

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

最佳实践

slug 使用英文：文件名使用小写英文，不要用中文
```
# 正确
content/posts/getting-started-with-hugo.md
```

...

错误

content/posts/Hugo入门指南.md


2. **标签用英文 slug**：frontmatter 中用英文，页面展示用中文（通过 `_index.md`）

3. **截断标记位置**：放在第一段结束后的空行，或导言和正文之间

4. **commit message 规范**：建议用 `新增:` 前缀
```bash
git commit -m "新增：Hugo 博客发布指南"

发布前预览：使用 hugo server -D 本地预览
配置 SSH Key：确保 git push 不需要每次输入密码

常见问题

Q1：如何生成 URL 友好的 slug？

# 英文标题：直接转为小写连字符
"Getting Started with Hugo" → "getting-started-with-hugo"
# ...
# 中文标题：可用拼音或英文关键词
"Hugo 入门指南" → "hugo-getting-started" 或 "hugo-ru-men-zhi-nan"

Q2：如何创建新的标签映射？

# 创建标签映射文件
mkdir -p content/tags/new-tag
---
title: "新标签"
---
EOF

Q3：文章发布后看不到怎么办？

# 1. 检查 draft 是否为 false
grep "draft:" content/posts/{文件名}.md
# ...
# 2. 检查日期是否是未来时间
grep "date:" content/posts/{文件名}.md
# ...
# 3. 本地预览（包含草稿）
hugo server -D
# ...
# 4. 检查文件路径是否正确
ls content/posts/

Q4：如何修改已发布文章？

# 1. 编辑文章
# 2. 更新 date 或添加 lastmod
---
title: "文章标题"
date: 2026-07-18
lastmod: 2026-07-19
---
# ...
# 3. 推送更新
git commit -m "更新：{文章标题}"
git push

Q5：git push 需要认证怎么办？

# 方案一：配置 SSH Key
ssh-keygen -t ed25519 -C "your_email@example.com"
# 将公钥添加到 Git 平台
# ...
# 方案二：配置凭据缓存
git config --global credential.helper cache
helper "cache --timeout=3600"

Q6：如何批量发布多篇文章？

# 批量添加
git add content/posts/*.md
# ...
# 批量提交
git commit -m "新增：批量发布多篇文章"
# ...
# 推送
git push

依赖说明

运行环境

Agent 平台: 支持读取 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
操作系统: Windows / macOS / Linux
Hugo 版本: 建议 0.100 及以上
Git: 需要配置远程仓库访问权限

依赖详情

依赖项	类型	是否必需	获取方式
Hugo	静态站点生成器	推荐	gohugo.io 下载
Git	命令行工具	必需	系统包管理器安装
LLM API	API	必需	由 Agent 内置 LLM 提供

API Key 配置

本工具为纯 Markdown 指令驱动，无需额外 API Key
Git 推送需要配置 SSH Key 或个人访问令牌

可用性分类

分类: MD+EXEC（Markdown 指令 + 命令行执行）
说明: 通过自然语言指令驱动 Agent 执行博客发布流程，Git 推送需要命令行执行能力

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

已知限制

需LLM支持,无LLM环境不可用
复杂业务场景建议结合人工经验判断
执行效率受模型能力与网络环境影响
当前为免费版本,如需完整功能请升级到付费版获取全部能力

输出格式

{
  "success": true,
  "data": {
    "result": "Hugo博客发布免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "hugo blog"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}