blog-hexo 技能

使用此技能管理完整的 Hexo 博客工作流：

• 草稿模式：创建或更新 Markdown 文件，并在 front matter 中设置 published: false，使其保持为草稿状态。
• 发布模式：润色已有文章，确保符合 SEO 最佳实践，并执行 Hexo 命令完成部署。

前提要求

• 本地已安装 Node.js + npm/npx（Hexo CLI 依赖 Node 18+）。
• Hexo CLI 可用（支持 npx hexo ... 形式调用）。
• 可访问 Hexo 博客仓库的本地路径（若该路径未记录在记忆中，请向用户确认）。
• 已配置 Git 凭据或部署令牌，使 hexo deploy 能够推送到托管远程仓库（例如 GitHub Pages）。
• 具备对该仓库内 Markdown、配置及 public 目录的读写权限。
• （可选）如需本地预览，需支持运行 npx hexo clean && npx hexo generate。

草稿模式

当用户希望撰写一篇暂不发布的 Hexo 博客文章时，请使用此技能。

Front Matter 模板

所有新草稿均须以以下精确区块开头（按需更新字段值）：

---
title: ''
published: false
catalog: true
header-img: /img/article_header/article_header.png
date: YYYY-MM-DD HH:mm:ss
subtitle:
tags: []---

说明：

• 务必保留 published: false，以确保 hexo generate 忽略该草稿。
• 选择标签时，优先参考常用列表（AI、OpenClaw、Agent、Technical、Life），除非用户另有指定。
• 撰写草稿时需填写 title 和 date；时间采用用户所在时区（默认：America/Los_Angeles）。
• 所列标签仅为常见选项，可根据文章实际内容删减或补充。

草稿撰写流程

路径确认

• 创建文件前，请检查记忆/参考笔记中是否已记录博客路径。若未明确指定，请向用户确认应使用的本地路径。

1. 确认文章主题、目标关键词、目标受众与行文语气。
2. 在已确认的博客路径下创建 Markdown 文件（路径未知时请主动询问）。
3. 插入上方 front matter 模板，并根据需要填写 title/date/subtitle/tags 字段。
4. 撰写草稿正文（引言 → 主体部分含 H2/H3 标题 → 结论）。若用户提供 SEO 偏好，请一并遵循。
5. 除非用户明确要求发布，否则禁止执行 hexo deploy。若为本地预览而运行 hexo clean/generate，则 published: false 可确保草稿不会出现在生成的公开站点中。

• 准备发布时，请移除 published: false，并继续执行下方“发布模式”检查清单，完成 SEO 优化与部署。

注意事项

• 仅新增或编辑目标草稿文件，不得修改其他已有文章。
• 在每次更新中注明草稿是否已就绪待审阅，或仍需补充信息。
• 准备发布时，请移除 published: false 并遵循下方“发布模式”流程进行 SEO 优化与部署。

发布模式

开始编辑前，请确认仓库路径并确保您拥有修改权限。若路径未记录在记忆中，请直接向用户确认。

在移除 published: false 或执行 npx hexo deploy 前，必须明确获得用户确认——其同意该文章正式上线。若未获确认，请在完成草稿准备后即停止操作。

SEO 写作助手

您撰写的博客文章既要能在 Google 排名靠前，又要真正值得读者阅读——拒绝空洞堆砌关键词的 SEO。

动笔前需确认的信息

请从用户处获取以下信息：

1. 目标关键词 — 用户希望排名的核心词
2. 次要关键词 — 3–5 个相关词汇
3. 搜索意图 — 信息型、交易型、导航型，还是商业型？
4. 目标受众 — 谁在搜索该内容？
5. 目标字数 — 默认：1,500–2,000 字
6. 行文语气 — 专业、轻松、技术向等

SEO 写作框架

标题（H1）

• 须包含目标关键词，且尽量前置
• 长度控制在 60 字符以内（避免搜索结果中被截断）
• 需具备吸引力——它将在搜索结果页与另外 9 条结果同台竞技
• 推荐格式示例：“如何 [X]”、“[数字] 种 [X] 方法”、“[X]：完整指南”

Meta 描述

• 长度：150–160 字符
• 自然融入目标关键词
• 按广告文案风格撰写——这是您在搜索结果中的第一印象
• 需包含点击理由（CTA 元素）

URL Slug

• 简短、含关键词、全小写、单词间用短横线连接
• 示例：/how-to-write-cold-emails，而非 /how-to-write-the-best-cold-emails-that-get-replies-in-2024

内容结构

引言（100–150 字）

• 首句即吸引读者注意
• 明确说明读者将学到什么
• 目标关键词须出现在前 100 字内

正文 — 使用 H2 和 H3 标题组织

• 每个 H2 应围绕一个次要关键词或子主题展开
• H3 用于拆分长段落
• 每节内容建议不超过 300 字，之后应引入新标题
• 多用项目符号列表与编号列表（Google 与读者均偏好）

结论（100–150 字）

• 总结核心要点
• 包含明确的行动号召（CTA：读者下一步该做什么？）
• 不引入新信息

关键词布局规则

• 目标关键词须出现于：标题、首段、一个 H2、结论、meta 描述
• 关键词密度：上限为 1–2%；若读起来生硬，则已过度堆砌
• 使用变体：同义词、相关短语、自然语言表达形式
• LSI 关键词：全文穿插语义相关术语（Google 理解上下文）

站内链接与外部链接

• 站内链接：链接至本站 2–3 篇相关内容页
• 外部链接：链接至 2–3 个权威信源（增强 Google 对内容的信任度）
• 锚文本：描述性文字，禁用“点击此处”等无效表述

可读性

• 句子宜短；长短交替以形成节奏感
• 段落宜短（最多 2–3 句）
• Flesch 阅读易读性得分目标 ≥60（适合大多数成年人理解）
• 善用过渡词
• 通过标题、列表、图片（建议图位并提供 alt 文本）拆分文本

精选摘要（Featured Snippet）优化

针对“如何……”或“什么是……”类查询：

• 在对应 H2 后紧接简洁定义或分步说明
• 流程类内容使用编号列表
• 对比类内容使用表格
• 精选摘要目标答案控制在 50 字以内

Hexo 命令工作流

每当您在用户指定的博客仓库中修改或新建文章时，请先确认路径（不确定时主动询问），然后依次执行：

1. npx hexo clean
2. npx hexo generate
3. npx hexo deploy

上述命令将重建网站，并利用用户的 Git 凭据推送至已配置的远程仓库。

优化现有 Markdown

您不仅限于从零起草——若收到一篇全新文章且需保持未发布状态，请先使用 draft-hexo 技能创建含 published: false 的草稿，待准备就绪后再交由本技能进行润色与发布。 更多时候，您会收到一篇已存在的 Markdown 文章。此时请：

• 保留原有 front matter（title、tags、date 等字段）。
• 通读当前结构，再依据上方 SEO 框架重写各部分内容。
• 完成后重新运行 Hexo 工作流，确保线上博客与本地内容同步。

写作准则

• 首要服务人类读者，其次兼顾搜索引擎
• 严禁关键词堆砌。Google 比你想象中更聪明。
• 每一部分都须传递真实价值，杜绝为凑字数而添加的填充段落
• 对统计数据与主张须注明来源；如暂缺具体出处，可用 “[Source]” 占位
• 建议图片、信息图或嵌入内容的插入位置

致谢

• 本技能基于 ClawHub 原始 ai-seo-writer 技能开发。感谢原作者提供的 SEO 框架；Jessie 针对 Hexo 发布场景进行了定制化调整。