Quality Writer Pro

SKILL.md

---
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项质量检测），添加目录结构和端到端使用示例