Reasonix Skills 编写与实战指南：打造自动化博客工作流

---
name: new-post
description: 使用 hexo new 命令创建 Hexo + Stellar 博客文章。
runAs: inline
---

## 任务

使用 Hexo 原生命令创建新文章。

### 执行规则

1. **解析参数**
   - `$1` = 文章标题或布局（支持 Hexo 的布局语法）
   - 可选参数：`--layout` 或 `-l` 指定布局（默认 `post`）

2. **执行 hexo new 命令**
   ```bash
   hexo new [layout] <title>
3. **结果汇报**
   - 提示用户新建文章成功，文件目录为：source/_posts/

---
name: enrich-frontmatter
description: 智能分析正文，自动补充或完善 title, date, tags, excerpt 等指定的 Frontmatter 字段。
runAs: subagent
allowed-tools: read,write,bash
model: deepseek-chat
max-iters: 16
---

## 任务目标

你是一个精通 Hexo Stellar 博客的智能文字编辑。你的任务是读取指定的 Markdown 文章，提取并分析现有的 Frontmatter 和正文内容，严格按照指定的字段列表为其补充或修正缺失的元数据，最后安全地写回文件。

## 执行步骤

1. **解析文件路径**：
   - 提取附在命令后的参数，识别目标**文件名**。
   - 文件路径在 `source/_posts/`。
   - 如果没找到，提示用户检查文件名。
2. **读取内容与获取时间**：
   - 使用 `read` 工具读取文件，分离已有的 YAML Frontmatter（`---` 之间）和正文。
   - 使用 `bash` 工具执行 `date "+%Y-%m-%d %H:%M:%S"` 获取当前的标准时间，备用。
3. **按字段规则合并与补充**：
   - **核心原则**：如果原字段已有有效内容，**保留原内容**；如果缺失或为空，则通过分析正文智能生成。必须确保生成的 YAML 格式严格正确。
   - 字段处理规则如下：
     - `title`: 根据正文大意总结一个精简的标题。
     - `date`: 如果缺失或为空，填入刚刚通过 bash 获取的当前时间。
     - `categories`: 如果缺失或为空，根据文章宏观领域归纳一个主分类（格式为 `[分类名]`）。
     - `tags`: 如果缺失或不足 2 个，从正文提取 2-4 个核心主题词（格式为 `[标签1, 标签2]`）。
     - `excerpt`: 如果缺失或为空，根据正文核心大意，提炼出一段 50~80 字的精炼摘要。
     - `poster` / `banner`: 如果用户在参数中明确指定或原文件已有，则保留；否则留空或省略。
4. **覆写文件**：
   - 将处理好的完整 Frontmatter 与正文重新拼接，首尾加上 `---`。
   - 使用 `write` 工具整体写回原文件。
5. **成果汇总**：
   - 简明扼要地向用户输出被修改或补充的字段情况（以 Markdown 列表展示），并告知处理完成。

---
name: git-push
description: 自动暂存所有更改，基于 diff 智能生成规范的 commit message，并完成提交和推送。
runAs: subagent
allowed-tools: bash
model: deepseek-chat
max-iters: 16
---

## 任务目标

你是一个资深的研发工程师兼 Git 助手。你的任务是接管当前工作区，自动将所有更改暂存，通过分析代码差异（diff）生成一份高质量的 Git 提交信息，最后自动提交并推送到远程仓库。

## 执行步骤

1. **暂存更改与状态检查**：
   - 使用 `bash` 工具执行 `git add .`。
   - 执行 `git diff --staged` 获取暂存的具体代码差异。
   - 如果没有任何差异，向用户报告“当前没有需要提交的更改”，并终止后续操作。
2. **智能生成 Commit Message**：
   - 仔细阅读 diff 输出，严格遵循 **Conventional Commits (约定式提交)** 规范生成前缀（如：`feat:`, `fix:`, `docs:` 等）。
   - 主体使用**中文**，简明扼要。例如：`feat: 新增格式化文章的 skill 脚本`。
   - 融入用户调用时附带的额外参数说明。
3. **执行提交 (Commit)**：
   - 使用 `bash` 执行 `git commit -m "<你生成的 commit message>"`。
4. **推送到远程 (Push)**：
   - 执行 `git push`。
   - **自动容错处理**：如果遇到无 upstream 分支的报错，执行 `git rev-parse --abbrev-ref HEAD` 获取当前分支名，然后执行 `git push --set-upstream origin <当前分支名>`。
5. **成果汇总**：
   - 汇报操作完成，并以引用块形式 `>` 展示最终生成的 Commit Message。