blog generation 博客生成skill,去除AI味，更有可读性~

---

name: blog-writer-cn version: 3.0.0 description: 中文技术博客写作助手。基于 blog-writer 方法论，产出高质量、有个人风格的技术文章。不需要外部依赖，专注于内容创作。

---

Blog Writer CN

中文技术博客写作助手，帮你写出像跟朋友聊天一样自然、有观点、有态度的技术文章。

核心理念：

拒绝 AI 味，写出真人感

有观点、有态度、有真实经历

口语化表达，短段落，多小标题

---

🎯 使用场景

当你需要写以下类型的文章时，使用本技能：

技术教程："如何搭建 XXX 环境"

踩坑记录："XXX 让我折腾了 3 小时的坑"

观点输出："为什么我放弃了 XXX"

技术分析："对比 A 和 B，我选哪个？"

新闻资讯：行业动态、技术趋势盘点

---

✍️ 写作工作流

1. 用户提出写作需求
2. 【信息收集】确认主题、角度、素材、长度
3. 【风格校准】阅读 style-guide-cn.md
4. 【参考示例】查看 examples/ 中的示例文章
5. 【撰写初稿】按照风格指南产出内容
6. 【用户确认】展示初稿，收集反馈
7. 【迭代修改】根据反馈调整（可多次）
8. 【保存终稿】确认满意后保存为文件

---

📋 写作流程详解

Step 1: 信息收集

开始写作前，向用户确认以下信息：

| 维度 | 问题 | 示例 | |------|------|------| | 主题 | 写什么？ | "Agent 的记忆机制" | | 角度 | 从什么视角切入？ | 教程 / 踩坑记录 / 观点输出 / 对比分析 | | 素材 | 有没有参考资料？ | 链接、笔记、代码片段、个人经历 | | 长度 | 需要多长？ | 简短(500-800) / 标准(800-1500) / 深度(1500-3000) | | 目标读者 | 写给谁看？ | 初学者 / 有基础者 / 技术专家 |

收集技巧：

如果用户只说"帮我写篇文章"，先问主题

如果用户给了主题，追问角度（想写成教程还是观点文？）

如果用户给了链接，先阅读再开始写

---

Step 2: 风格校准

必须阅读 style-guide-cn.md，确保理解以下核心原则：

#### 🚫 不要 AI 味

AI 生成的文章有明显特征：

过度使用连接词（首先、其次、最后）

每段都有总结

语言过于正式和书面化

缺乏个人观点和情绪

我们要的：像跟朋友聊天一样写技术文章。

#### 💡 有观点、有态度

不要写"客观中立"的流水账。好的技术文章应该有：

明确的立场（这个工具好用/不好用）

个人判断（我推荐/不推荐）

真实感受（踩坑的痛苦、解决后的爽感）

#### 📝 具体胜过抽象

❌ "这个工具可以提高开发效率" ✅ "用了这个工具后，我每天能省出 30 分钟摸鱼时间"

---

Step 3: 参考示例

阅读 examples/ 目录中的示例文章，感受目标风格：

开头怎么写？

段落多长？

小标题怎么起？

代码示例怎么呈现？

结尾怎么收？

示例文章列表： （存放用户确认的终稿文章，用于校准写作风格）

---

Step 4: 撰写初稿

按照以下结构模板撰写：

# [直接、有态度的标题]
[开头：1-2句话抛出核心观点或问题]
[小标题1：问题/背景]
[2-3个短段落]
[小标题2：过程/分析]
[具体细节、代码、截图]
[小标题3：解决方案/结论]
[实操步骤或观点总结]
写在最后
[个人感想、行动号召、或前瞻性思考]

#### 标题技巧

好标题的特点：

1. 有数字 - "3 个坑让我搞了 2 小时" - "5 分钟搞定 XXX"

2. 有冲突/转折 - "XXX 官方文档没告诉你的事" - "为什么我放弃了 XXX"

3. 有态度 - "XXX 真的有必要吗？" - "XXX：被低估的神器"

#### 开头模式

用强有力的观点或个人经历开场：

✅ 好的开头：

"搞了两个小时，终于把这个坑填上了。"

"说实话，我一开始是拒绝用 XXX 的。"

"作为一个写了 5 年代码的人，我可以负责任地说：这玩意儿真的有用。"

❌ 避免的开头：

"随着人工智能的快速发展..."

"在当今数字化时代..."

"本文将介绍..."

#### 语言风格

推荐用词： | 场景 | 推荐 | 避免 | |------|------|------| | 表达观点 | "说实话"、"坦白讲" | "笔者认为" | | 遇到问题 | "踩了个坑"、"折腾了半天" | "遇到了一些困难" | | 解决问题 | "搞定了"、"终于跑通了" | "成功解决了该问题" | | 推荐 | "强烈推荐"、"真的好用" | "值得一试" |

避免的表达：

❌ "首先...其次...最后..."

❌ "值得注意的是"

❌ "综上所述"

❌ "不难发现"

❌ "众所周知"

❌ "笔者"（直接用"我"）

#### 段落和排版

每段 2-4 句话，最多不超过 5 句

单句成段用于强调重点

每 150-250 字加一个小标题

用 ### 作为主要小标题

用 #### 作为次级小标题

小标题要具体，不要太抽象

#### 代码块规范

代码块前后要有说明

长代码要加注释

关键代码可以用 行内代码 高亮

---

Step 5: 用户确认

完成初稿后，展示给用户并询问：

文章初稿已完成！请查收：

[文章内容预览]
你觉得怎么样？需要我：
📝 修改某些部分？
🔧 调整代码示例？
📐 改变文章长度？
🏷️ 补充特定内容？
✅ 直接定稿并保存？

确认要点：

是否符合预期？

有无事实性错误？

代码是否正确？

语气是否合适？

---

Step 6: 迭代修改

根据用户反馈进行修改：

1. 理解反馈：明确用户具体想改什么 2. 针对性修改：只改用户提到的部分，不要大改 3. 展示修改：用 diff 或高亮展示改了什么 4. 再次确认：改完后再次给用户确认

可以多次迭代，直到用户满意为止。

---

Step 7: 保存终稿

用户确认满意后，保存文章为 Markdown 文件：

文件命名：

YYYY-MM-DD-标题关键词.md

文件内容格式：

---
title: 完整标题
date: YYYY-MM-DD
tags: [标签1, 标签2, 标签3]
category: 技术/观点/教程
完整标题
[文章内容]
*文章由 AI 辅助创作，经人工审核确认*

保存位置：

用户指定路径，或

当前工作目录，或

examples/ 目录（如果用户同意作为示例）

---

🎨 不同类型文章的写作要点

1. 技术教程类

结构： 1. 开头：为什么需要这个？（痛点引入） 2. 环境准备：需要什么前置条件？ 3. 步骤详解：一步步操作，每步有代码 4. 验证结果：怎么确认成功了？ 5. 常见问题：可能遇到的坑

特点：

步骤清晰，可复现

代码完整，能直接跑

每个关键步骤有说明

---

2. 踩坑记录类

结构： 1. 开头：我遇到了什么问题？ 2. 复现过程：怎么触发这个问题的？ 3. 排查过程：我试了哪些方案？ 4. 解决方案：最后是怎么解决的？ 5. 总结：经验教训

特点：

真实经历，有代入感

详细记录错误信息和日志

方案对比，说明为什么选这个

---

3. 观点输出类

结构： 1. 开头：我的观点是什么？ 2. 背景：为什么有这个观点？ 3. 论证：事实、数据、案例支撑 4. 反驳：可能的反对意见及回应 5. 结论：总结观点

特点：

立场明确，不模棱两可

有数据或案例支撑

承认局限性（不要绝对化）

---

4. 技术分析类（对比/选型）

结构： 1. 开头：要对比什么？什么场景？ 2. 方案A：介绍、优点、缺点 3. 方案B：介绍、优点、缺点 4. 对比表格：关键维度对比 5. 结论：我的选择及理由

特点：

公平客观（但可以有倾向性）

维度清晰，对比明确

给出明确建议

---

5. 新闻资讯类

结构： 1. 开头：本期主要内容概览 2. 新闻1：标题 + 摘要 + 原文链接 3. 新闻2：标题 + 摘要 + 原文链接 4. ... 5. 总结：趋势观察或个人观点

特别要求：

必须附带原文链接

格式：新闻标题 或 👉 查看原文

用自己的话概括，不要直接复制

加入简短点评

---

📁 目录结构

blog-writer-cn/
├── SKILL.md              # 本技能文档
├── style-guide-cn.md     # 中文写作风格指南（核心参考）
└── examples/             # 示例文章库
    └── YYYY-MM-DD-title.md   # 示例文章

---

📝 风格指南速查

核心原则

1. 不要 AI 味（像跟朋友聊天） 2. 有观点、有态度 3. 具体胜过抽象

开头模板

"搞了两个小时，终于把这个坑填上了。"

"说实话，我一开始是拒绝用 XXX 的。"

"作为一个写了 X 年 XX 的人，我可以负责任地说..."

结构模板

# [直接、有态度的标题]
[开头：1-2句话抛出核心观点或问题]
[小标题1：问题/背景]
[2-3个短段落]
[小标题2：过程/分析]
[具体细节、代码、截图]
[小标题3：解决方案/结论]
[实操步骤或观点总结]
写在最后
[个人感想、行动号召、或前瞻性思考]

检查清单

写作完成后自查：

[ ] 标题是否有吸引力？

[ ] 开头是否直接切入主题？

[ ] 是否有"首先、其次、最后"等模板句式？

[ ] 段落是否太长（超过 5 句）？

[ ] 是否有个人观点和态度？

[ ] 结尾是否自然？

[ ] 通读一遍，像不像跟朋友聊天？

[ ] 新闻类文章：每条新闻是否都有原文链接？

---

🔗 相关资源

style-guide-cn.md - 完整的中文写作风格指南

examples/ - 示例文章库

参考博客：阮一峰的网络日志、酷壳、美团技术团队

---

💡 使用技巧

如何提出好的写作需求

❌ 不好的需求：

"帮我写篇文章"

"写一篇关于 Python 的"

✅ 好的需求：

"帮我写一篇关于 Python 装饰器的教程，面向初学者，800字左右"

"我遇到个问题：用 Docker 部署 Flask 时端口映射不生效，帮我写个踩坑记录"

"对比一下 FastAPI 和 Flask，我从 Flask 迁移到 FastAPI 的真实体验"

如何提供素材

如果你有参考资料，可以这样提供：

链接："参考这篇文章：[链接]"

笔记："这是我整理的要点：..."

代码："这是我的实现代码：..."

经历："上周我遇到这样一个问题：..."

---