| name | apply-wechat-custom-theme |
| description | AI-ready skill to test, register, and publish Markdown articles to WeChat Official Accounts using a local custom CSS theme via Wenyan CLI. |
微信公众号自定义主题应用工具 (WeChat Custom Theme Applier)
这是一个专门为 AI Agent 设计的技能,用于将本地生成的自定义 CSS 主题应用到 Markdown 文章中。它支持通过 wenyan-cli 进行本地预览、主题注册以及一键推送到微信公众号草稿箱。
前置要求
- 环境配置:必须设置
WECHAT_APP_ID 和 WECHAT_APP_SECRET 环境变量。
- 依赖工具:已安装
wenyan-cli (pnpm add -g @wenyan-md/cli)。
- 必要文件:本地已存在 Markdown 文件 (
.md) 和 CSS 主题文件 (.css)。
核心能力
- 本地测试渲染:在发布前验证 CSS 样式的正确性。
- 一键发布草稿:直接应用本地 CSS 将文章推送到公众号草稿箱。
- 主题持久化:将优秀的自定义主题注册到
wenyan-cli 主题库中,方便后续调用。
AI Agent 指令指南:工作流 SOP
当用户要求“应用生成的 xxx.css 并发布 yyy.md”时,Agent 必须 遵循以下标准操作流程:
Step 1: 测试渲染 (Render Test) [强制]
在正式发布前,必须先进行模拟渲染,以确保 CSS 语法正确且文件路径有效。
Step 2: 正式发布 (Publish to Draft)
测试通过后,使用该 CSS 文件将文章推送到微信公众号草稿箱。
Step 3: 注册主题 (Register Theme) [按需]
如果用户表示需要长期使用该主题,应将其注册到本地主题库。
故障排除 (Agent 专用)
- 文件不存在:检查
ENOENT 报错,确认 Markdown 或 CSS 文件路径是否正确。
- 样式未生效:检查 CSS 选择器是否缺少
#wenyan 前缀。
- 凭证错误:如果微信 API 返回
invalid credential,提示用户检查 WECHAT_APP_ID 和 WECHAT_APP_SECRET 环境变量。