WeChat Tech Article

Overview

结构化地完成一篇微信公众号技术文章，从选题到定稿。遵循 blogs/wechat 的规范与既有文章风格。

Hard Gates (必须满足)

风格来源（强制）：写作前必须读取：
- blogs/wechat/README.md（目录/命名/发布节奏）
- skills/wechat-tech-article/references/style-guide.md（你的固定文风与结构套路）
目录命名：posts/YYYY/YYYY-MM-DD-<kebab-case-english-slug>/
文件命名：目录名与 .md 文件名完全一致
Slug 规则：只用英文（不用拼音）、用 - 分隔、尽量简短
引用路径：文章内引用本地文件使用相对路径 ./
结构硬门槛（强制）：
- 第一行必须是 # 标题
- 标题后 10-15 行内必须出现：入口链接（GitHub/下载/在线体验其一）+ 一句加粗 **tagline**
- 文章正文只用 # / ## 标题（禁止使用 ### 及更深层级）
可复现优先（强制）：至少 2 个可复制代码块（bash/yaml/toml/json 任选），并配解释

Workflow (四阶段)

阶段 1: 选题与定位 (Topic & Positioning)

输入：用户给出的主题/想法

执行：

问清楚：
- 这篇文章解决读者的什么问题？
- 目标读者是谁？（开发者、DevOps、技术管理者？）
- 你的独特视角是什么？（别人没写过的、你自己的经验）
根据主题生成 3 个候选 slug，让用户选择
选择文章模式（只影响内容组织，不影响你的“排版签名”）：
- 模式 A：开源项目/工具发布（公众号型：钩子强、入口早给、可复现步骤多）
- 模式 B：技术科普/架构深挖（技术博客型：层级清晰、定义问题、拆解机制）
创建文章目录和 .md 文件骨架
生成标题候选（见下方「标题工坊」），用户拍板后再进入大纲阶段

输出：

posts/YYYY/YYYY-MM-DD-<slug>/
└── YYYY-MM-DD-<slug>.md  # 含基础骨架

骨架模板：

# [标题：一句话说明价值]

> [副标题：情景化描述/问题引入]

# 前言

[为什么写这篇、谁应该读]

# [核心章节 1]

## [小节 1]

## [小节 2]

## [小节 N]

# [核心章节 2]

# [核心章节 N]

# 结语

[总结 + 行动建议]

---

标题工坊 (爆款但不虚)

目标：生成“像你写的”标题：强钩子、直击场景、可落地；避免夸大其词。

强制要求（标题 hard gate）：

不能承诺无法证明的收益（例如“效率暴涨 10 倍”除非你有基准/数据）
标题至少包含以下两项：对象/工具 + 场景/痛点 + 收益/结果 + 悬念（任取其二以上）

生成规则（按你常用钩子风格优先）：

反问/反差：例如“不会吧？你还在……？”
“我做了/我开源了……”：适合模式 A
迁移/替换：例如“这个开源插件帮助我从 A 迁移到 B”
顺手/工作流：例如“我把 X 做成了一个顺手的 CLI”

输出格式：

生成 8 个标题候选，按类型分组（痛点/数字/结果/悬念/清单/反常识任选）
每个标题附 1 行备注：适合读者 + 主打收益点
给出 Top 2 推荐 + 推荐理由（具体性/可信度/读者匹配）

阶段 2: 大纲与素材 (Outline & Research)

执行：

细化大纲（每章节 3-5 个要点）
标记需要研究的内容（数据、引用、案例），并优先近期信息（当月/当季）；过期资料必须标注“可能过时”
并行收集信息来源（官方文档 / 权威博客 / 社区讨论），避免单一来源偏差
标记需要准备的素材（代码片段、截图、示意图）
如果需要生成图片，按环境能力选择：
- 如支持生成图片工具：生成并保存到文章目录（同级或 assets/）
- 否则：列出“需要的图清单”并说明每张图证明什么

大纲格式：

# [章节标题]
- 要点 A
- 要点 B [需要数据支撑]
- 要点 C [需要代码示例]
- [可能需要示意图]

素材清单（同目录下创建）：

posts/YYYY/YYYY-MM-DD-<slug>/
├── YYYY-MM-DD-<slug>.md
├── outline.md           # 详细大纲
├── research.md          # 研究素材
└── assets/              # 图片等资源（可选；也可直接同级放置）

阶段 3: 逐节写作 (Section-by-Section Writing)

原则：

一次只写一个章节
写完一节后暂停，等待用户反馈
用户确认后再写下一节

写作检查点（每节完成后自问）：

是否有具体例子/代码/数据支撑？
是否避免了空洞的套话？
是否符合用户的写作风格？
引用本地资源是否使用了相对路径？

Hook 优化（开头段特别关注）：

用数据/故事/问题开头，不要用"今天我们来聊聊 X"
前三句决定读者是否继续

阶段 4: 定稿与发布准备 (Finalization)

检查清单：

标题：是否一眼明白价值？
副标题：是否引起好奇？
长度：公众号建议 2000-4000 字
配图：是否有封面图？
代码块：是否语法高亮正确？
链接：是否都可点击？
排版签名：短段落（3-4 行）、加粗关键词、代码块前后留白

发布建议（基于 README.md）：

时区：北京时间（CST / Asia/Shanghai）
公众号：周二 21:30；备选周三/周四 21:30；加餐（可选）周日 21:00（长文长尾）
朋友圈导流：推文发布后 10–20 分钟

输出：

✅ 文章定稿：posts/YYYY/YYYY-MM-DD-<slug>/YYYY-MM-DD-<slug>.md
📊 字数统计：[N] 字
📅 建议发布：[日期 时间]

禁止事项

禁止：一口气写完全文再给用户看
禁止：使用拼音做 slug
禁止：使用绝对路径引用本地文件
禁止：跳过大纲阶段直接写正文
禁止：使用"今天我们来聊聊"等套话开头
禁止：把图片当装饰（每张图出现前后必须解释它展示/证明什么）

风格指南

默认强制遵循：skills/wechat-tech-article/references/style-guide.md。

以下为“速记版”风格指纹（帮助快速自检，不取代原文）：

开门见山：前言直接说"我遇到了什么问题 → 如何解决"
结构清晰：多用小标题、列表、表格
代码配文字：代码块后必须有解释
观点鲜明：不怕说"这样不好"、"我认为"
结尾行动化：给读者 1-2-3 步可执行建议

模板与长文规范

如需可复制模板（模式 A/模式 B），优先参考：skills/wechat-tech-article/references/style-guide.md。

如需“快速开写”的精简可复制模板：skills/wechat-tech-article/references/templates.md。

如需“风格速查表”（默认强制风格的浓缩版）：skills/wechat-tech-article/references/style-cheatsheet.md。