| 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：解决方案/结论]
[实操步骤或观点总结]
### 写在最后
[个人感想、行动号召、或前瞻性思考]
标题技巧
好标题的特点：
-
有数字
- "3 个坑让我搞了 2 小时"
- "5 分钟搞定 XXX"
-
有冲突/转折
- "XXX 官方文档没告诉你的事"
- "为什么我放弃了 XXX"
-
有态度
- "XXX 真的有必要吗？"
- "XXX：被低估的神器"
开头模式
用强有力的观点或个人经历开场：
✅ 好的开头：
- "搞了两个小时，终于把这个坑填上了。"
- "说实话，我一开始是拒绝用 XXX 的。"
- "作为一个写了 5 年代码的人，我可以负责任地说：这玩意儿真的有用。"
❌ 避免的开头：
- "随着人工智能的快速发展..."
- "在当今数字化时代..."
- "本文将介绍..."
语言风格
推荐用词：
| 场景 | 推荐 | 避免 |
|---|
| 表达观点 | "说实话"、"坦白讲" | "笔者认为" |
| 遇到问题 | "踩了个坑"、"折腾了半天" | "遇到了一些困难" |
| 解决问题 | "搞定了"、"终于跑通了" | "成功解决了该问题" |
| 推荐 | "强烈推荐"、"真的好用" | "值得一试" |
避免的表达：
- ❌ "首先...其次...最后..."
- ❌ "值得注意的是"
- ❌ "综上所述"
- ❌ "不难发现"
- ❌ "众所周知"
- ❌ "笔者"（直接用"我"）
段落和排版
- 每段 2-4 句话，最多不超过 5 句
- 单句成段用于强调重点
- 每 150-250 字加一个小标题
- 用
### 作为主要小标题
- 用
#### 作为次级小标题
- 小标题要具体，不要太抽象
代码块规范
- 代码块前后要有说明
- 长代码要加注释
- 关键代码可以用
行内代码 高亮
Step 5: 用户确认
完成初稿后，展示给用户并询问：
文章初稿已完成！请查收：
---
[文章内容预览]
---
你觉得怎么样？需要我：
- 📝 修改某些部分？
- 🔧 调整代码示例？
- 📐 改变文章长度？
- 🏷️ 补充特定内容？
- ✅ 直接定稿并保存？
确认要点：
- 是否符合预期？
- 有无事实性错误？
- 代码是否正确？
- 语气是否合适？
Step 6: 迭代修改
根据用户反馈进行修改：
- 理解反馈：明确用户具体想改什么
- 针对性修改：只改用户提到的部分，不要大改
- 展示修改：用 diff 或高亮展示改了什么
- 再次确认：改完后再次给用户确认
可以多次迭代，直到用户满意为止。
Step 7: 保存终稿
用户确认满意后，保存文章为 Markdown 文件：
文件命名：
YYYY-MM-DD-标题关键词.md
文件内容格式：
---
title: 完整标题
date: YYYY-MM-DD
tags: [标签1, 标签2, 标签3]
category: 技术/观点/教程
---
# 完整标题
[文章内容]
---
*文章由 AI 辅助创作，经人工审核确认*
保存位置：
- 用户指定路径，或
- 当前工作目录，或
examples/ 目录（如果用户同意作为示例）
🎨 不同类型文章的写作要点
1. 技术教程类
结构：
- 开头：为什么需要这个？（痛点引入）
- 环境准备：需要什么前置条件？
- 步骤详解：一步步操作，每步有代码
- 验证结果：怎么确认成功了？
- 常见问题：可能遇到的坑
特点：
- 步骤清晰，可复现
- 代码完整，能直接跑
- 每个关键步骤有说明
2. 踩坑记录类
结构：
- 开头：我遇到了什么问题？
- 复现过程：怎么触发这个问题的？
- 排查过程：我试了哪些方案？
- 解决方案：最后是怎么解决的？
- 总结：经验教训
特点：
- 真实经历，有代入感
- 详细记录错误信息和日志
- 方案对比，说明为什么选这个
3. 观点输出类
结构：
- 开头：我的观点是什么？
- 背景：为什么有这个观点？
- 论证：事实、数据、案例支撑
- 反驳：可能的反对意见及回应
- 结论：总结观点
特点：
- 立场明确，不模棱两可
- 有数据或案例支撑
- 承认局限性（不要绝对化）
4. 技术分析类（对比/选型）
结构：
- 开头：要对比什么？什么场景？
- 方案A：介绍、优点、缺点
- 方案B：介绍、优点、缺点
- 对比表格：关键维度对比
- 结论：我的选择及理由
特点：
- 公平客观（但可以有倾向性）
- 维度清晰，对比明确
- 给出明确建议
5. 新闻资讯类
结构：
- 开头：本期主要内容概览
- 新闻1：标题 + 摘要 + 原文链接
- 新闻2：标题 + 摘要 + 原文链接
- ...
- 总结：趋势观察或个人观点
特别要求：
- 必须附带原文链接
- 格式：
[新闻标题](原文URL) 或 👉 [查看原文](URL)
- 用自己的话概括，不要直接复制
- 加入简短点评
📁 目录结构
blog-writer-cn/
├── SKILL.md # 本技能文档
├── style-guide-cn.md # 中文写作风格指南（核心参考）
└── examples/ # 示例文章库
└── YYYY-MM-DD-title.md # 示例文章
📝 风格指南速查
核心原则
- 不要 AI 味（像跟朋友聊天）
- 有观点、有态度
- 具体胜过抽象
开头模板
- "搞了两个小时，终于把这个坑填上了。"
- "说实话，我一开始是拒绝用 XXX 的。"
- "作为一个写了 X 年 XX 的人，我可以负责任地说..."
结构模板
# [直接、有态度的标题]
[开头：1-2句话抛出核心观点或问题]
### [小标题1：问题/背景]
[2-3个短段落]
### [小标题2：过程/分析]
[具体细节、代码、截图]
### [小标题3：解决方案/结论]
[实操步骤或观点总结]
### 写在最后
[个人感想、行动号召、或前瞻性思考]
检查清单
写作完成后自查：
🔗 相关资源
style-guide-cn.md - 完整的中文写作风格指南examples/ - 示例文章库- 参考博客：阮一峰的网络日志、酷壳、美团技术团队
💡 使用技巧
如何提出好的写作需求
❌ 不好的需求：
- "帮我写篇文章"
- "写一篇关于 Python 的"
✅ 好的需求：
- "帮我写一篇关于 Python 装饰器的教程，面向初学者，800字左右"
- "我遇到个问题：用 Docker 部署 Flask 时端口映射不生效，帮我写个踩坑记录"
- "对比一下 FastAPI 和 Flask，我从 Flask 迁移到 FastAPI 的真实体验"
如何提供素材
如果你有参考资料，可以这样提供：
- 链接："参考这篇文章：[链接]"
- 笔记："这是我整理的要点：..."
- 代码："这是我的实现代码：..."
- 经历："上周我遇到这样一个问题：..."
