Skip to content

10.3 微信公众号:把一篇技术笔记扩成长文 ​

这一节覆盖什么 ​

上一节是"一稿发多平台"的短内容。这一节做相反的事:手上只有一页潦草的排查笔记,要把它变成一篇能发的 2000 字公众号技术长文——带场景钩子、带能跑的代码、带配图位置和封面提示。

这活看着简单,坑在代码。笔记里的示例往往是当时凑出来的,直接抄进文章就是把 bug 发给读者。这一节会看到 dsh 在这一步上真实的表现:它没有照抄,它改了代码,并且明确告诉了你它为什么改。

最终效果:工作区里多出一份 wechat-article.md,正文之外还附了 3 组备选标题、一段摘要、配图位置建议和封面提示词。

为什么值得复刻 ​

技术长文最费时间的不是写字,是把"我当时怎么踩坑、怎么定位、怎么改"这条线重新讲顺。笔记里只有结论和片段,读者要的是过程。这一节演示的就是让 agent 补全过程,同时把事实边界守住。

本节用到的能力:

能力在哪学的在本节怎么用
文件读写Part 2读笔记、写长文
工具调用树3.2看它读了哪个文件、写了几次
改动文件卡片3.2一轮结束只看它动了哪些文件
附件与图片4.2有截图素材时贴进去,让它按位置引用

准备素材 ​

在工作区放一份 wechat-note.md,就是你平时记的那种排查笔记,不用整理。我们的样例是一份鸿蒙列表页卡顿的记录:现象(输入时卡、安卓不卡)、排查过程(不是网络、每个字符触发全量过滤、主线程跑)、两个真问题(没防抖 + ForEach 键值用了下标)、改法、一段 ArkTS 示例代码、以及几条"可以展开写"的方向。

越像真笔记越好。你整理过的笔记,它写出来的文章也就没有你的味道了。

分步操作 ​

第一步:新建会话,选工作区和模型 ​

新建会话,权限选工作区内修改,工作区选到放着 wechat-note.md 的那个(点输入框上方的工作区名切换,2.2 节)。模型选能稳定写长中文的,我们用的 glm-5.3-flash。

第二步:一条指令同时管正文和物料 ​

text
请读取工作区里的 wechat-note.md,把它扩写成一篇 2000 字左右、适合发微信公众号的技术长文。
要求:1. 开头用场景钩子(读者痛点)吸引人;2. 中间给出一个可运行的鸿蒙(ArkTS)核心代码示例;
3. 结尾加一段引导关注话术。扩写完成后,再额外产出:3 组备选标题(带风格说明)、一段 50 字内摘要、
文中配图位置建议、一张封面图的中英文 prompt。把这篇长文保存为工作区的 wechat-article.md。
不要使用 ask_user_question 工具向我提问,直接产出。

"额外产出"那几项是公众号工作流真正缺的东西:标题要挑、摘要要填、封面要做、图要知道放哪。一次要齐,省得来回。

粘贴扩写指令

第三步:发送并等它写完 ​

按 Enter 发出。这一轮它会先读笔记、再写文件,所以过程组里能看到一次文件读取和一次文件写入。

发送后进入运行状态

第四步:看产出 ​

实测这一轮产出的 wechat-article.md 约 9.4 KB,正文按"场景钩子 / 现象解析 / 三个关键点 / 引导关注"走完,末尾附了物料:

  • 3 组备选标题,风格是分开标的:场景钩子型、数据对比型、反差悬念型
  • 一段 50 字内摘要,正好能填公众号的摘要栏
  • 3 处配图位置建议,分别放在钩子之后、现象解析之后、代码之后,每处写了这张图要承担什么作用
  • 封面提示词中英双版,英文版末尾带 --ar 2.35:1,是按公众号横版封面来的

长文开头

第五步:重点看它对代码做了什么 ​

这是这一节最该读的部分。笔记里那段示例代码写的是:

ts
this.shown = await taskPool.execute(() => this.all.filter(it => it.title.includes(k)))

它在正文里没有照抄,而是改写成了规范的 TaskPool 写法(@Concurrent 装饰的独立过滤函数 + taskpool.Task),并且在回复末尾专门说明了一句:

笔记原代码里 taskPool.execute(() => ...) 这种箭头函数直接入池的写法在实际 ArkTS 中不可用(子线程任务必须 @Concurrent 且可序列化),文中已按可运行的标准写法改写,其余排查叙事和数据均忠实于你的备忘录。

两件事值得学:一是它改了,而且改了有理由——箭头函数确实不能直接进 TaskPool,照抄进文章就是给读者一段跑不通的代码;二是它主动交代了改动范围,并且把"其余内容忠实于原文"这句话说了出来。这正是你希望它有的行为。

中段:改写说明与代码

但别因为它交代了就免检。它说"其余忠实于原文",你要抽两段对着笔记核:数字有没有被改动、排查顺序有没有被美化、结论有没有被加强。它改代码是能力,它改叙事是风险,两者在界面上看起来一模一样。

备选标题与物料

第六步:审阅与发布 ​

在右侧边栏直接打开 wechat-article.md 预览(2.3 节,Markdown 会渲染出来)。逐段过完,剩下的复制、选封面、写摘要、发布,自己点。理由和 10.2 一样:发布是不可逆的对外动作。

长文结尾

常见问题 ​

问:它把代码改对了,我怎么确认它没有顺手把别的也改了?

看改动文件卡片(3.2 节)。这一节它只应该动 wechat-article.md 一个文件;如果 wechat-note.md 也出现在卡片里,说明它去改了你的原始笔记——这不是你要的,直接让它回滚。

问:能不能让它连图也一起生成?

可以,但那是另一件事:生图要额外的模型和额度,而且封面是品牌资产,第一次生成通常不合用。建议这一节只拿 prompt,图自己出。

问:2000 字它真的写够吗?

实测这一份约 9.4 KB 的 Markdown(含代码和附物料),正文规模符合预期。字数类要求不要指望它精确,看段落结构和信息密度更实际。

问:为什么让它"不要提问"?

因为扩写类任务一旦被反问,流程就断了,而这类任务缺的信息通常可以从笔记里推。真推不出来时它还是会问——那时说明你的笔记太薄,补两句比换指令有用。

问:这套流程能复用吗?

能,而且比 10.2 更值得固化:把"读 wechat-note.md → 按这四段结构写 → 附三组标题/摘要/配图位置/封面提示 → 保存为 wechat-article.md → 只排版不改事实、改代码必须说明理由"写成 .agents/skills/wechat-longform/SKILL.md,以后一句"扩成长文"就走。

小结 ​

这一节的收获不在"它写了 2000 字",而在两个具体判断:它把笔记里跑不通的 ArkTS 代码改对了并主动说明,以及它说"忠实于原文"之后你仍然要抽查。技术内容交给它扩写很省时间,省下的时间正好用来做这件事。

下一节换个场景:不写内容,而是让 agent 对一个真实代码库做体检。

发现错误?提交反馈 · 欢迎 提 PR 改进本书