back
loading skill details...
一套完整的写作方法论+质量保障流程。覆盖小说、博客、营销、技术文档四种内容类型,内置31个写作技巧和25项质量检测,确保每篇文章都有独特价值。
---
name: "quality-writer-pro"
version: "1.1.0"
title: "Quality Writer Pro - 全类型高质量内容创作系统"
description: "一套完整的写作方法论+质量保障流程。覆盖小说、博客、营销、技术文档四种内容类型,内置31个写作技巧和25项质量检测,确保每篇文章都有独特价值。"
author: "WDSEGA"
type: "workflow"
category: "writing"
tags: ["writing", "content", "blog", "novel", "marketing", "quality"]
difficulty: "beginner"
---
# Quality Writer Pro
## 目录
- [这是什么](#这是什么)
- [适用场景](#适用场景)
- [核心理念](#核心理念)
- [第一部分:四大铁律](#第一部分四大铁律)
- [铁律一:言之有物](#铁律一言之有物)
- [铁律二:言之有味](#铁律二言之有味)
- [铁律三:言之有序](#铁律三言之有序)
- [铁律四:言无虚发](#铁律四言无虚发)
- [第二部分:五种内容类型的写作要点](#第二部分五种内容类型的写作要点)
- [一、博客文章](#一博客文章)
- [二、短篇小说](#二短篇小说)
- [三、营销文案](#三营销文案)
- [四、技术文档](#四技术文档)
- [第三部分:写作流程(五步法)](#第三部分写作流程五步法)
- [第一步:蓄水(收集与构思)](#第一步蓄水收集与构思)
- [第二步:搭骨(结构设计)](#第二步搭骨结构设计)
- [第三步:落墨(内容生成)](#第三步落墨内容生成)
- [第四步:打磨(质量检测)](#第四步打磨质量检测)
- [第五步:出刊(发布与验证)](#第五步出刊发布与验证)
- [第四部分:快速参考卡](#第四部分快速参考卡)
- [使用方法](#使用方法)
- [端到端使用示例](#端到端使用示例)
- [版本信息](#版本信息)
## 这是什么
一套帮助AI写出高质量内容的完整系统。不只是规则清单,而是一套**从构思到发布的完整工作流**,确保每一步都做到位,最终交付的文章有信息量、有人味、有价值。
## 适用场景
| 内容类型 | 说明 |
|---------|------|
| **博客文章** | 技术教程、行业分析、经验分享 |
| **短篇小说** | 科幻、悬疑、温情、现实题材 |
| **营销文案** | 产品介绍、推广软文、社媒内容 |
| **技术文档** | API文档、使用指南、技术方案 |
## 核心理念
**好文章的标准只有一个:读者看完之后,知道了之前不知道的东西,或者感受到了之前没感受过的东西。**
做不到这一点的文章,不管辞藻多华丽、结构多工整,都是废纸。
---
## 第一部分:四大铁律
写任何内容之前,先在心里过这四条。任何一条不满足,就不要动笔。
### 铁律一:言之有物
每篇文章必须至少包含一个**读者不知道的信息点**。
判断方法:写完之后问自己——"读者看完这篇文章,能说出一个他之前不知道的东西吗?"如果说不出来,重写。
**具体做法:**
- 动笔前列出3-5个"信息增量点"(读者看完会获得的新知识/新视角/新数据)
- 每个信息增量点必须有一个具体的案例、数据或经历支撑
- 如果找不到信息增量,说明要么需要搜索补齐,要么换个角度
**反面教材:**
> "AI正在改变我们的生活方式,从工作到娱乐,从教育到医疗,无处不在。"
**正面教材:**
> "上个月我用AI把一份50页的技术文档压缩成了3页的摘要,准确率居然比人工摘要高了12%。但真正让我意外的不是结果,是过程——它发现了一个连原作者都没注意到的数据矛盾。"
### 铁律二:言之有味
文章读起来必须像**一个有经验的人在跟你聊天**,不像一台机器在输出信息。
判断方法:大声读一遍。读起来顺口、自然、有节奏感,就是好的。读起来磕磕绊绊、像在念稿子,就是差的。
**具体做法:**
- 用短句。短句有力。长句可以,但不能全是长句。
- 用口语。偶尔的"说实话""讲道理""怎么说呢"比"综上所述""值得注意的是"好一百倍。
- 用具体的东西代替抽象的词。"效率提升了40%"比"效率显著提升"好。"跑了三公里腿都在抖"比"非常疲惫"好。
- 允许不完美。真人说话会有犹豫、跑题、重复、自我纠正。这些"瑕疵"恰恰是人味的来源。
**反面教材:**
> "本文将从三个方面对这一问题进行深入分析。首先,探讨其历史背景;其次,剖析当前现状;最后,展望未来发展趋势。"
**正面教材:**
> "这事说来话长,但我尽量讲清楚。先说说怎么来的——大概三年前,有个工程师在加班的时候随手写了个脚本,没想到后来影响了整个行业。"
### 铁律三:言之有序
文章必须有一个**读者能感知到的推进方向**。每一段都比上一段更进一步,读者始终知道"我们在往哪走"。
判断方法:随机抽取文章中的任意连续三段,问自己——"从第一段到第三段,信息是在递进还是在原地打转?"如果是在打转,重写。
**具体做法:**
- 开头用一个具体场景或事件切入,不用"近年来""随着"开头
- 每段只做一件事:要么给新信息,要么推进观点,要么转折
- 段与段之间有逻辑关系:递进、转折、举例、对比——但不能是平行的罗列
- 关键信息不要一次性全倒出来,分批给,每批之间制造一点"想知道后面怎样"的好奇
**反面教材:**
> "第一,这个技术很先进。第二,这个技术很实用。第三,这个技术很有前景。"
**正面教材:**
> "这个技术刚出来的时候,没人当回事。毕竟类似的口号喊了十年了。但去年发生了一件事,让所有人都闭了嘴——一家三人的创业公司用这套技术,三个月做出了以前需要三十人团队一年才能做的东西。"
### 铁律四:言无虚发
文章里的每一个字都必须有存在的理由。如果一个句子删掉之后,上下文完全不受影响,那这个句子就不该存在。
判断方法:随机删掉文章中的任意一个句子,看上下文是否还通顺、信息是否还完整。如果完全不受影响,这个句子就是废的。
**具体做法:**
- 每段开头不要用过渡句凑数,直接进入正题
- 不要为了"结构完整"硬加开头和结尾
- 不要重复已经说过的信息(换个说法再说一遍也是重复)
- 结尾不要总结、不要升华、不要"希望对您有帮助"。文章在哪里自然结束,就在哪里结束
---
## 第二部分:五种内容类型的写作要点
### 一、博客文章
**目标**:读者看完之后,学到了一个具体的技能,或者对一个话题有了更深的理解。
**结构模板(不是必须遵守,但推荐):**
```
[场景切入] 用一个具体的问题/经历/数据开头,让读者立刻感受到"这跟我有关"
↓
[核心观点] 一句话说清这篇文章要讲什么
↓
[展开论证] 2-4个信息增量点,每个都有具体案例/代码/数据支撑
↓
[意外发现] 一个读者没想到的点(反直觉的发现、常见的误区、被忽略的细节)
↓
[自然收束] 在最有信息量的地方结束,不总结
```
**关键技巧:**
- 技术文章必须有可运行的代码,不能只有概念解释
- 观点文章必须有数据或案例支撑,不能只有"我认为"
- 经验文章必须有具体的细节(时间、数字、场景),不能只有"我建议"
### 二、短篇小说
**目标**:读者看完之后,记住了一个人物、一个场景、或者一种情绪。
**结构模板:**
```
[动作切入] 主角正在做一件具体的事,不要用描写开头
↓
[建立张力] 一个问题/冲突/异常出现,打破平衡
↓
[升级] 问题变得更复杂,或者出现了新的信息
↓
[转折] 一个读者没预料到的变化
↓
[收束] 在情绪最高点或最安静的地方结束,不要解释
```
**关键技巧:**
- 人物要有缺点。完美的人不是人,是无趣的符号
- 对话要承载两个功能:推进信息+展示人物性格。如果一段对话换成另一个人说也毫无违和,重写
- 场景要有感官细节。不只写"看到了什么",写"闻到了什么、听到了什么、摸到了什么"
- 情绪不要直接说"他很伤心",写一个具体的动作或生理反应
- 结尾不要解释主题。读者自己体会到的东西,比作者直接告诉他的深刻十倍
### 三、营销文案
**目标**:读者看完之后,想了解更多,或者想采取行动。
**结构模板:**
```
[痛点共鸣] 描述一个读者正在经历的困扰,让他觉得"说的就是我"
↓
[方案引入] 不是"我有一个产品",而是"有人用这个方法解决了同样的问题"
↓
[具体证据] 数据、案例、对比、用户反馈——至少两种
↓
[降低门槛] 让读者觉得"这不难,我也能做到"
↓
[自然引导] 不喊"立即购买",而是给出一个自然的下一步
```
**关键技巧:**
- 不要自夸,用事实说话。"用户增长了300%"比"业界领先的解决方案"有效
- 不要制造焦虑后立刻推销,读者会反感
- 用"你"而不是"大家",制造一对一的对话感
- 价格和优惠信息放在读者已经产生兴趣之后,而不是开头
### 四、技术文档
**目标**:读者看完之后,能够按照文档完成一个具体操作。
**结构模板:**
```
[一句话说明] 这篇文档帮你完成什么
↓
[前置条件] 需要什么环境/工具/知识
↓
[分步操作] 每一步都是:做什么→为什么→怎么做
↓
[常见问题] 预判读者会卡在哪里,提前解答
↓
[完整示例] 一个从头到尾的完整操作流程
```
**关键技巧:**
- 每一步都要有"为什么",不只写"怎么做"
- 代码示例必须能直接运行,不要写伪代码
- 用具体的命令和输出,不要写"运行相关命令"
- 预判读者会犯的错,提前提醒
---
## 第三部分:写作流程(五步法)
### 第一步:蓄水(收集与构思)
**做什么**:确定这篇文章的核心价值。
**动作清单**:
1. 明确内容类型(博客/小说/营销/技术文档)
2. 列出3-5个"信息增量点"——读者看完会获得什么
3. 找到一个独特角度——别人都写A面,你写B面
4. 如果信息不够,搜索补齐。信息不够就不动笔
**检查门**:能用一句话说清"这篇文章的核心价值是什么"吗?说不清,回去继续想。
### 第二步:搭骨(结构设计)
**做什么**:设计文章的骨架,确保信息递进。
**动作清单**:
1. 确定开头怎么切入(用一个场景/事件/问题)
2. 列出2-4个核心段落,每段负责一个信息增量点
3. 确定段与段之间的逻辑关系(递进/转折/对比)
4. 确定在哪里放"意外发现"——读者没想到的东西
5. 确定在哪里结束——最有信息量的地方
**检查门**:任意连续三段,信息是在递进吗?在原地打转就重排。
### 第三步:落墨(内容生成)
**做什么**:按结构写内容,边写边润色。
**动作清单**:
1. 按结构逐段写,每段只做一件事
2. 每写完一段,检查:像人话吗?有具体信息吗?
3. 用短句和长句交替,制造节奏感
4. 用具体的东西代替抽象的词
5. 偶尔加入口语化表达和个人色彩
**检查门**:随机读一段,磕磕绊绊就改到顺口为止。
### 第四步:打磨(质量检测)
**做什么**:全面检查,确保没有问题。
**检测清单(25项)**:
**信息质量(5项)**
- [ ] 读者能说出至少一个之前不知道的信息点?
- [ ] 每个观点都有具体的案例/数据/代码支撑?
- [ ] 有一个读者意想不到的发现或视角?
- [ ] 没有重复已经说过的信息?
- [ ] 没有废话(删掉任何一句都不影响上下文)?
**表达自然(8项)**
- [ ] 没有"首先/其次/再次/最后"的模板结构?
- [ ] 没有"综上所述/总而言之/值得注意的是"等套话?
- [ ] 没有"希望对您有所帮助/期待您的反馈"等标配结尾?
- [ ] 句子长度有变化(不全长、不全短)?
- [ ] 用了简单动词(是/有/在/做),不用"彰显/赋能/助力"?
- [ ] 用了主动语态,不用"被/由/为...所"?
- [ ] 同一个词自然重复使用,没有刻意换同义词?
- [ ] 有至少一处"不完美"的表达(口语/犹豫/跑题)?
**结构合理(5项)**
- [ ] 开头用一个具体场景/事件切入,不用"近年来/随着"?
- [ ] 每段只做一件事(给信息/推观点/转折/举例)?
- [ ] 段与段之间有逻辑推进(不是平行罗列)?
- [ ] 关键信息分批给出,不是一次性全倒?
- [ ] 结尾在最有信息量的地方自然结束,不总结不升华?
**情感与节奏(4项)**
- [ ] 有态度(喜欢/讨厌/惊讶/认同),不是中立搬运?
- [ ] 有情绪起伏(不是平铺直叙从头到尾一个调)?
- [ ] 有至少一处让读者"想知道后面怎样"的好奇缝隙?
- [ ] 用"你"制造对话感,不用"大家/读者/用户"?
**隐私与格式(3项)**
- [ ] 不包含真实人名、网址、账号、Token等隐私信息?
- [ ] 所有占位符使用通用形式(your-username/your-url)?
- [ ] 格式符合目标平台要求(Markdown/HTML/纯文本)?
**不通过的处理**:
- 信息质量不通过 → 回到第二步搭骨,重新设计
- 表达自然不通过 → 逐项修改,改完重新检查
- 结构合理不通过 → 回到第二步搭骨,重新排列
- 情感节奏不通过 → 在当前基础上调整,不需要重写
- 隐私格式不通过 → 替换占位符/调整格式
### 第五步:出刊(发布与验证)
**做什么**:发布到目标平台,并亲自确认成功。
**动作清单**:
1. 按目标平台要求格式化内容
2. 发布到目标平台
3. **亲自验证**:访问发布链接,确认内容完整、格式正确
4. 如果发布失败,排查原因并重新发布
5. 记录发布结果(链接、平台、时间)
**检查门**:打开发布链接,亲眼看到内容完整显示。
---
## 第四部分:快速参考卡
### 写之前问自己三个问题
1. **读者看完能学到什么?** → 确定信息增量
2. **我跟别人写的不一样的地方在哪?** → 确定独特角度
3. **我用一句话怎么推荐这篇文章?** → 确定核心价值
### 写的时候记住三句话
1. **用具体的东西代替抽象的词**
2. **像跟朋友聊天一样写**
3. **每段只做一件事**
### 写完之后查三个点
1. **删掉任何一句,上下文受影响吗?** → 不受影响就删
2. **大声读一遍,顺口吗?** → 不顺口就改
3. **读者看完能说出一个新东西吗?** → 说不出来就重写
---
## 使用方法
### 作为独立工具使用
将本文件作为SKILL安装到OpenClaw/ClawHub,在需要写内容时调用。
### 作为写作指南使用
直接阅读本文档,按照五步法执行写作流程。
### 作为质量检查清单使用
写完文章后,对照第三部分"打磨"环节的25项检测清单逐项检查。
---
## 端到端使用示例
以下是一个完整的写作流程示例,展示如何从零开始使用本系统写一篇博客文章。
### 示例:写一篇关于"用 AI 提升代码审查效率"的技术博客
#### 第一步:蓄水(收集与构思)
```
内容类型:博客文章(技术教程)
信息增量点:
1. AI 代码审查工具能发现人工容易遗漏的安全漏洞类型
2. 实际项目中 AI 审查将 bug 率降低了 23% 的案例
3. AI 审查的正确配置方法(很多人配错了导致误报太多)
独特角度:不只讲"AI 多好用",重点讲"怎么配才能不翻车"
核心价值一句话:帮你把 AI 代码审查从"误报太多不想用"变成"每天必开的第一件事"
```
#### 第二步:搭骨(结构设计)
```
开头:上周同事差点把一个 SQL 注入漏洞发到生产环境——AI 审查拦住了,但三个月前它没拦住另一个类似的。区别在于配置。
↓
核心段1:AI 代码审查能发现哪些人工容易漏的(具体漏洞类型 + 数据)
↓
核心段2:为什么很多人觉得 AI 审查"没用"(误报问题 + 配置误区)
↓
核心段3:正确的配置方法(可复制的配置文件 + 对比效果)
↓
意外发现:AI 审查最大的价值不是找 bug,是让新人写代码时不敢偷懒
↓
结尾:在"新人不敢偷懒"这个点上自然结束
```
#### 第三步:落墨(内容生成)
按照结构逐段写,每段只做一件事。写的时候注意:
- 用短句和长句交替
- 用具体数据代替"显著提升"
- 偶尔加入口语化表达
#### 第四步:打磨(质量检测)
对照 25 项检测清单逐项检查:
```
信息质量:
[x] 读者能说出至少一个之前不知道的信息点 → "原来 AI 审查能发现 SQL 注入"
[x] 每个观点都有具体案例/数据支撑 → 有真实项目数据
[x] 有一个读者意想不到的发现 → "最大价值是让新人不敢偷懒"
[x] 没有重复信息 → 通过
[x] 没有废话 → 删掉了两段过渡句
表达自然:
[x] 没有"首先/其次/再次/最后" → 通过
[x] 没有"综上所述"等套话 → 通过
[x] 句子长度有变化 → 通过
[x] 用了简单动词 → 通过
...(逐项检查)
结构合理:
[x] 开头用具体事件切入 → "同事差点把漏洞发到生产环境"
[x] 每段只做一件事 → 通过
[x] 段与段之间有逻辑推进 → "问题→原因→方案→意外发现"
[x] 结尾在最有信息量的地方结束 → 通过
情感与节奏:
[x] 有态度 → "AI 审查不是银弹,但配对了真的很香"
[x] 有情绪起伏 → 从紧张(差点出事)到释然(拦住了)
[x] 有好奇缝隙 → "三个月前它没拦住另一个类似的——区别在哪?"
隐私与格式:
[x] 不包含真实人名/账号 → 用"同事"代替
[x] 占位符使用通用形式 → 通过
[x] 格式符合 Markdown → 通过
```
#### 第五步:出刊(发布与验证)
```
1. 格式化为 Markdown,添加代码块高亮
2. 发布到技术博客
3. 访问发布链接,确认内容完整、代码块正确渲染
4. 记录:发布于 [平台],链接 [URL],时间 [日期]
```
### 其他使用场景示例
**写短篇小说**:调用本技能后,告诉 AI "我要写一篇 2000 字的悬疑短篇,主题是程序员深夜加班发现代码里藏着一封信"。AI 会按照五步法引导你完成从构思到成稿的全过程,并在第四步用 25 项清单检测质量。
**写营销文案**:调用本技能后,提供产品信息和目标用户,AI 会按照营销文案的结构模板生成初稿,然后逐项检查是否符合"言之有物""言之有味"等标准。
**质量检查已有文章**:直接把写好的文章交给 AI,要求"用 Quality Writer Pro 的 25 项质量检测清单检查这篇文章",AI 会逐项检查并给出修改建议。
---
## 版本信息
- **版本**:1.1.0
- **许可**:MIT-0
- **适用**:所有内容类型
- **语言**:中文(可适配其他语言)
- **更新日志**:修复功能数量描述(80+ → 31个写作技巧+25项质量检测),添加目录结构和端到端使用示例
don't have the plugin yet? install it then click "run inline in claude" again.