Skill: wdsega/quality-writer-pro (version 1.1.0)

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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)