Blog Writer (深度长文写作)

blog-writer-zh：中文深度长文写作技能

概述

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

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

工作流程

1. 明确需求 — 确认主题、观点、长度、参考材料

2. 撰写初稿 — 按风格框架和结构模板落笔，写入 drafts/ 目录

3. 迭代修改 — 用户本地编辑或对话修改，两种方式可混用

4. 读者审阅 — subagent 以读者视角批判性审阅，挑逻辑漏洞和不同观点

5. 去 AI 味（可选）— 用 humanizer-zh 处理套路化表达

6. 多平台导出（可选）— 生成可上传到小红书、公众号、知乎等平台的格式

7. 定稿归档（依赖环境变量）— 归档至参考文章目录

安装设置

安装本技能后，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 路径下的参考文章进行风格校准，确保新文章与既有风格保持连贯。

何时使用

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

• "帮我写一篇关于……的文章"
• "整理一下我对……的思考"
• "写个分析，关于……"
• "我想写一篇科技评论"
• "发公众号/知乎/小红书"
• "把这段扩写成文章"
• "润色这篇文章"
• 任何需要长文输出的写作需求

写作风格框架

详细风格指南见 [references/style-guide.md](references/style-guide.md)，包括核心风格特征、语言风格、开头策略、读者互动技巧、Dos and Don'ts、长度校准等。

文章结构模板

提供四种模板应对不同场景，详见 [references/templates.md](references/templates.md)：

• 默认模板 — 标准思辨文章结构
• 快速观点模板 — 300-800 字短文章
• 深度分析模板 — 1500-3000 字长文
• 研究论证模板 — 数据驱动型文章

写作流程

第一步：明确需求

向用户确认以下信息（如果用户没有主动提供）：

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 技能，则跳过此步骤。

第六步：多平台导出（可选）

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

用户明确提出"导出"、"发布小红书"、"导出到公众号"、"导出到知乎"或"导出文章"等要求时触发。如用户未提及，此步骤跳过。

平台兼容性

| 平台 | 导入格式 | 标题支持 |

| --- | --- | --- |

| 小红书 | Markdown (.md) | 仅识别 H1、H2 |

| 知乎 | Markdown (.md) | 仅识别 H1、H2 |

| 公众号 | DOCX (.docx) | 仅识别 H1、H2 |

转换规则

| 原文 | 转换后 | 说明 |

| --- | --- | --- |

| #（H1，文章标题） | #（H1） | 保持不变 |

| ##（H2，章节标题） | #（H1） | 升级为 H1 |

| ###（H3，子章节标题） | ##（H2） | 升级为 H2 |

| #### 及更深 | 加粗段落 | 去掉 # 前缀，文字加粗 |

脚注 [^n] 转换为文末有序列表（参考来源），正文中的 [^n] 内联标记移除。

导出流程

运行导出脚本，生成平台兼容的 Markdown 文件，DOCX 通过 pandoc 转换：

python3 skills/blog-writer-zh/scripts/export.py <文章路径> [-o <输出目录>]

输出文件：

• <原标题>-export.md — 小红书/知乎可直接导入
• <原标题>-export.docx — 公众号可直接导入 (需安装 pandoc)

若 pandoc 未安装，脚本会提醒用户并跳过 docx 生成，仅输出 md 文件。

输出路径约定

导出文件默认放在原文同级目录。如果用户指定了输出路径，以用户指定为准。

导出完成后，告知用户生成了哪些文件，以及分别适用于哪个平台。

第七步：定稿归档（依赖环境变量）

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

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

完成所有修改并确认文章是最终版本后：

1. 清理导出文件 — 删除 drafts/ 下该文章对应的 xxx-export.md 和 xxx-export.docx（如有）

2. 归档原 md — 将 drafts/ 下的原始 md 文件复制到 $BLOG_REFERENCES_DIR 目录下（保持相同的文件名）

目的：

• 用户的参考文章库持续积累，后续写作时有更多风格锚点
• 新写的文章本身也会反哺未来的写作——每一篇都是下一篇的养分
• 导出文件是平台适配产物，不污染参考库

风格校准策略

当 BLOG_REFERENCES_DIR 已设置时，写作前读取该目录下最新的 3-5 篇 .md 文件，重点关注：

1. 句式节奏 — 平均句长、标点运用习惯（破折号、分号、冒号的频率和位置）

2. 论证结构 — 常用几层维度展开、结论如何收束、过渡句的模式

3. 词汇偏好 — 高频分析性词汇、过渡词使用模式、是否有固定的口头禅或标志性表达

如果参考文章之间风格差异较大，以最新的一篇为主，其余作为辅助。校准不是机械模仿，而是吸收节奏和气质，让新文章与既有风格保持连贯。

证据与搜索

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

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

搜索时会关注：

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

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

输出格式

• 文件格式：Markdown（.md）
• 编码：UTF-8
• 文章结构：参照上方模板
• 如有外部引用或数据，在文末附上参考来源