# Wechat Tech Article

> 撰写微信公众号技术文章的结构化工作流。使用场景：用户要写一篇公众号文章、需要创建文章目录、组织素材、迭代草稿。强制遵循 blogs/wechat/README.md 的命名规范和目录结构。

- Skill: `samzong/wechat-tech-article` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add samzong/wechat-tech-article`
- Raw SKILL.md: https://api.skillmd.com/api/skills/samzong/wechat-tech-article/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: samzong (https://skillmd.com/u/samzong)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/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  # 含基础骨架
```

**骨架模板**：
```markdown
# [标题：一句话说明价值]

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

# 前言

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

# [核心章节 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/`）
   - 否则：列出“需要的图清单”并说明每张图证明什么

**大纲格式**：
```markdown
# [章节标题]
- 要点 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`。