article-writer

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

SKILL.md

GitHub

技术文章写作流程

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