Blog Writer (深度长文写作)

SKILL.md

---
name: blog-writer-zh
description: 用中文撰写科技/行业思辨类文章，风格理性犀利、结构清晰。适用场景：用户想写个人思考感悟、科技评论、行业分析、公众号/知乎/小红书长文，或需要润色、扩写、改写现有内容时。触发关键词包括"写篇文章"、"帮我写一篇关于"、"整理一下我对……的思考"、"写个分析"、"深度思考"、"发公众号"、"知乎专栏"、"小红书文案"、"把这段扩写成文"、"润色这篇文章"。如果不确定是否该用，优先触发——写作类需求一般都适用。
---

# 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 转换：

```bash
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
- 文章结构：参照上方模板
- 如有外部引用或数据，在文末附上参考来源