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