| name | chinese-blog-writer |
| description | 生成中文技术博客文章。当用户提到写博客、写文章、技术分享、写教程、写总结、博客草稿、内容创作、技术写作时使用此技能。 |
中文技术博客生成器
概述
根据用户提供的主题和技术要点,生成一篇风格统一、结构规范的中文技术博客文章。输出格式为 Markdown,适合直接发布到博客平台或公众号。
使用场景
- 学完一个新技术概念,想写一篇教程
- 做完一个技术 demo,想分享经验
- 需要把英文技术文档转化为中文博客
- 团队内部技术分享的文稿
写作规范
文章结构(必须遵循)
每篇文章必须包含以下结构:
# 标题(简洁有力,15字以内)
> 一句话摘要:用一句话说清楚这篇文章讲什么
## 引言
- 用一个场景或问题引入(为什么读者应该关心这个话题)
- 说明这篇文章会覆盖什么内容
- 预期读者:前端/后端/全栈/初学者等
## 核心概念
- 用通俗的语言解释核心概念
- 必须包含至少一个类比(让非专业读者也能理解)
- 如果有多个概念,用对比表格呈现
## 实战演示
- 完整可运行的代码示例
- 逐步拆解,每一步都要解释"为什么这样做"
- 关键代码行加注释
## 常见问题 / 踩坑记录
- 至少列出 2-3 个常见问题
- 每个问题给出解决方案
## 总结
- 3-5 个核心要点的 bullet list
- 下一步学习建议或延伸阅读
写作风格
| 要求 | 说明 |
|---|
| 语气 | 对话式,像在和朋友聊天,不要学术腔 |
| 人称 | 第一人称"我"为主,拉近距离 |
| 段落 | 每段不超过 4 行,保持阅读节奏 |
| 专业术语 | 首次出现时附英文原文,如:渐进式披露(Progressive Disclosure) |
| 类比 | 每个核心概念至少一个生活化类比 |
| 过渡 | 段落之间要有自然过渡,不要突兀跳转 |
代码规范
- 代码块必须标注语言类型(
python, javascript 等)
- 关键行加中文注释
- 完整可运行,不要省略 import 语句
- 如果代码超过 30 行,拆分成多个代码块,中间穿插解释
格式规范
- 标题层级:最多到 h3(###),不要用 h4 及以下
- 列表项:保持同一层级的格式统一
- 图片/图表:用
 格式,描述要写清楚
- 强调:粗体用于关键概念,
行内代码用于技术术语
输出要求
- 输出纯 Markdown 格式
- 文章长度:1500-3000 字(不含代码)
- 代码示例必须完整可运行
- 文末不加"关注我"等推广内容
示例输入输出
输入:
主题:Python 装饰器
要点:什么是装饰器、语法糖原理、常用场景(计时器、权限校验、缓存)
输出示例(节选):
# Python 装饰器:给函数穿上"外套"
> 一句话摘要:装饰器就是一个函数,它接收一个函数,返回一个增强版的函数。
## 引言
你有没有遇到过这种情况?你写了 20 个 API 接口,每个接口都要做权限校验。
你把同样的 if-else 复制了 20 遍,改一个地方就要改 20 次。
这时候你需要的就是装饰器——它能把重复的逻辑抽出来,像穿外套一样"套"在函数上面。
这篇文章会讲清楚三件事:装饰器是什么、怎么写、用在哪。
质量检查清单
生成文章后,自查以下项目: