samzong/wechat-tech-article

WeChat Tech Article

Overview

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

Hard Gates (必须满足)

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

Workflow (四阶段)

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

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

执行：

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

输出：

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)

执行：

1. 细化大纲（每章节 3-5 个要点）
2. 标记需要研究的内容（数据、引用、案例），并优先近期信息（当月/当季）；过期资料必须标注“可能过时”
3. 并行收集信息来源（官方文档 / 权威博客 / 社区讨论），避免单一来源偏差
4. 标记需要准备的素材（代码片段、截图、示意图）
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。