# Blog Creator

> 创作高质量的技术博客文章。擅长将复杂的技术概念转化为通俗易懂的内容，结构清晰，案例丰富，适合不同层次的技术读者。

- Skill: `liuyueyi/blog-creator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add liuyueyi/blog-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/liuyueyi/blog-creator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: liuyueyi (https://skillmd.com/u/liuyueyi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/liuyueyi/blog-creator

---


# 博客创作技能

## 何时使用此技能
- 撰写技术教程和指南
- 分享项目实战经验
- 总结技术方案和架构设计
- 记录问题解决过程
- 编写产品使用文档
- 创建代码示例和最佳实践
- 撰写技术观点和分析文章

## 创作指导

### 第一步：明确博客定位和受众

**目标读者**：
- 初学者：需要基础概念讲解、详细步骤、大量示例
- 进阶开发者：关注实现细节、性能优化、最佳实践
- 资深专家：侧重架构设计、技术选型、深度分析

### 第二步：设计文章结构

**标准技术博客结构**：
```markdown
# 标题（清晰、具体、有吸引力）

## 引言
- 背景介绍
- 问题提出
- 文章价值
- 阅读预期

## 正文
### 1. 基础概念（可选）
### 2. 核心内容
### 3. 实践案例
### 4. 深入分析

## 总结
- 要点回顾
- 最佳实践建议
- 延伸思考

## 参考资料
```

### 第三步：写作技巧和规范

**标题撰写**：
- 清晰表达主题，避免标题党
- 包含关键词，便于搜索
- 突出价值点（如"完整指南"、"实战总结"、"深入解析"）
- 适当使用数字（如"5 个技巧"、"3 种方案"）

**内容组织**：
- 逻辑清晰，层次分明
- 由浅入深，循序渐进
- 重要内容前置
- 善用小标题分割长文

**代码示例**：
- 确保代码可运行
- 添加必要的注释
- 展示完整上下文
- 标注重点代码行
- 提供多种实现方案对比

**图表运用**：
- 架构图：展示系统整体结构
- 流程图：说明业务流程
- 时序图：描述交互过程
- 对比表：清晰展示差异
- 截图：辅助说明操作步骤

**语言表达**：
- 准确专业，避免歧义
- 通俗易懂，少用生僻术语
- 主动语态，增强可读性
- 适度幽默，增加趣味性

### 第四步：博客示例

**技术教程示例**：
```markdown
# Spring Boot 集成 Redis 完整教程

## 你将学到什么
- 如何在 Spring Boot 项目中集成 Redis
- Redis 的基本配置和使用
- 实现缓存功能的最佳实践

## 环境准备
- JDK 1.8+
- Spring Boot 2.x
- Redis 5.0+

## 步骤一：添加依赖
在 pom.xml 中添加：

`
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
`

## 步骤二：配置 Redis
application.properties:

`
spring.redis.host=localhost
spring.redis.port=6379
spring.redis.password=
spring.redis.database=0
`

## 步骤三：创建配置类
...（详细代码）

## 常见问题
Q: 连接超时怎么办？
A: 检查 Redis 服务是否启动，防火墙设置...

## 总结
...（关键点回顾）
```

**实战总结示例**：
```markdown
# 一次生产环境 OOM 问题的排查与解决

## 问题背景
某日收到监控告警，应用频繁 Full GC，响应变慢...

## 排查过程
### 1. 查看监控指标
- heap 使用率持续 90%+
- Old 区只增不减

### 2. 导出堆 dump 分析
使用 jmap 导出：
```bash
jmap -dump:format=b,file=heap.hprof <pid>
```

### 3. MAT 分析
发现大量 XXX 对象未释放...

## 根本原因
代码中 XXX 处，缓存未设置过期时间...

## 解决方案
1. 添加缓存过期策略
2. 使用 LRU 淘汰算法
3. 限制缓存最大容量

## 经验教训
- 缓存必须设置过期时间
- 加强监控和告警
- 定期 review 缓存使用


### 第五步：质量检查清单

**内容检查**：
- [ ] 标题准确反映内容
- [ ] 引言清晰说明价值
- [ ] 结构层次分明
- [ ] 代码示例可运行
- [ ] 图表清晰易懂
- [ ] 无错别字和语法错误
- [ ] 链接有效
- [ ] 参考资料完整

**技术准确性**：
- [ ] 概念解释准确
- [ ] 代码实现正确
- [ ] 方案经过验证
- [ ] 版本信息最新
- [ ] 无明显技术错误

**可读性**：
- [ ] 段落适中（3-5 行）
- [ ] 句子简洁明了
- [ ] 专业术语有解释
- [ ] 有实际案例支撑
- [ ] 重点内容有强调

### 第六步：发布和推广建议

**发布平台选择**：
- 个人博客/网站
- 技术社区（掘金、思否、CSDN、博客园）
- 公司技术博客
- GitHub README/Wiki
- 微信公众号/知乎专栏

**SEO 优化**：
- 标题包含关键词
- 摘要清晰描述内容
- 合理使用标签和分类
- 内部链接和外部引用
- 图片添加 alt 描述

**推广策略**：
- 相关技术社区分享
- 社交媒体传播
- 技术群交流推荐
- 与同类文章互链

## 注意事项

**避免的问题**：
1. 抄袭和侵权 - 坚持原创，引用需注明
2. 内容过时 - 及时更新或标注版本
3. 代码不可运行 - 务必测试验证
4. 错误引导 - 技术方案需经过实践检验
5. 广告嫌疑 - 客观评价，避免过度营销

**最佳实践**：
1. 保持持续输出
2. 建立个人品牌
3. 与读者互动反馈
4. 定期回顾和优化旧文
5. 形成系列专题