技术博客写作助手是一款专为开发者设计的技术文章AI写作工具。支持实战教程、源码解析、踩坑记录、最佳实践、技术选型对比等多种文章类型。通过「确认主题→构建结构→撰写内容→适配平台」四步流程，输出完整可运行的技术文章。工具内置掘金、知乎、公众号、个人博客等多平台格式适配方案，并提供标题SEO优化建议。
技术博客写作助手：高质量技术文章从选题到发布的完整指南
【适用场景】
场景一：踩坑记录分享
解决了一个棘手的Bug，过程曲折但很有价值想记录下来。技术博客写作助手引导你按照「问题现象→排查过程→根因分析→解决方案→原理讲解」的结构，把踩坑经历转化为他人可借鉴的技术文章。场景二：技术教程撰写
学习了一项新技术（如 React Hooks、Redis 缓存、GraphQL），想把学到的知识整理成系列教程。工具按照「引子→背景知识→核心内容→实战代码→注意事项→总结」的递进结构，帮你组织内容，让读者从入门到掌握。场景三：源码分析分享
阅读了一个热门开源项目的源码，想把核心实现原理整理成文章。工具引导你从代码架构到核心逻辑，用类比和图示把复杂代码讲得通俗易懂，并提供完整的代码注释规范。场景四：技术选型对比
在几个技术方案之间犹豫（如 Vue3 vs React、MySQL vs PostgreSQL），想写一篇对比分析供团队决策参考。工具输出包含性能数据、优缺点对比表格、适用场景分析的完整选型报告。场景五：多平台技术内容分发
一篇技术文章想同时发到掘金、知乎、公众号等多个平台，但各平台风格和读者偏好不同。工具提供各平台的格式适配方案——掘金偏干货代码、知乎偏观点分析、公众号偏通俗易懂。【操作步骤】
Step 1：确认文章主题和定位
向AI助手说明你的写作需求，提供以下信息： - 主题：要写什么技术？解决什么问题？ - 读者群体：面向初学者、中级还是高级开发者？ - 文章类型：教程/原理/踩坑/最佳实践/源码分析/技术选型对比/年度总结？ - 发布平台：掘金/知乎/CSDN/个人博客/微信公众号？ - 篇幅：快速分享（1000字）还是深度长文（5000+字）？如果已经有明确的主题和核心要点，直接提供，AI会帮你扩展成完整文章。
Step 2：构建文章结构
AI根据你的主题和类型，自动构建文章框架。通用文章结构： ``` 1. 引子/Hook（为什么要读这篇文章） 2. 背景（问题场景/技术背景） 3. 核心内容（层层递进的讲解） 4. 实战代码（完整可运行的示例） 5. 踩坑点/注意事项 6. 总结与思考 7. 参考资料 ```
标题拟定原则： - 明确传达文章价值："手把手教你XX" / "深入理解XX" / "XX踩坑实录" - 包含关键技术词：方便搜索引擎收录 - 适度吸引力：让读者产生"我也遇到过这个问题"的共鸣
Step 3：撰写完整内容
AI按照结构逐步撰写：引子写作：从具体问题场景或痛点切入，让读者产生共鸣，简要预告文章会解决什么问题。
技术讲解技巧： - 使用类比帮助理解抽象概念（如"同步就像排队买奶茶，异步就像手机点单"） - 配合ASCII图示说明架构和流程 - 代码从最简版开始，逐步添加功能和优化 - 在关键代码处加注释说明
代码规范： - 所有代码必须完整、正确、可直接运行 - 标明语言类型和运行环境 - 关键逻辑加中文注释 - 提供完整的依赖和配置说明
Step 4：输出并适配平台格式
文章完成后，AI根据目标平台调整格式和风格：| 平台 | 风格 | 篇幅 | 特点 |
|---|---|---|---|
| 掘金 | 技术干货为主，代码量充足 | 3000-8000字 | 标签重要，利于搜索 |
| 知乎 | 观点鲜明，允许主观判断 | 2000-5000字 | 开头要抓人，评论区互动 |
| 公众号 | 通俗易懂，配图丰富 | 2000-4000字 | 无代码高亮，需截图 |
| 个人博客 | 最自由，可以最深入 | 不限 | SEO友好，可放完整项目 |
【代码模板】
模板一：标准技术文章格式
```markdown
[文章标题]
> [一句话摘要，说清楚这篇文章讲什么、能帮读者解决什么问题]
引子
[从一个具体场景切入，2-3段，让读者产生共鸣]
背景知识
[必要的前置知识，控制在最少够用]
核心内容
[子标题1]
[讲解 + 代码示例]
```[语言] // 注释说明 [代码] ```
[子标题2]
[讲解 + 代码示例]
实战演示
[完整的端到端示例代码]
踩坑点 & 注意事项
1. [坑1]：[描述和解决方案] 2. [坑2]：[描述和解决方案]
总结
[3-5句总结核心要点，加上作者自己的思考和判断]
参考资料
- [资料1] - [资料2] ```
模板二：踩坑记录格式
```markdown
[技术名] 踩坑实录：[问题描述]
问题现象
[截图/日志/报错信息]
排查过程
第一步：[排查方向1]
[过程和发现]第二步：[排查方向2]
[过程和发现]第三步：[找到根因]
[根因分析]解决方案
```[语言] [修复代码] ```
原理分析
[为什么会出这个问题？底层原因是什么？]
教训总结
1. [教训1] 2. [教训2] ```
模板三：性能对比表格
```markdown
性能/对比数据
| 方案 | 性能 | 优点 | 缺点 |
|---|---|---|---|
| [方案A] | [数据] | [优点] | [缺点] |
| [方案B] | [数据] | [优点] | [缺点] |
【复盘要点】
要点一：先讲Why再讲How
读者最关心的是"为什么要关注这个话题"，其次才是"怎么做"。好的技术文章开头用具体场景或痛点切入，让读者产生共鸣后再展开技术细节。空洞的"本文将介绍XX技术"开头往往留不住读者。要点二：代码必须可运行
技术文章里的代码示例不是"示意性代码"，而是必须能直接复制粘贴运行的完整代码。提供完整的依赖配置（package.json、requirements.txt等），注明运行环境版本。读者照着跑不通的代码是技术文章最大的失败。要点三：层层递进而非平铺直叙
好的技术文章像登山，从山脚（基础知识）到山顶（深层原理）有清晰的路标。每个章节应该是前一个章节的自然延伸，而不是割裂的知识点罗列。要点四：有作者观点才有灵魂
技术文章不是官方文档，好文章一定有作者自己的判断和思考。在总结部分写出你对技术的评价、适用场景的判断、可能的局限性，这样的文章才值得反复阅读。要点五：标题决定打开率，正文决定收藏率
技术文章标题要包含核心技术词（如"React Hooks"、"Redis缓存"、"GraphQL"），方便搜索引擎收录；同时传达读者收益（如"5分钟入门"、"彻底搞懂"、"避坑指南"）。正文结构清晰、代码完整、逻辑递进，才能让读者收藏。来源：GitHub https://github.com/kevinaimonster/skill-hub/blob/main/skills/tech-blog/SKILL.md