Quality Writer Pro

Other

一套完整的写作方法论+质量保障流程。覆盖小说、博客、营销、技术文档四种内容类型,内置31个写作技巧和25项质量检测,确保每篇文章都有独特价值。

Install

openclaw skills install quality-writer-pro

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