用 AI 写技术博客和长文
更新 2026-10-11 25 分钟(含改写) 难度 ★☆☆☆☆作者 Skills 编辑部
相关搜索
这篇用到的 skill(3)
主力。长文写作流程,结构到成稿。
npx skills add affaan-m/ECC -g编写技能,提升表达清晰度。
npx skills add obra/superpowers -g内容引擎,统一选题与产出节奏。
npx skills add affaan-m/ECC -g
技术博客最怕"抄文档"或"水字数"。让 AI 写的核心是:先给它你的实操经验/坑(这才是独特价值),让它负责结构、例子和润色,而不是替你编没做过的事。
这篇适合谁 / 不适合谁
适合:
- 有实战经验想沉淀成文章
- 卡在"开头写不下去"或"结构乱"
- 要稳定产出、统一文风
不适合:
- 完全没做过却要 AI 编干货(那是虚构)
- 要求一字不改直接发(你才是作者)
- 只要标题党不带货(内容价值优先)
开始前准备什么
- 素材:你做过的项目、踩过的坑、代码片段。
- 读者:初学者 / 同行,决定深浅。
- 平台:博客 / 公众号 / 知乎,决定篇幅与语气。
操作步骤
1. 装 skill
article-writing 是长文写作技能包,复制目录到客户端技能目录(与一般 Agent Skill 装法一致):
| 客户端 | 目录 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ |
| Cursor | ~/.cursor/skills/ |
| Trae | ~/.trae/skills/ |
| CodeBuddy | ~/.codebuddy/skills/ |
| 通义灵码 | ~/.lingma/skills/ |
2. 给素材,定结构
text
我要写一篇"用 Redis 扛住秒杀"的技术文,读者是初级后端。
素材:我们双十一用 Redis + Lua 扣库存,踩过超卖的坑(见代码)。
先给大纲(痛点引入→方案→踩坑→复盘),每节给 1 个可跑的代码片段,
别抄官方文档,写我们真实怎么做的。3. 用 writing-skills 提清晰度
成稿后用 writing-skills 过一遍,删冗余、补过渡、强化结论句。
4. 你定稿
AI 出的稿你补上真实数据/截图,删掉编出来的部分,定标题与开头钩子。
会踩的坑
| 坑 | 现象 | 怎么绕 |
|---|---|---|
| 抄文档 | 没独特价值 | 喂你的真实坑和经验 |
| 水字数 | 看完没收获 | 每节一个可跑例子 |
| 结构乱 | 读不懂 | 先大纲再写 |
| 编造 | 写了没做的 | 素材外标 [待核实] |
| 没钩子 | 开头就划走 | 开头抛反直觉/痛点 |
FAQ
没素材能写吗?
难。最好有你做过的项目/坑;纯靠 AI 易编。
结构怎么定?
痛点引入→方案→踩坑→复盘,是技术文稳妥骨架。
文风能统一吗?
能,给 1 篇范例让 AI 对齐语气与节奏。
要不要附代码?
要,可跑的代码片段比描述更有说服力。
标题怎么起?
从读者痛点反推,具体比抽象点击率高。
相关指南
顺着这些场景接着看:
相关源码
- affaan-m/ECC · article-writing 源码
- obra/superpowers · writing-skills 源码
- affaan-m/ECC · content-engine 源码
- Agent Skill 开放格式规范
一句话结论
结论:技术博客喂真实经验/坑让 AI 管结构润色,别让它编没做过的事,你才是作者。