fudesign2008 技术文章写作流程
Overview
4 步流程：搜索资料 → 撰写文章 → 生成标题 → 排版优化。适用于公众号、知乎、掘金等平台。REQUIRED： 全文应用中文标点规范（见 Step 2 格式区）。
When to Use
- 写公众号、知乎技术文章、自媒体内容
- 基于已有技术文档改写、发布
- 需要爆款标题、排版建议、多平台适配
When NOT to use： 纯学术论文（用 ml-paper-writing）、小说创作（用 writer-memory）、项目内文档（用 doc-coauthoring）
执行前准备
- 读取项目上下文（CLAUDE.md、AGENTS.md 等，若存在）—— 写作风格、结尾语
- 读取源材料（若指定）—— 已有文档、技术资料
- 确认目标平台—— 公众号/知乎/掘金，字数略有差异
关键动作：必须先读取项目上下文，再读取源材料，最后确认目标平台。
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 | 结构化打磨、读者测试 |