AI 写博客自动化：wp-aerocore-publish 技能介绍与使用指南

本文由博主在 Reasonix 中使用 wp-aerocore-publish 技能发布与编辑更新。

1. 简介

wp-aerocore-publish 是一套面向本站（WordPress + AeroCore 主题）的 AI 写作与发布技能。它将「文章撰写」与「内容发布」两个环节自动化：按主题规范生成正文，并通过 WordPress REST API 完成草稿创建、特色图片设置、分类选择与标签生成。

技能的核心能力如下：

• 自动写作：依据本站格式规范生成正文，原生支持 AeroCore 主题 10+ 种 shortcode（折叠面板、提示面板、下载面板、密码可见、视频插入等）
• 文章编辑：对已发布文章进行更新（修正内容、补充信息、替换附件链接、更新版本号等），通过 REST API 直接修改并保持发布状态
• 格式转换：将外部文章或文档转换为适配本站主题的统一格式
• 一键发布：通过 REST API 与应用密码，自动存草稿、设特色图片、选分类、打标签
• 安全配置：凭据独立文件存放，模板与真实配置分离，可安全分发

技能本体为标准 Markdown 文件（SKILL.md），符合通用 Skills 规范，可在支持该规范的多款 AI 工具间复用。

2. 使用场景

2.1 自主创作辅助

适用于博主已形成选题、但缺乏时间组织语言与排版的情形。博主只需提供主题与若干要点，技能即可补全论证、优化结构、润色语言，按本站格式生成草稿。

操作方式：提交选题与素材，如「主题：H68K 刷机心得；要点：所需工具、刷机步骤、常见问题」，AI 完善成文后由博主审阅发布。

2.2 文章转载与格式适配

适用于转载其他网站优质内容的情形。外部内容格式多样（Markdown、公众号、其他主题编辑器代码），直接复制会导致排版错乱、控件失效。技能可将原文转换为本站格式：以标准 HTML 为基础，折叠面板、提示框、下载按钮等控件统一替换为站内 shortcode 写法，与全站风格一致。

操作方式：提交原文内容或链接，AI 完成格式转换后由博主确认。

2.3 技术文档转化

适用于将部署过程、软件配置、运维记录等散落文档整理为博客文章的情形。此类文档常包含敏感信息（服务器 IP、账号、密码、API Token），技能先执行脱敏处理，再整理为「背景 → 步骤 → 验证 → 常见问题」的教程结构，按主题格式发布。

操作方式：提交原始文档（README、笔记、聊天记录等），AI 脱敏并整理后由博主核对发布。

2.4 编辑已有文章

适用于已发布文章需要修正、补充或更新内容的情形，例如发现错误、信息过期、下载链接更换、需要补充新章节。提供文章链接与修改要求，AI 读取原文、按格式规范修改，保存草稿或直接更新发布。
操作方式：提供文章链接与修改说明，例如「把本文中的技能包下载链接更新为新版本」「修正某节的错别字」「在结尾补充常见问题」。

3. 使用说明

3.1 在 WorkBuddy 中使用

WorkBuddy 通过界面直接安装本技能的 zip 包，无需手动放置目录。

3.1.1 安装步骤

1. 点击左侧面板的「专家·技能·连接器」；
2. 切换到「技能」选项卡；
3. 点击「添加技能」按钮，点击「上传技能」按钮，点击「选择 zip 文件」按钮，选择本技能的 zip 包（wp-aerocore-publish-skill-v1.0.3.zip）上传；
4. 安装完成后，技能出现在技能列表中，即可开始使用。

3.1.2 调用方式

支持以下三种方式：

1. 自然语言触发：直接在对话框输入意图，如「写一篇关于 OpenWrt 的文章发到博客」，WorkBuddy 自动匹配并调用本技能；
2. 斜杠命令：在对话框输入 /wp-aerocore-publish 直接唤起技能；
3. 技能列表选择：在技能列表中选中 wp-aerocore-publish，再在对话框说明写作需求。

3.1.3 凭据配置

将技能包内的 wp-credentials.example.json 复制为 wp-credentials.json，填写站点地址、WordPress 用户名与应用密码（应用密码在后台「用户 → 个人资料 → 应用程序密码」生成，格式 xxxx xxxx xxxx xxxx xxxx xxxx）。

3.2 在 Trae work 中使用

3.2.1 安装步骤

1. 点击 Trae work 左侧面板的「插件市场」；
2. 切换到「技能」选项卡；
3. 点击「上传技能」按钮，选择本技能的 zip 包（wp-aerocore-publish-skill-v1.0.3.zip）上传；
4. 安装完成后，技能出现在技能列表中，即可开始使用。

3.2.2 调用方式

支持以下三种方式（与 WorkBuddy 一致）：

1. 自然语言触发：直接在对话框输入意图，如「写一篇关于 OpenWrt 的文章发到博客」，Trae 自动匹配并调用本技能；
2. 斜杠命令：在对话框输入 /wp-aerocore-publish 直接唤起技能；
3. 技能列表选择：在技能列表中选中 wp-aerocore-publish，再在对话框说明写作需求。

调用后，AI 按技能规范生成正文（标准 HTML + AeroCore shortcode）、询问特色图片、自动选择分类与生成标签、创建草稿并发布。

3.2.3 凭据配置

1. 在技能目录中找到 wp-credentials.example.json，复制为 wp-credentials.json；
2. 填写站点地址、WordPress 用户名与应用密码（应用密码在后台「用户 → 个人资料 → 应用程序密码」生成，仅显示一次，格式 xxxx xxxx xxxx xxxx xxxx xxxx，连空格粘贴）；
3. 保存后，AI 发布时会自动读取该文件，无需重复提供。

3.3 在 Reasonix 中使用（源生环境，推荐）

按 Reasonix 官方 Skills 规范：技能即一个带 frontmatter（name / description）的 Markdown 文件，放入技能发现目录即被自动发现，正文按需加载。

3.3.1 安装（从 zip 包导入）

拿到技能 zip 包（如 wp-aerocore-publish-skill-v1.0.3.zip）后，按以下方式添加：

对话安装（推荐）

1. 在 Reasonix 对话框告诉 AI：「安装技能，zip 包位于 <本地路径或 URL>」；
2. AI 调用官方 install_source 能力：先输出安装计划（apply=false 预览风险），你确认后 apply=true 执行安装；
3. 安装完成，技能注册到技能目录并出现在技能索引中。

3.3.2 调用方式（官方三种）

1. 自然语言：直接说「写一篇关于 XX 的文章发到博客」，harness 按技能 description 自动匹配并调用本技能；
2. 斜杠命令：输入 /wp-aerocore-publish；
3. 显式工具调用：run_skill(name="wp-aerocore-publish", arguments="主题与内容要求")。

技能正文按需加载：仅在被调用时才读入上下文，不影响会话。

3.3.3 凭据

wp-credentials.json 与 SKILL.md 同目录（如 .agent/skills/wp-aerocore-publish/），harness 自动读取，无需每次提供。

3.4 在其他 AI 客户端（harness）中使用

Claude Code、Claude Desktop、Codex、Cursor 等原生识别以下任一目录下的 <技能名>/SKILL.md：

• .agent/skills/（推荐，多工具通用）、.reasonix/skills/、.agents/skills/、.claude/skills/（Claude 系）

手动放置步骤：

1. 将技能 zip 包解压，得到技能目录 wp-aerocore-publish/；
2. 复制技能目录到目标项目的技能发现目录：

   # 以通用约定目录 .agent 为例（亦可用 .claude / .reasonix / .agents 等）
   $src = "<解压路径>\wp-aerocore-publish"
   $dst = "<你的项目路径>\.agent\skills\wp-aerocore-publish"
   Copy-Item -Recurse $src $dst

3. 修改 SKILL.md 里的绝对路径（若有）为新环境路径；
4. 复制凭据：将 wp-credentials.example.json 复制为 wp-credentials.json 并填写（或改用环境变量方案，凭据不落地）。

布局要求：<技能名>/SKILL.md（或扁平 <技能名>.md）；frontmatter 必须包含 name 与 description，缺少 description 的技能不会正常进入索引。同名技能按优先级生效：项目 > 自定义 > 全局 > 内置（低优先级被 shadowed）。

识别与对话提示：各客户端对技能的自动发现机制不一，复制目录后可能需要通过对话让 harness 识别技能：

• 支持自动扫描技能目录的客户端（如 Claude Code 等）放置后即可识别；
• 其余客户端需在对话中说明技能位置并指示调用，例如：「技能位于 .agent/skills/wp-aerocore-publish/，请调用 wp-aerocore-publish 技能撰写并发布文章」。

4. 技能包下载

技能包 v1.0.3 提供下载（zip 压缩包，解压即可使用）：

wp-aerocore-publish v1.0.3 技能包

来源：默认下载

立即下载

5. 更新记录

• v1.0.3（2026-08-17）：明确发布执行方式（bash 内联 PowerShell、不落盘 .ps1）；发布命令补充 ConvertTo-Json 长正文序列化坑与可靠方案；警告标注为环境备注；技能目录路径统一为通用约定 .agent；使用说明新增 WorkBuddy / Trae work 客户端安装章节。
• v1.0.2（2026-08-16）：发布流程强制询问特色图片；特色图片四种来源；自动选择分类与生成标签；分类/标签/特色图片 REST API 用法；UTF-8 编码防乱码；example 配置模板与 .gitignore 防护。
• v1.0.1（2026-08-15，初始发布）：AeroCore 主题编辑器 shortcode 清单、写作规范（标准 HTML 打底 + shortcode 点缀）、REST API 发布草稿流程、凭据配置文件。

6. 结语

wp-aerocore-publish 技能旨在降低博客写作与发布的重复劳动，使「AI 撰写、AI 发布」成为可行方案。当前版本 v1.0.3，如有建议欢迎留言交流。