Lord1Egypt blog-writer-zh：中文深度长文写作技能
概述
本技能帮助用中文撰写科技评论、行业分析和个人深度思考类文章。输出风格融合了冷静的批判性分析与结构性论证——敢于下判断，但论证过程理性克制，力求让思考沉淀为体系化的文字。
BLOG_REFERENCES_DIR 环境变量指定风格参考文章的存放路径，由技能目录下的 .env 文件管理。每次调用时会自动解析该文件并注入环境变量。如果已设置且路径有效，技能会在写作前阅读参考文章校准风格；如果未设置，则表示没有参考文章，不影响技能正常使用。
工作流程
- 明确需求 — 确认主题、观点、长度、参考材料
- 撰写初稿 — 按风格框架和结构模板落笔，写入
drafts/目录 - 迭代修改 — 用户本地编辑或对话修改，两种方式可混用
- 读者审阅 — subagent 以读者视角批判性审阅，挑逻辑漏洞和不同观点
- 去 AI 味（可选）— 用
humanizer-zh处理套路化表达 - 多平台导出（可选）— 生成可上传到小红书、公众号、知乎等平台的格式
- 定稿归档（依赖环境变量）— 归档至参考文章目录
安装设置
安装本技能后，agent 会询问用户是否需要设置风格参考库路径：
- 提供路径 → agent 将
BLOG_REFERENCES_DIR=/用户的/路径写入skills/blog-writer-zh/.env - 不提供 → 不影响技能使用，写作风格将没有参考样本校准
后期如需修改配置，直接编辑该文件或重新运行安装设置即可。
环境变量解析
每次技能被触发时，agent 会按以下流程解析 BLOG_REFERENCES_DIR：
- 检查
skills/blog-writer-zh/.env文件是否存在 - 读取其中的
BLOG_REFERENCES_DIR值 - 导出为进程环境变量
- 如果值无效或未设置，跳过参考文章读取
解析后，后续所有逻辑直接使用该环境变量。此外，如果用户强调"和我之前的文章保持一致"或类似要求，主动读取 BLOG_REFERENCES_DIR 路径下的参考文章进行风格校准，确保新文章与既有风格保持连贯。
何时使用
当用户表达以下意图时触发：
- "帮我写一篇关于……的文章"
- "整理一下我对……的思考"
- "写个分析，关于……"
- "我想写一篇科技评论"
- "发公众号/知乎/小红书"
- "把这段扩写成文章"
- "润色这篇文章"
- 任何需要长文输出的写作需求
写作风格框架
详细风格指南见 references/style-guide.md，包括核心风格特征、语言风格、开头策略、读者互动技巧、Dos and Don'ts、长度校准等。
文章结构模板
提供四种模板应对不同场景，详见 references/templates.md：
- 默认模板 — 标准思辨文章结构
- 快速观点模板 — 300-800 字短文章
- 深度分析模板 — 1500-3000 字长文
- 研究论证模板 — 数据驱动型文章
写作流程
第一步：明确需求
向用户确认以下信息（如果用户没有主动提供）：
- 主题 — 想写什么话题
- 核心观点 — 有没有要表达的立场
- 目标长度 — 默认 800-1500 字
- 参考材料 — 是否有补充链接或资料
第二步：撰写初稿并落盘
参照风格框架和结构模板完成初稿后，直接写入本地文件，路径格式为 skills/blog-writer-zh/drafts/YYYY-MM-DD-文章标题.md。
写完即存盘，之后用户可以在本地直接用编辑器修改，无需再通过 agent 迭代。
第三步：迭代修改
初稿落盘后，用户可以通过以下两种方式修改：
- 本地编辑 — 直接用编辑器修改文件
- 对话修改 — 告诉 agent 修改意见，由 agent 调整
两种方式可以混用，怎么方便怎么来。
第四步：读者视角审阅
⚠️ 开始本步骤前，重新从文件读取当前内容（因为用户可能已经在本地做了修改）。
完成第三步后，需要审阅时告诉 agent。agent 会创建一个无额外上下文的 subagent，读取文件内容，站在普通读者的视角进行审阅。subagent 的任务是：
- 指出逻辑漏洞 — 论证链条中有没有跳跃或站不住脚的地方
- 提出不同观点 — 和文章立场相对或互补的视角
- 检查表达清晰度 — 有没有不够清晰、容易引起歧义的地方
- 提供改进建议 — 具体可操作的修改方向
⚠️ 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 环境变量已设置时执行本步骤。 如果未设置，此步骤自动跳过。
完成所有修改并确认文章是最终版本后：
- 清理导出文件 — 删除
drafts/下该文章对应的xxx-export.md和xxx-export.docx（如有） - 归档原 md — 将
drafts/下的原始 md 文件复制到$BLOG_REFERENCES_DIR目录下（保持相同的文件名）
目的：
- 用户的参考文章库持续积累，后续写作时有更多风格锚点
- 新写的文章本身也会反哺未来的写作——每一篇都是下一篇的养分
- 导出文件是平台适配产物，不污染参考库
风格校准策略
当 BLOG_REFERENCES_DIR 已设置时，写作前读取该目录下最新的 3-5 篇 .md 文件，重点关注：
- 句式节奏 — 平均句长、标点运用习惯（破折号、分号、冒号的频率和位置）
- 论证结构 — 常用几层维度展开、结论如何收束、过渡句的模式
- 词汇偏好 — 高频分析性词汇、过渡词使用模式、是否有固定的口头禅或标志性表达
如果参考文章之间风格差异较大，以最新的一篇为主，其余作为辅助。校准不是机械模仿，而是吸收节奏和气质，让新文章与既有风格保持连贯。
证据与搜索
贯穿写作全程的能力。以下情况会启动 web 搜索 来补充论据：
- 观点缺支撑 — 某个判断听起来有道理但缺少数据、案例或引用，主动搜索相关材料
- 用户提出要求 — 例如用户说"这个观点找些数据支撑"、"帮我查一下某某的现状"，立即搜索
- 事实存疑 — 对某个事实或数据不确定时，搜索核实后再写入
- 读者视角触发 — subagent 审阅后指出"这个论点需要证据"，搜索补充后再修改
搜索时会关注：
- 权威来源（行业报告、官方数据、知名媒体）
- 近期数据（科技类话题时效性很重要）
- 多角度信息（不只找支持文章观点的，也看反方论据）
搜索到的引用和数据会在文末参考来源中列出，方便用户追溯验证。
输出格式
- 文件格式：Markdown（.md）
- 编码：UTF-8
- 文章结构：参照上方模板
- 如有外部引用或数据，在文末附上参考来源