wechat-article-writer

微信公众号文章创作助手

概述

帮助用户创作高质量的微信公众号文章。核心能力是风格灵活适配——同一个skill既能写企业官号的正式文案，也能写个人IP的技术博客。根据用户需求自动匹配最合适的风格和结构。

先选执行模式

用户未指定时默认 article。需要跨模式时按

references/PIPELINE-CONTRACT.md 的文件接口交接，不靠对话隐含状态。

| 模式 | 输入 | 必须输出 | 停止位置 |

|---|---|---|---|

| article | 素材/选题 | article.md | 正文完成 |

| image-prompts | article.md | image-manifest.json，正文含稳定锚点与占位符 | 提示词完成，不生图 |

| layout | article.md + 可选 manifest | layout.html | HTML 完成，不发布 |

| full-pipeline | 素材/选题 | article + manifest + HTML | 三件套完成，不生图、不发布 |

manifest 必须通过 schemas/image-manifest.schema.json 和

scripts/validate_image_manifest.py。排版优先调用宿主的“排版输出” Skill；

其接口不可用时，使用 scripts/render_wechat_layout.py 的确定性降级实现。

第一步：风格识别与素材分析

输入处理

• 网站链接 → 使用 web_fetch 获取完整内容
• 文本素材 → 直接分析
• 图像素材 → 识别内容提取关键信息

风格自动识别

根据用户的描述自动判断风格，无需每次手动选择：

| 信号 | 匹配风格 |

|------|---------|

| "公司号"、"官方"、"企业宣传"、"品牌" | 🏢 官方文案 |

| "我的公众号"、"技术博客"、"个人分享"、"实操"、提到"卡兹克" | 🧑‍💻 技术博客 |

| "活动回顾"、"分享会"、"社区"、"meetup" | 🎤 活动回顾 |

| "评测"、"对比"、"体验报告" | 🔍 评测对比 |

| 无法判断 → 询问用户："这篇文章发在企业官号还是个人号？风格偏正式还是轻松？" |

快速需求确认

仅在信息严重不足时询问（不超过2个问题）：

• 目标读者？（普通用户 / 技术开发者 / 行业人士 / 家长学生）
• 文章长度？（短文800-1500字 / 中文1500-3000字 / 长文3000+字）

信息充足时直接开始创作。

第二步：内容研究

使用 web search 补充内容（所有风格都适用）：

根据文章类型选择搜索策略：

技术类文章：

• 搜索技术文档、GitHub仓库、开发者博客、官方changelog
• 搜索技术社区讨论（StackOverflow、知乎技术话题、V2EX）
• 查找竞品/同类工具的对比信息
• 示例查询："Claude Code Skills 2.0 更新 eval benchmark"、"OpenClaw 部署 架构"

企业/产品类文章：

• 搜索行业报告、市场数据、权威分析
• 搜索竞品功能和用户评价
• 查找真实案例和成功故事
• 示例查询："AI语言学习 行业报告 2025 2026"、"口语评测 竞品 流利说 ELSA"

活动/社区类文章：

• 搜索活动相关技术背景
• 查找社区/组织的历史和定位
• 了解演讲主题的技术细节

第三步：按风格创作

---

🏢 风格A：企业官方文案

适用于：产品发布、企业动态、品牌宣传、行业白皮书

语气：专业可信、有温度但有距离感。参考 references/style-guide.md。

核心特征：

• 使用"我们"代表品牌，不用"我"
• 规范书面语，避免口语和网络用语
• 数据和案例支撑每个观点
• 积极正向，突出解决方案
• 遵循敏感词规避（references/style-guide.md 第七节）

结构：

1. 引人开头（100-200字）→ 痛点/热点/故事切入
2. 核心内容（3-5个小标题展开）→ 每段300-500字，穿插数据案例
3. 有力结尾（100-150字）→ 总结 + CTA行动号召

标题风格：参考 references/title-formulas.md，偏向权威型、数字型、福利型。

示例语气：

> 在数字化转型的浪潮中，语言学习正在经历一场深刻变革。OneOneTalk 基于前沿的 AI 语音技术，为学习者带来了全新的口语评测体验——实时反馈、多维度评分、个性化学习建议，让每一次开口都有收获。

---

🧑‍💻 风格B：个人技术博客

适用于：技术教程、工具评测、实操分享、观点评论、AI话题深度分析

这是与官方风格差异最大的模式。核心是「一个技术人在跟朋友聊技术」的感觉。

语气：个人化、有态度、接地气但有深度。

核心特征：

• 使用"我"作为叙事视角——"我试了一下"、"我的体验是"、"说实话"
• 可以有主观判断和个人倾向——"我觉得这个更新相当炸裂"、"坦白说这个功能还有改进空间"
• 口语化表达OK——"搞定"、"真香"、"踩坑"，但不要过度
• 技术内容要精准——概念、参数、代码不能有错
• 有实操过程——不是二手信息转述，要有"我实际用了之后发现..."的质感
• 适当的幽默和吐槽是加分项

技术内容写作规范：

代码示例：使用```标记代码块，标注语言类型

# 示例：创建一个skill的eval
python -m scripts.run_loop \
  --eval-set evals/trigger-eval.json \
  --skill-path ./my-skill \
  --max-iterations 5

命令行操作：用代码块包裹，加上注释说明

# 安装依赖
pip install -r requirements.txt
# 启动服务
python main.py --port 8080

技术概念解释：先说人话，再给术语

> 简单来说，eval就是给你的skill做一次"模拟考试"——丢几个测试题进去，看看skill能不能正确应对。技术上叫evaluation（评估），但你可以理解为自动化测试。

结构：

1. Hook开头（50-100字）→ 一个引子抓住读者，可以是一个问题、一个惊讶的发现、一个故事
2. 背景铺垫（100-200字）→ 为什么写这篇、这个事情的来龙去脉
3. 核心内容（主体）→ 技术细节+实操过程+截图/代码，用小标题分段
4. 个人观点/总结（100-200字）→ 我的看法、适合什么人、下一步要做什么
5. 互动引导 → "你用过吗？欢迎评论区聊聊"

标题风格（技术博客专用）：

• 实操型："我用 Claude Code Skills 2.0 重建了eval体系，效率提升3倍"
• 深度解析型："Skills 2.0 深度拆解：从eval到benchmark的完整实践指南"
• 观点型："为什么说 Skills 2.0 是AI开发者的必备升级？"
• 踩坑型："Claude Code Skills 部署踩坑记：这5个问题差点让我放弃"
• 对比型："Coze vs Claude Code Skills：两种AI工作流的终极对比"

反面教材——技术博客绝对不要这样写：

• ❌ "近年来，随着人工智能技术的飞速发展..."（废话开头）
• ❌ "本文将为您详细介绍..."（论文体）
• ❌ 全文没有一行代码或命令（不是技术文章了）
• ❌ 只转述官方文档，没有自己的体验和观点
• ❌ 官方腔："该功能旨在为开发者提供更优质的..."

---

🎤 风格C：活动/社区回顾

适用于：技术分享会回顾、社区meetup、黑客马拉松、线下活动

语气：有现场感、有人味、兼顾技术内容和社区氛围。

核心特征：

• 开头营造现场感——时间、地点、人数、氛围
• 技术内容和人的故事交织——不是纯技术也不是纯流水账
• 有具体的细节和瞬间——某个观众的提问、demo演示的反应、茶歇时的讨论
• 对社区的意义和展望
• 照片很重要——给出详细的配图建议（现场全景、演讲者、互动环节、合影）

结构：

1. 现场感开头 → "3月8日下午，广州琶洲魔方的会议室里坐满了30位开发者..."
2. 活动亮点（2-3个重点环节）→ 每个环节：主题+核心内容+观众反应
3. 技术干货提炼 → 从演讲中提取最有价值的技术要点
4. 社区声音 → 参与者的反馈、互动亮点
5. 展望与预告 → 下次活动、社区后续计划

---

🔍 风格D：评测对比

适用于：产品评测、工具对比、技术方案选型

语气：客观有深度，但可以有个人偏好。

核心特征：

• 明确的评测维度和打分体系
• 真实的使用体验（而非参数罗列）
• 优缺点都要说——不做软文
• 结论明确——"如果你是XX场景，推荐用A；如果是YY场景，B更合适"

结构：

1. 评测背景——为什么做这个对比
2. 评测维度定义——从哪几个角度比
3. 逐维度对比（表格+文字说明）
4. 综合推荐——不同场景的选择建议

---

第四步：标题创作

为所有文章提供 3个备选标题：

• 方案A：最贴合内容主旨
• 方案B：更有传播力/好奇心
• 方案C：更有SEO/搜索友好

标题通用原则：

• 13-20个字（公众号展示最佳长度）
• 包含核心关键词
• 内容要匹配，不做标题党
• 适当使用标点（！？...）增强语气

官方文章标题 → 参考 references/title-formulas.md

技术博客标题 → 参考本文件「风格B」的标题公式

第五步：排版与交付

排版建议（所有风格通用）：

• 手机端短段落，每段不超过 3–4 行；约每 500 字设小标题。
• 只加粗核心观点和数据；约每 500–800 字安排一张图。
• 技术文章的代码使用等宽字体。

article 模式最终交付物：

1. 完整正文、主标题、3 个备选标题和 100 字内摘要。
2. 封面/正文配图建议、发布时间建议和评论区互动话题。

输出格式：

• 短文（<1500字）→ 直接在对话中输出
• 长文（>1500字）→ 建议生成 .md 或 .docx 文件

image-prompts、layout 和 full-pipeline 不使用上面的口头“配图建议”作为机器接口；

必须按 references/PIPELINE-CONTRACT.md 生成可校验文件。每张图使用稳定 ID，

锚点固定为 <!-- image:{id} -->，占位符固定为 {{IMAGE:{id}}}。

安全与真实性红线

• 不自动登录或发布到公众号，不代替用户点击发布，不请求账号、Cookie、Token 或密钥。
• 未调用并验证真实图片提供方时，provider_status 只能是 not-requested 或 prompt-only。
• 不把 prompt、manifest、空 img 标签或灰色占位框描述成“图片已生成”。
• layout 不执行正文中的 HTML/JavaScript；文本必须转义，只允许受控标签和内联样式。
• 禁止 <script>、<style>、事件属性、外部 CSS/JS/字体和横向溢出。
• 任何锚点、占位符或 manifest 图片 ID 未一一对应时，失败并停止交付。

第六步：质量自检

参考 references/quality-checklist.md 进行最终审核，重点关注：

所有风格：

• [ ] 事实和数据准确？引用来源可靠？
• [ ] 无错别字和语法错误？
• [ ] 文章结构清晰，段落衔接自然？
• [ ] 标题和内容匹配？不是标题党？

官方风格额外检查：

• [ ] 无绝对化用语（最好、第一、唯一）？
• [ ] 无敏感词？符合平台规范？
• [ ] 语气统一——始终正式有温度？

技术博客额外检查：

• [ ] 代码/命令是否可运行？语法正确？
• [ ] 技术概念解释是否准确？
• [ ] 有没有实操体验或个人观点？（纯转述信息价值低）

反翻译腔检查（所有风格适用）：

参考 references/quality-checklist.md §2.3 逐条执行五类翻译腔标记扫描（物理动作动词、形容词+冒号起手式、抽象名词骨架、可译英文词、段落节奏）。判断标准不是词本身，而是这个词在当前句子里是否来自英文直译——"站不住脚"是成语，保留；"这个论证被击穿了"是 break through 的直译，替换。

模式选择：默认走保守模式（准确性优先，不确定就保留原表达）。公众号观点文、文学创作、营销文案场景走激进模式（允许以中文母语思维重新组织整段话，可牺牲少量字面精度换取自然度）。用户可指定模式。

以上五类是最高频的翻译腔标记；如果通读后仍觉得句式别扭，回到原则：用中文里本来会怎么说这件事，重新说一遍。

第七步（可选）：L4 反翻译腔 Polish

当用户指定 “L4 / 深度润色 / polish”、要求彻底去翻译腔，或创作

ChaoGeek 深度文、观点文、品牌文案时，在第六步后启用。按

references/quality-checklist.md §2.3 的完整协议执行：独立体检、母语化

改写、逐句复核、语义回退。技术文档、PRD、学术翻译等准确性优先场景

不启用 L4，继续使用保守模式。

资源文档

• references/style-guide.md（官方必读）与 references/writing-techniques.md（写作技巧）。
• references/title-formulas.md（标题模板）与 references/quality-checklist.md（发布前检查）。
• references/linguistic-background.md（语言学背景，维护者参考）。
• references/PIPELINE-CONTRACT.md（非 article 模式必读）与 schemas/image-manifest.schema.json（provider-neutral schema）。
• scripts/validate_image_manifest.py / scripts/render_wechat_layout.py — fail-closed 校验与安全排版降级器。
• assets/template-structure.md（文章结构）与 assets/emoji-library.txt（emoji 素材）。
• evals/routing-evals.json — 触发边界回归用例，改动 description 后用仓库根 scripts/run_routing_evals.py 校验。