wechat-content-optimizer
About wechat-content-optimizer
A skill that revises local Markdown files for reading on WeChat Official Accounts, aimed at content creators. It adjusts structure, wording, headings, and formatting, then saves the result as a new file.
Key features
- 01Read local Markdown files
- 02Improve openings and paragraph order
- 03Revise wording and headings
- 04Format for mobile reading
- 05Save the result as a new file
Use cases
- 01Restructure an account article
- 02Make formal writing more conversational
- 03Improve an article's opening
- 04Arrange paragraphs for mobile reading
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ steelan9199/ wechat-publisher --skill wechat-content-optimizerAfter installing, type/wechat-content-optimizerin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
config.jsonreferences/optimization-guide.mdscripts/optimize.jsDetails
From the project README公众号内容优化专家
优化本地 Markdown 文件,让文章更适合微信公众号阅读。
工作流程
1. 接收用户请求
用户提供:
- Markdown 文件路径(必需)
- 特定优化需求(可选)
2. 读取并分析文件
执行脚本读取文件内容:
node "<skill目录>/scripts/optimize.js" <markdown文件路径> --config "<skill目录>/config.json"
脚本会输出文件内容,供你分析和优化。
3. 多维度内容优化
基于 references/optimization-guide.md 中的优化指南,从以下维度优化:
| 维度 | 优化要点 |
|---|---|
| 开头吸引力 | 前3秒抓住读者,用痛点/悬念/数据/场景切入 |
| 段落顺序 | 调整段落位置,重要内容前置,逻辑更顺畅 |
| 段落节奏 | 短段落(手机不超过4行)、多留白、易扫读 |
| 语言表达 | 口语化、亲切、用"你"称呼、具象化抽象概念 |
| 小标题 | 用问句/数字/对比/利益驱动,引导阅读 |
| 结尾转化 | 总结/互动/行动/福利/金句,给读者行动理由 |
| 排版格式 | 重点加粗、适当引用、列表呈现、层次分明 |
3.1 Markdown语法优化
- 尽量使用标准的Markdown语法。
- 我写的Markdown渲染器支持Obsidian的大部分Markdown语法, 如
**加粗**、*斜体*、==高亮==等。因为我写文章就是使用的Obsidian的Markdown语法。 - Obsidian 是一款 基于本地文件 的笔记软件,所有数据以纯文本 .md(Markdown)文件形式存储在我的电脑上。
4. 保存优化后的文件
将优化后的内容写入新文件:
- 必须保存为新文件:
<原文件名>.optimized.md
5. 汇报优化结果
向用户说明:
- 优化后的文件路径
- 主要优化了哪些方面
- 优化的原因和预期效果
优化原则
目标受众
- 年龄: 16-50岁中国用户
- 设备: 手机阅读为主
- 场景: 碎片化时间
- 注意力: 极短,前3秒决定是否继续
语言风格
- 亲切、易懂、有网感但不失专业
- 像跟朋友聊天一样写作
- 多用"你",少用"用户""读者"
- 长句拆短句,每句不超过25字
- 故事感:用具体事例代替空洞理论
- 有态度:表达观点,不做和稀泥
- 简化复杂:善用类比让难懂的东西变简单
写作要点
1. 用故事代替说教
❌ "风险管理很重要,应该制定应急预案"
✅ "去年我创业的团队就是因为没有备选方案,一个核心员工离职就差点垮掉。从那以后,我学会了给每个岗位预留 backup。"
2. 善用类比
❌ "分布式系统很复杂"
✅ "分布式系统就像一家连锁餐厅,每个分店要相互协作又要独立运营,稍微一个环节没协调好,整个体验就崩了。"
3. 直接说观点
❌ "有人认为...也有人认为...各有各的道理"
✅ "老实说,我觉得 XX 这个做法是错的,原因是..."
排版规范
- 每段3-4行(手机屏幕)
- 段落间空一行
- 小标题必须加,引导阅读节奏
- 重点内容加粗突出
详细优化指南
参考文件:references/optimization-guide.md
需要时阅读该文件获取:
- 各维度详细优化技巧
- 常见内容类型优化要点
- 优化前后对比示例
- 进阶写作框架(SCQA、AIDA)
配置说明
配置文件:config.json
{
"options": {
"optimizeStructure": true, // 优化文章结构
"optimizeLanguage": true, // 优化语言表达
"optimizeFormatting": true, // 优化排版格式
"addEmojis": false, // 是否添加 emoji
"optimizeHeadings": true, // 优化小标题
"optimizeOrder": true // 优化段落顺序
},
"audience": {
"ageRange": "16-50岁",
"style": "亲切、易懂、有网感但不失专业",
"readingDevice": "mobile"
},
"output": {
"backup": true, // 是否备份原文件
"overwrite": false, // 是否覆盖原文件
"suffix": ".optimized" // 新文件后缀
}
}
使用示例
示例1:基本优化
用户:帮我优化这篇文章 F:/docs/article.md
执行:
- 运行脚本读取文件
- 分析内容结构
- 按6个维度优化
- 保存为 article.optimized.md
- 汇报优化要点
示例2:特定需求优化
用户:这篇文章开头太枯燥了,帮我改得吸引人一点,文件是 F:/blog/post.md
执行:
- 重点优化开头部分
- 保持其他内容不变
- 提供2-3个开头版本供选择
示例3:口语化改造
用户:这篇文章读起来太正式了,帮我改得口语化一些,像聊天一样
执行:
- 识别正式/生硬表达
- 替换为口语化表达
- 增加语气词和过渡句
- 调整句子长度
注意事项
- 保留原文核心信息:优化表达,不篡改原意
- 尊重用户风格:根据用户要求调整优化程度
- 技术内容准确:专业术语优化后确保准确性
- 代码块保留:技术文章中的代码保持原样
- 链接图片保留:不修改原文的链接和图片引用
优化效果预期
优化后的文章应该:
- 开头3秒抓住读者注意力
- 段落短小,手机阅读无压力
- 语言亲切,像朋友推荐
- 结构清晰,小标题引导阅读
- 结尾有明确的行动引导