hexo-deploy

介绍

这是一个用于 Hexo 博客站点自动化部署的 Agent Skill,是 WaterCoFire 专为 WaterCoFire Playground 网站的开发工作流而设计的。它能将 Hexo 博客的完整发布流程压缩为一次对话指令,负责处理从内容生成到代码提交的全部部署工作。

如果你也在维护一个 Hexo 博客网站,欢迎直接取用!

工作流概览

该 Skill 将部署拆分为两个独立阶段,按顺序执行:

1
2
3
4
5
6
7
Phase 1 — Hexo 构建 & 发布
hexo clean → hexo g → hexo d
└─ 将 public/ 目录推送到 hosting 仓库(如 GitHub Pages)

Phase 2 — 源码提交
git add . → git commit → git push origin main
└─ 将源文件保存到源码仓库

任意步骤失败时,Agent 应会立即停止并报告错误,不会继续执行后续命令。

如何使用?

直接告诉您所用的 Agent 您要部署,并提供 commit 消息即可:

1
帮我部署,commit 消息是"新增关于页面"

如果您以中文提供了 commit 消息,Agent 应会自动将该消息润色为英文,然后依次执行所有命令。

也可以让 Agent 根据 diff 自动生成 commit 消息:

1
帮我部署,commit 消息你来生成

部分执行

指令 行为
只部署只 hexo
仅执行 Phase 1(Hexo 构建 & 发布),跳过 Phase 2
只提交只 git
仅执行 Phase 2(Git 提交),跳过 Phase 1

定制说明

该 Skill 的设计前提是:Hexo 博客的源码本身也维护在一个独立的 Git 仓库中(即与 hexo d 所推送的 hosting 仓库相分离)。这是 WaterCoFire Playground 的仓库结构。

如果你的情况与此不同,在使用前请按需调整:

只有一个 Git 仓库(源码即 hosting 仓库)

删除 Phase 2 的 Git 阶段,或将其合并进 hexo d 的逻辑中。

不需要 hexo clean

从 Phase 1 中移除该命令。

主分支不是 main

git push origin main 中的 main 替换为你的分支名。

适用前提

  • 已安装并配置好 Hexo CLI(hexo 命令可用)
  • hexo d 的部署目标已在 _config.yml 中正确配置
  • Git 已初始化,远程仓库 origin 已设置

文件内容

元数据

1
2
3
4
---
name: hexo-deploy
description: "Deploy this website and commit source files to Git. This skill handles the full two-step workflow: build & deploy public/ via hexo, then commit source files to the source repository."
---

完整文件

请点击下方按钮下载。

📥 Download