← 返回 Skills 市场
xavier-ljf

Blog Writer (深度长文写作)

作者 Xavier Lu · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ 安全检测通过
103
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install blog-writer-zh
功能描述
用中文撰写科技/行业思辨类文章,风格理性犀利、结构清晰。适用场景:用户想写个人思考感悟、科技评论、行业分析文章时。触发关键词包括“写篇文章”、“帮我写一篇关于”、“整理一下我对……的思考”、“写个分析”、“深度思考”。如果不确定是否该用,优先触发——写作类需求一般都适用。
使用说明 (SKILL.md)

blog-writer-zh:中文科技思辨写作技能

概述

本技能帮助用中文撰写科技评论、行业分析和个人深度思考类文章。输出风格融合了冷静的批判性分析结构性论证——敢于下判断,但论证过程理性克制,力求让思考沉淀为体系化的文字。

BLOG_REFERENCES_DIR 环境变量指定风格参考文章的存放路径,由技能目录下的 .env 文件管理。每次调用时会自动解析该文件并注入环境变量。如果已设置且路径有效,技能会在写作前阅读参考文章校准风格;如果未设置,则表示没有参考文章,不影响技能正常使用。

安装设置

安装本技能后,agent 会询问用户是否需要设置风格参考库路径:

  • 提供路径 → agent 将 BLOG_REFERENCES_DIR=/用户的/路径 写入 skills/blog-writer-zh/.env
  • 不提供 → 不影响技能使用,写作风格将没有参考样本校准

后期如需修改配置,直接编辑该文件或重新运行安装设置即可。

环境变量解析(调用时)

每次技能被触发时,agent 会按以下流程解析 BLOG_REFERENCES_DIR

  1. 检查 skills/blog-writer-zh/.env 文件是否存在
  2. 读取其中的 BLOG_REFERENCES_DIR
  3. 导出为进程环境变量
  4. 如果值无效或未设置,跳过参考文章读取

解析后,后续所有逻辑(见第六步)直接使用该环境变量。此外,如果用户强调"和我之前的文章保持一致"或类似要求,主动读取 BLOG_REFERENCES_DIR 路径下的参考文章进行风格校准,确保新文章与既有风格保持连贯。

何时使用

当用户表达以下意图时触发:

  • “帮我写一篇关于……的文章”
  • “整理一下我对……的思考”
  • “写个分析,关于……”
  • “我想写一篇科技评论”
  • 任何需要长文输出的写作需求

写作风格框架

核心风格特征

冷静的批判者

  • 敢于提出尖锐观点
  • 但不是情绪化宣泄,而是用结构化分析支撑观点
  • 质疑行业共识和主流叙事,但从逻辑和事实出发
  • 批判的同时保持平衡,不偏激 —— 每个维度都有优劣势分析

结构化思维

  • 论证分层展开,逻辑链条清晰
  • 标题分级组织内容(# → ## → ###)
  • 每个论点都有对应的论据和展开
  • 结论部分对整体观点进行提炼和延伸

思辨而非描述

  • 不止于“发生了什么”,更要问“这意味着什么”
  • 关注趋势背后的驱动力和长远影响
  • 从现象推导出本质逻辑
  • 在结尾提出自己的设想或预测

第一人称的个人视角

  • 文章是“我的思考”,不是百科或新闻稿
  • 可以亮明个人立场和判断
  • 结尾可以有自己的展望或设想

内容主题

主要方向:

  • AI / 科技发展对社会结构的影响
  • 技术趋势对企业和商业模式的重塑
  • AI 时代下产品形态和应用生态的演变
  • 科技巨头的战略逻辑和行业格局变化

次要方向:

  • 数字化转型中的机遇与挑战
  • 技术伦理和隐私问题
  • 开发者生态和工具链演进

语言风格

  • 中文书写,专业但易懂
  • 避免过度使用英文术语
  • 句子偏中长句,保持分析性语感
  • 使用“——”、“:”、“;”等标点增强结构和节奏
  • 可以把 核心概念 加粗强调
  • 引用/强调内容时使用 “”(直角引号),而非方角引号

词汇提示:

  • 多用“本质”、“驱动”、“逻辑”、“趋势”、“范式”等分析性词汇
  • 可用“笔者认为”、“更深层的问题是”、“值得思考的是”等过渡
  • 批判时用“值得警惕的是”、“但这一逻辑可能站不住脚”、“表面上看……实际上……”

避免:

  • ❌ 过度口语化(“卧槽”、“牛逼”)
  • ❌ 网络梗和流行语
  • ❌ 情绪化宣泄
  • ❌ 无证据的武断结论

开头策略

开篇决定了读者是否愿意继续往下看。根据文章调性选择以下策略之一:

  1. 一句话断言 — 直接亮出核心判断,制造认知冲击。

    “2025 年做 AI 应用的团队,90% 还没想清楚自己的产品是给谁用的。”

  2. 现象引子 — 从具体事件或观察切入,引出深层问题。

    “最近读了三个不同来源的报告,不约而同指向同一个判断——AI 公司的估值逻辑正在经历一次静默的重估。”

  3. 反问切入 — 抛出问题迫使读者思考。

    “当所有人都在说 AI 改变一切的时候,你有没有想过一个问题——”

  4. 反常识观点 — 先承认主流认知,再推翻它。

    “表面上是技术竞争,但如果你再往深看一层,这根本不是一个技术问题。”

  5. 自我披露 — 从个人经历或认知转变讲起,增加真实感。

    “整理了过去一年的笔记,发现我对这个话题的认知发生了三次反转,今天想聊聊整个过程。”

开头要快速进入核心——不要在背景铺垫上花太多笔墨。

读者互动技巧

以下是在文章中与读者建立对话感的写作技巧:

  • 反问制造张力 — “但换个角度想,这到底是在帮用户还是在绑架用户?”、“如果这个逻辑成立,那接下来会发生什么?”
  • 对话感开头 — “如果你最近也在关注 [话题],你大概也注意到了……”
  • 对比切入 — “当 [A] 在讲 [X] 的时候,[B] 却在悄悄做 [Y]。这两条路径背后是完全不同的逻辑。”
  • 直接对话读者 — “想象一下,你是一个……”、“把你自己放到那个位置,你会怎么选?”
  • 引导思考停顿 — “暂停一下,先想想这个问题……”用来制造阅读节奏,给读者思考喘息空间

行动准则:Dos and Don'ts

✅ 要做

  • ✓ 质疑行业共识和主流叙事,但从逻辑和事实出发
  • ✓ 每个判断都要有对应的论据展开
  • ✓ 认可批判对象的合理之处,保持公平——不为了锐度而故意偏颇
  • ✓ 承认自己的不确定性——不是所有问题都有答案,坦诚比强行闭环更有说服力
  • ✓ 用具体案例和数据把抽象观点落回地面
  • ✓ 文章结尾留下延伸思考的空间,而不是强行总结

❌ 不要

  • ✗ 为了锐度而牺牲论证完整性——尖锐不等于偏激
  • ✗ 下无数据或推理支撑的武断结论
  • ✗ 过度堆砌英文术语(“该方案的 ROC 曲线在 AUC 维度显著优于 baseline”——打住)
  • ✗ 写“正确的废话”——人人都同意且无需争论的观点不值得用户花一篇文章写
  • ✗ 三段式排比结构滥用(“不仅……更……还……”反复出现是 AI 写作的典型标志)
  • ✗ 在背景铺垫上浪费太多笔墨,读者是来读用户的思考的,不是来上科普课

长度校准

不同深度的文章对字数有不同要求,写作前确认目标:

类型 字数 适用场景
闪念观点 300-500 字 有感而发,不展开长篇分析,类似笔记整理
标准分析 800-1500 字 典型文章,有完整论证链,适合大部分话题
深度长文 1500-3000 字 多维度分析,需要多个案例和数据支撑

文章结构模板

默认模板

# [犀利观点型标题]

## 开篇:抛出观点
- 一句话抛出核心判断
- 简要说明为什么这个问题值得讨论
- 有时可给出现象描述作为引子

## 主体:分层论证(2-4 个维度)

### 维度一:[第一个分析角度]
- 展开分析
- 优劣势或正反面权衡
- 具体案例或推理过程

### 维度二:[第二个分析角度]
- 同上

### 维度三/四(可选)
- 同上

## 深层分析:回到本质
- 以上现象背后的驱动逻辑
- 想要说明的更宏观的结论
- 指出思维范式的转变

## 结语:展望与预测
- 总结核心判断
- 提出自己的设想
- 给读者留下思考空间

快速观点模板(适合较短的文章)

# [观点标题]

## 我的判断
一句话亮明观点

## 为什么这么说
3-4 个分点支撑,每个点一段话

## 所以呢
结论和延伸思考

深度分析模板

多一层、多一个视角,让论证更厚实。每个阶段都有清晰的任务,避免写到一半跑偏。

# [具体的问题或判断型标题]

## 开头策略(选其一)
- **震撼观察** — “[关于话题的反直觉事实]”
- **反问式开场** — “[引出核心问题的反问]”
- **断言式开场** — “[挑战行业共识的锐利判断]”

## 钩子(1-2 句)
抓住读者注意力,建立话题的重要性

## 核心论点
一句话说清楚整篇文章想证明什么

---

## 1. 背景与现状
- 为什么这个议题现在值得讨论
- 当前行业的主流叙事是什么
- 大多数人默认相信什么

## 2. 证据与事实
- 关键数据或事实 #1
- 关键数据或事实 #2
- 关键数据或事实 #3
- 数据实际说明什么 vs. 主流说法是什么

## 3. 有问题的假设
- 主流叙事背后藏着什么假设
- 这个假设为什么站不住脚
- 具体场景里这个假设如何失效

## 4. 真正的后果
- 如果这个趋势继续会怎样
- 谁受益、谁受损
- 哪些关联趋势在放大这个效应

## 5. 争议与分寸
- 对立视角中值得认可的论点
- 判断可能在什么地方过早
- 坦诚还不确定的领域

## 结语
- 呼应开头的观察
- 留给读者一个值得思考的问题
- 这件事的未来走向意味着什么

研究论证模板(适合数据驱动型文章)

先亮结论,再用多层证据层层包围,最后诚实交代不确定性。少讲大道理,多用事实逼出判断。

# [论点型标题]

## 核心主张
清晰的立场陈述

## 证据层 1:数据
关键数据点 + 来源

## 证据层 2:案例
具体事件或亲身经历

## 证据层 3:对比
行业横向比较或趋势演变分析

## 坦诚
哪里不确定、哪里可能不对

## 结论
理性读者应该从这些证据中得出什么判断

写作流程

第一步:明确需求

向用户确认以下信息(如果用户没有主动提供):

  1. 主题 — 想写什么话题
  2. 核心观点 — 有没有要表达的立场
  3. 目标长度 — 默认 800-1500 字
  4. 参考材料 — 是否有补充链接或资料

第二步:撰写初稿并落盘

参照风格框架和结构模板完成初稿后,直接写入本地文件,路径格式为 skills/blog-writer-zh/drafts/YYYY-MM-DD-文章标题.md

写完即存盘,之后用户可以在本地直接用编辑器修改,无需再通过 agent 迭代。

第三步:迭代修改

初稿落盘后,用户可以通过以下两种方式修改:

  1. 本地编辑 — 直接用编辑器修改文件
  2. 对话修改 — 告诉 agent 修改意见,由 agent 调整

两种方式可以混用,怎么方便怎么来。

第四步:读者视角审阅

⚠️ 开始本步骤前,重新从文件读取当前内容(因为用户可能已经在本地做了修改)。

完成第三步后,需要审阅时告诉 agent。agent 会创建一个无额外上下文的 subagent,读取文件内容,站在普通读者的视角进行审阅。subagent 的任务是:

  1. 指出逻辑漏洞 — 论证链条中有没有跳跃或站不住脚的地方
  2. 提出不同观点 — 和文章立场相对或互补的视角
  3. 检查表达清晰度 — 有没有不够清晰、容易引起歧义的地方
  4. 提供改进建议 — 具体可操作的修改方向

⚠️ subagent 不应只是点赞,而是要有实质性的批判性意见。它的角色是“有见地的读者”,不是编辑也不是粉丝。

获取 subagent 的反馈后,评估哪些意见有道理并采纳,哪些可以忽略。不需要照单全收——要有自己的判断。

第五步:去 AI 味儿处理(可选)

⚠️ 开始本步骤前,重新从文件读取当前内容(因为用户可能在上一步后又做了本地修改)。

如果用户觉得文章读起来还有“AI味儿”——结构太工整、用词太套路、缺灵气——告诉 agent 需要处理,agent 会用 humanizer-zh 技能做一轮去 AI 痕迹处理。该技能会检测并修复以下模式:

  • 过度强调意义和广义趋势
  • 三段式法则和否定式排比
  • AI 高频词汇(此外、至关重要、格局、关键性……)
  • 破折号过度使用
  • 模糊归因和填充短语
  • 缺乏个性的“无菌”表达

若没有安装 humanizer-zh 技能,则跳过此步骤。

第六步:定稿归档(依赖环境变量)

⚠️ 开始本步骤前,重新从文件读取当前内容(因为用户可能在上一步后又做了本地修改)。

仅在 BLOG_REFERENCES_DIR 环境变量已设置时执行本步骤。 如果未设置,此步骤自动跳过。

完成所有修改并确认文章是最终版本后,将定稿移动到参考库中,作为后续文章的风格样本。将 drafts/ 目录下的定稿文件移动到 $BLOG_REFERENCES_DIR 目录下(保持相同的文件名)。

目的:

  • 用户的参考文章库持续积累,后续写作时有更多风格锚点
  • 新写的文章本身也会反哺未来的写作——每一篇都是下一篇的养分

证据与搜索

贯穿写作全程的能力。以下情况会启动 web 搜索 来补充论据:

  • 观点缺支撑 — 某个判断听起来有道理但缺少数据、案例或引用,主动搜索相关材料
  • 用户提出要求 — 例如用户说“这个观点找些数据支撑”、“帮我查一下某某的现状”,立即搜索
  • 事实存疑 — 对某个事实或数据不确定时,搜索核实后再写入
  • 读者视角触发 — subagent 审阅后指出“这个论点需要证据”,搜索补充后再修改

搜索时会关注:

  • 权威来源(行业报告、官方数据、知名媒体)
  • 近期数据(科技类话题时效性很重要)
  • 多角度信息(不只找支持文章观点的,也看反方论据)

搜索到的引用和数据会在文末参考来源中列出,方便用户追溯验证。

输出格式

  • 文件格式:Markdown(.md)
  • 编码:UTF-8
  • 文章结构:参照上方模板
  • 如有外部引用或数据,在文末附上参考来源
安全使用建议
Treat this as an incomplete review rather than a clean security assessment. The supplied VirusTotal telemetry is clean, but the skill should be reviewed again when SKILL.md, metadata, and artifact contents are readable.
能力评估
Purpose & Capability
Artifact contents were unavailable due to local command failures, so purpose-capability coherence could not be confirmed from SKILL.md or metadata.
Instruction Scope
Instruction scope could not be assessed from artifact text because the workspace files could not be read.
Install Mechanism
Install behavior could not be assessed from local artifacts; no negative VirusTotal signal was supplied.
Credentials
Environment access could not be assessed without artifact contents.
Persistence & Privilege
Persistence and privilege behavior could not be assessed without artifact contents.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install blog-writer-zh
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /blog-writer-zh 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
改名为: Blog Writer (深度长文写作)
v1.0.0
Initial release: 中文科技/行业思辨类文章写作技能
元数据
Slug blog-writer-zh
版本 1.0.1
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Blog Writer (深度长文写作) 是什么?

用中文撰写科技/行业思辨类文章,风格理性犀利、结构清晰。适用场景:用户想写个人思考感悟、科技评论、行业分析文章时。触发关键词包括“写篇文章”、“帮我写一篇关于”、“整理一下我对……的思考”、“写个分析”、“深度思考”。如果不确定是否该用,优先触发——写作类需求一般都适用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 103 次。

如何安装 Blog Writer (深度长文写作)?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install blog-writer-zh」即可一键安装,无需额外配置。

Blog Writer (深度长文写作) 是免费的吗?

是的,Blog Writer (深度长文写作) 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Blog Writer (深度长文写作) 支持哪些平台?

Blog Writer (深度长文写作) 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Blog Writer (深度长文写作)?

由 Xavier Lu(@xavier-ljf)开发并维护,当前版本 v1.0.1。

💬 留言讨论