# Blog Writer Cn

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

- Skill: `luokai0/blog-writer-cn` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add luokai0/blog-writer-cn`
- Raw SKILL.md: https://api.skillmd.com/api/skills/luokai0/blog-writer-cn/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: luokai0 (https://skillmd.com/u/luokai0)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/luokai0/blog-writer-cn

---


# 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: 撰写初稿

按照以下结构模板撰写：

```markdown
# [直接、有态度的标题]

[开头：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
```

**文件内容格式**：
```markdown
---
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. 总结：趋势观察或个人观点

**特别要求**：
- **必须附带原文链接**
- 格式：`[新闻标题](原文URL)` 或 `👉 [查看原文](URL)`
- 用自己的话概括，不要直接复制
- 加入简短点评

---

## 📁 目录结构

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

---

## 📝 风格指南速查

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

### 开头模板
- "搞了两个小时，终于把这个坑填上了。"
- "说实话，我一开始是拒绝用 XXX 的。"
- "作为一个写了 X 年 XX 的人，我可以负责任地说..."

### 结构模板
```markdown
# [直接、有态度的标题]

[开头：1-2句话抛出核心观点或问题]

### [小标题1：问题/背景]
[2-3个短段落]

### [小标题2：过程/分析]
[具体细节、代码、截图]

### [小标题3：解决方案/结论]
[实操步骤或观点总结]

### 写在最后
[个人感想、行动号召、或前瞻性思考]
```

### 检查清单

写作完成后自查：

- [ ] 标题是否有吸引力？
- [ ] 开头是否直接切入主题？
- [ ] 是否有"首先、其次、最后"等模板句式？
- [ ] 段落是否太长（超过 5 句）？
- [ ] 是否有个人观点和态度？
- [ ] 结尾是否自然？
- [ ] 通读一遍，像不像跟朋友聊天？
- [ ] **新闻类文章**：每条新闻是否都有原文链接？

---

## 🔗 相关资源

- `style-guide-cn.md` - 完整的中文写作风格指南
- `examples/` - 示例文章库
- 参考博客：阮一峰的网络日志、酷壳、美团技术团队

---

## 💡 使用技巧

### 如何提出好的写作需求

**❌ 不好的需求**：
- "帮我写篇文章"
- "写一篇关于 Python 的"

**✅ 好的需求**：
- "帮我写一篇关于 Python 装饰器的教程，面向初学者，800字左右"
- "我遇到个问题：用 Docker 部署 Flask 时端口映射不生效，帮我写个踩坑记录"
- "对比一下 FastAPI 和 Flask，我从 Flask 迁移到 FastAPI 的真实体验"

### 如何提供素材

如果你有参考资料，可以这样提供：
- 链接："参考这篇文章：[链接]"
- 笔记："这是我整理的要点：..."
- 代码："这是我的实现代码：..."
- 经历："上周我遇到这样一个问题：..."

---