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	结构化打磨、读者测试