WordPress 文档发布
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @yahuixun/publish-wp-document。
技能介绍
要解决什么问题
把本地写好的文档同步到 WordPress,如果每次都手工登录后台粘贴 HTML,标题、修订版本和发布状态很难和仓库或流水线对齐。更麻烦的是,站点接收端和翻译 relay 往往持有敏感凭证,智能体或本地脚本不应碰 Receiver Token 或翻译服务商密钥。
技能如何工作
技能依赖捆绑的 CLI,把提交、内容哈希、鉴权与状态轮询固定在同一套流程里,行为可重复、可脚本化。
- 配置:通过环境变量声明远程接收端等必要参数;技能明确要求不要向用户索要或本地保存 WordPress Receiver Token 与翻译提供商凭证,这些由 Remote Receiver 与 relay 侧持有。
- 提交:运行 CLI 上传文档。默认创建 草稿,除非用户明确要求直接发布。标题从 Markdown 首个
#标题推断,否则用文件名;source key默认由文档绝对路径生成(可用--source-key覆盖);revision hash 由正文内容计算。 - 查状态:轮询任务直至结束,汇报最终文章状态与 URL;失败时只报告 relay 返回的错误信息,不泄露 token。
支持的输入格式:
.md/.markdown:将保守子集的 Markdown 转为 HTML.txt:段落转义为 HTML.html/.htm:原样提交
适用边界
- 不要宣称支持 DOCX;仅在环境中具备合适文档转换能力时,才先把 DOCX 转成上述格式再提交。
- 默认草稿是刻意设计:避免智能体误发未审校内容;需要上线时请显式说明要直接发布。
使用场景
- 技术博客仓库里每篇 `.md` 定稿后,用 CLI 按内容哈希提交到 WordPress 草稿,再轮询拿到预览 URL
- 多语言站点由 relay 翻译后,把本地 `.html` 原样上传并查任务状态,确认是否仍为草稿
- 流水线从绝对路径生成稳定 `source-key`,同一文件重复提交时依赖 revision hash 区分版本
- 智能体写完 `.txt` 说明文,需转成段落 HTML 提交且默认不进正式发布,除非用户明确要求上线
适合人员
- 维护公司 WordPress 官网、希望从 Git 或本地文件批量同步文章且不碰 Receiver Token 的内容运营
- 在 Agent 工作流里把 SKILL 产出的 Markdown 推到远程接收端、需要可脚本化提交与状态回报的技术写作者
- 负责多语言发布链路、文档在 relay 侧处理、本地只负责上传 HTML/Markdown 的站点集成工程师
- 用自动化替代后台粘贴 HTML、又要求默认草稿以防误发的博客或文档维护者