> 核心功能: 本技能提供标准化的、为符合、化流程等能力。

> 核心功能: 本技能提供结构化的工作流程和配置指引等能力。

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

功能说明

处理: 解析核心功能执行的输入参数,完成核心逻辑,输出结构化数据.
输出: 返回核心功能执行的响应数据,包含返回码、数据和处理记录.
- 通过input_params参数调用,支持创建/查询/导出

参数配置与调用

用config_options参数进行配置.

处理: 解析参数配置与调用的输入参数,完成核心逻辑,输出结构化数据.
输出: 返回参数配置与调用的响应数据,包含返回码、数据和处理记录.
- 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置.

处理: 解析结果处理与输出的输入参数,完成核心逻辑,输出结构化数据.
输出: 返回结果处理与输出的响应数据,包含返回码、数据和处理记录.
- 执行此能力时使用output_format参数,支持导出/保存/转换操作
能力覆盖范围：能力范围包括以下关键词：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博客发布免费版不适合处理：

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

激活条件

需要生成营销文案、写作内容、标题优化、内容创作时使用。不适用于非Hugo博客发布免费版能力范围的需求.

实操说明

Front Matter 规范

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

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

常用分类速查

常用标签速查

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

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

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

应用示例

截断标记位置

在领先段或导言后添加 <!--more-->，让列表页显示摘要.

title: "我的文章"
date: 2026-07-18
draft: false
tags: ["programming"]
categories: ["tech"]

...

这是文章的导言部分，会在列表页显示.

...

<!--more-->

...

这是正文内容，不会在列表页显示.

# 请参考上方使用说明进行配置和调用
result = "ready"
```bash
# 从博客目录自动检测 git 状态并推送
cd {博客路径}
# ...
# 添加新文章
# ...
# 提交（建议用"新增:"前缀）
git commit -m "新增：{文章标题}"
# ...
# 推送到远程
git push

配置自动读取

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

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

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

使用技巧

1. slug 使用英文：文件名使用小写英文，不要用中文
   ```bash
   # 正确
   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 博客发布指南"

5. 发布前预览：使用 hugo server -D 本地预览

6. 配置 SSH Key：确保 git push 不需要每次输入密码

疑问解答

Q1: 使用本技能需要什么前置条件?

A: 需要配置对应API Key并确保运行环境满足依赖说明中的要求。首次使用请参考快速开始章节。

Q2: 遇到API调用失败怎么办?

A: 检查API Key是否正确配置、网络连接是否正常。如遇429限流,等待2秒后重试,最多3次。

Q3: 支持哪些输入格式?

A: 支持文本输入和JSON格式参数。具体格式参考输入格式章节的参数说明表。

Q4: 如何处理超时或无响应?

A: 默认超时30秒。超时后检查网络连接和API服务状态,确认服务正常后重试。

Q5: 输出结果不完整怎么办?

A: 检查输入参数是否完整,确认prompt描述清晰具体。对于长文本输入,尝试分段处理。

安装与配置

运行环境

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

依赖详情

API Key 配置

• Hugo博客发布免费版为纯 Markdown 指令驱动，无需额外 API Key
• Git 推送需要配置 SSH Key 或个人访问令牌

可用性分类

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

异常修复

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

安全标准

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效能分析

特色分析

高频问答

Q1: Hugo博客发布免费版支持哪些输入格式？

A1: 将 Markdown 文章发布到 Hugo 博客，自动生成 Front Matter 并推送到远程仓库.。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

故障恢复

针对Hugo博客发布免费版使用中可能遇到的常见问题,提供以下排查方案:

异常恢复策略

针对Hugo博客发布免费版使用中可能遇到的常见问题,提供以下排查方案:

帮助文档

```