# Article Writer

> Use when 用户想写公众号、知乎技术文章、自媒体内容，或基于已有技术文档改写为可发布文章时。

- Skill: `fudesign2008/article-writer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fudesign2008/article-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fudesign2008/article-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fudesign2008 (https://skillmd.com/u/fudesign2008)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fudesign2008/article-writer

---


# 技术文章写作流程

## Overview

4 步流程：搜索资料 → 撰写文章 → 生成标题 → 排版优化。适用于公众号、知乎、掘金等平台。**REQUIRED：** 全文应用中文标点规范（见 Step 2 格式区）。

## When to Use

- 写公众号、知乎技术文章、自媒体内容
- 基于已有技术文档改写、发布
- 需要爆款标题、排版建议、多平台适配

**When NOT to use：** 纯学术论文（用 ml-paper-writing）、小说创作（用 writer-memory）、项目内文档（用 doc-coauthoring）

## 执行前准备

1. 读取项目上下文（CLAUDE.md、AGENTS.md 等，若存在）—— 写作风格、结尾语
2. 读取源材料（若指定）—— 已有文档、技术资料
3. 确认目标平台—— 公众号/知乎/掘金，字数略有差异

**关键动作**：必须先读取项目上下文，再读取源材料，最后确认目标平台。

---

## Step 1：搜索资料

主题需补充时用 WebSearch：并行多源、优先最新、深度总结。若用户已提供完整源材料，可跳过。

---

## Step 2：撰写文章

### 结构模板（按类型选）

| 类型     | 框架                         |
|----------|------------------------------|
| 技术科普 | 科普 → 案例 → 总结           |
| 原理剖析 | 表象 → 深入分析 → 结论       |
| 使用教程 | 效果展示 → 步骤教学 → 升华   |
| 工具测评 | 介绍 → 使用过程 → 评测结论   |

**通用结构**：效果展示 → 问题描述 → 步骤教学 → 升华总结

### 撰写要求

- 1000–1500 字；故事化开头或直击痛点；备选标题 2–3 个
- 原则：具体、易落地、可见效（可执行步骤、有对比有数据）

### 格式

**中文标点规范**（全文严格遵守）：

| 标点 | 使用 | 不使用 |
|------|------|--------|
| 逗号 | `，` | `,` |
| 句号 | `。` | `.` |
| 分号 | `；` | `;` |
| 冒号 | `：` | `:` |
| 问号 | `？` | `?` |
| 感叹号 | `！` | `!` |
| 括号 | `（）` | `()` |
| 书名号 | `《》` | - |

**例外（保持原文）**：技术术语（JavaScript、React 等）、代码/命令、URL/路径、版本号/数字。书名号内的英文标点可保留（如《JavaScript: The Good Parts》）。

代码块前后留白、语法高亮。

---

## Step 3：生成标题

生成 5 个标题，要素：痛点明确、数字吸引、结果导向、情绪调动、悬念设置。

| 要素     | 示例                     |
|----------|--------------------------|
| 痛点     | 「还在手动切换 Node？」  |
| 数字     | 「3 分钟」「5 个技巧」   |
| 结果     | 「效率暴涨 10 倍」       |

可选 Vibe Coding 格式：`《Vibe Coding 10X 提效：[成果]，[痛点]》`

---

## Step 4：排版优化

- 段落：每段 3–5 行，重要数据加粗，金句单独成段
- 配图：标题下封面、步骤后效果图、结尾 CTA
- 代码块：前后留白、语法高亮
- 确保段落长度在 3–5 行之间，便于移动端阅读

---

## Quick Reference

| 阶段 | 关键动作                         |
|------|----------------------------------|
| 准备 | 读项目上下文、源材料、确认平台   |
| 搜索 | 需补充时 WebSearch，有源材料可跳过 |
| 撰写 | 选结构模板、1000–1500 字、中文标点规范 |
| 标题 | 5 个、含痛点/数字/结果           |
| 排版 | 3–5 行/段、配图位、代码留白      |

---

## Common Mistakes

| 错误           | 修正                         |
|----------------|------------------------------|
| 跳过项目上下文 | 先读再写，保持风格一致       |
| 忽略中文标点规范 | 中文标点、术语规范必用 |
| 标题泛泛       | 必须含痛点或数字或结果       |
| 有源材料仍大搜 | 以源材料为主，仅补充验证     |

---

## 配合 Skill

| Skill            | 作用               |
|------------------|--------------------|
| wechatsync       | 多平台同步         |
| doc-coauthoring  | 结构化打磨、读者测试 |