材料已经齐了,文章为什么还是空
“我们整理了六个来源,并结合官网的六十二篇文章目录,选择了选题调研与学习笔记成稿两个方向。这个过程说明,好的 Agent 工作流需要清楚的目标、充分的上下文和能够核对的结果。”
这是本次工作中留下的第一版开头。数字没有编造,方向也没写错,但读者仍不知道:自己遇到什么问题,做完这篇练习能得到什么。后面的“准备来源、提出候选、检查重复”同样缺少实际决定。
我们接着把它改成了选题调研助手这篇文章。这篇讲这次改稿怎么做:让内容助手读取实际资料,写出可审阅的草稿,再依据具体意见修改。最有用的输入,是已经发生的决定和能够打开的产物。
把素材交成一个工作包
这轮写作没有重新找一个虚构客户。素材就是前一项工作留下的六条来源记录、62 篇文章目录和四张选题卡。
在独立目录里,我们保留了 source-notes.md、topic-cards.md 和 editor-notes.md。前者记录来源读到哪里,中间一份保存采用或暂缓的决定,最后一份说明本次实际做过什么、什么还没有结果。
例如,自动字幕已经取得并读完,但视频画面没有核验;Claude Code 的尝试没有产出可用结果,实际资料整理在 Codex 中完成。这些区别会直接影响文章能不能用“我们跟着跑通了”这样的句子。
下载工作包,按 README 中的成稿练习打开文件。包里有实际初稿、编辑意见和修订稿;英文版材料中的翻译会标注为编辑翻译,不冒充另一次独立模型运行。
先写事实表,把可写的边界摆出来
正式写正文之前,我们整理了下面这张事实表。它可以作为内容助手每次开工时的一个小产物。
| 素材中有的内容 | 正文可以怎样写 | 不能推成什么 |
|---|---|---|
| 导出目录里有 62 条文章记录 | 本轮使用了 62 篇已注册文章的目录快照 | 全文查重已经完成、Google 已收录 62 篇 |
| 六条来源记录 | 整理了六个来源,其中阅读程度不同 | 完整看过六段视频 |
| 两项采用、两项暂缓 | 本轮形成了四个选题决定 | 两篇已完成、两篇没有价值 |
| 实际保存的初稿、意见与改稿 | 展示这次编辑过程与产物 | 已证明长期提效或稳定成功率 |
这一步不需要写成长报告。它的作用是让你看见:同一份记录,经过一句不小心的概括,就可能变成另外一个事实。
本次事实核对与改稿都在同一工作任务内完成,包含人工式编辑判断;不是由互不知情的评审做的对照实验。
第一条成稿请求,要交代读者和材料
读者可以用下面这条请求复做成稿练习。它是本次编辑步骤整理出的可复用版本,换资料后结果需要重新审阅。
读取来源笔记、选题卡和本次实际操作记录。
读者是想把一项重复工作交给个人 Agent 的职场用户。
先整理事实表:每条要写的事实对应哪个输入;
无法确认的功能、结果与数字单独列出。
再给出提纲,写出开头和一个完整实操段落。
实操段落要包含:
- 当时的任务和输入;
- 具体做了什么决定;
- 一个有内容的产物片段;
- 怎样检查,以及下一步。
来源中的操作和我们实际做过的操作分开写。
没有成功运行的产品,不得写成成功实测。
输出到 first-draft.md,保留输入材料。
不必要求它一开始就写出很长的文章。先看开头和一个实操段落,通常就能发现它是否理解了任务。如果连“选题卡长什么样”都没有写出来,继续加章节只会拉长同样的问题。
这六条修改意见,比再写详细一点有用
我们对实际初稿留下了六条编辑意见,完整记录在 outputs/editor-review.md。其中最影响成稿的是这几条:
- 开头先报资料数量,读者看不到自己的问题。改从“收藏了教程,却不知道下一步做什么”切入。
- “目标、上下文、结果”太抽象。展示已采用的调研助手和暂缓的定时工作流,解释决定为何不同。
- 补一条能直接复制的请求,写清输入文件和交回格式。
- 保留查重范围:目录只有标题和摘要,不把它写成全文审查。
- 交代实际运行环境,保留产物下载,不加入未经验证的云端与定时能力。
- 文件清单只帮助读者找到材料,正文继续解释工作怎样完成。
这些意见改变的是信息安排、例子和事实范围。我们没有用“更专业”“更有深度”这样的描述让助手自行猜测。
改完之后,看同一处具体变化
修订后的开头先提出读者的问题:收藏了教程,真正动手时仍不知道该选哪个、能做什么、是否与已有内容重复。接着交代实际产物:两个采用方向、两个暂缓方向及理由。
中段则补上了具体决定。原来的“检查是否重复”,变成了:定时工作流已经有对应旧文,而当前新材料只有简介;先补新机制和实际任务,再决定更新旧文还是新写。
| 初稿中的说法 | 修订后增加的内容 |
|---|---|
| “清楚的目标、充分的上下文” | 目标读者、六条来源及其阅读程度、目录的实际字段 |
| “检查是否重复” | 具体旧文、暂缓理由和需要补充的内容 |
| “让下一步更明确” | 用本轮笔记写开头,保存意见和改稿 |
图中是实际初稿与修订稿的摘录。它帮助我们检查文章究竟增加了什么;原始文本仍可以在工作包里对照阅读。
第二次检查,确认改稿没有顺手改掉事实
改稿会让句子顺畅,也可能让限定条件消失。我们回读了最终稿,并用输入再次核对目录数量、来源编号、采用和暂缓的状态;检查链接是否指向所说的来源与站内文章。
例如,“读完一份自动字幕”没有升级为“看完所有视频”;“目录发现相近主题”没有升级为“全文去重”;“两项采用”也没有升级为“两篇上线”。这些都能回到工作包中的具体文件检查。
视觉审核同样看信息:手机上能否读清前后变化,图注是否解释了这是产物摘录,关键意思是否也在正文。图片漂亮不能代替事实核对。
本篇和上一篇的下载包共用同一组材料。你可以把初稿和意见交给自己的助手要求修改,再打开我们的修订稿比较。这个练习没有唯一措辞答案:重点是读者问题、具体决定、来源边界有没有留下来。
把能重复使用的部分留下
下一次写作时,换掉来源、选题卡和操作记录,保留“事实表—局部初稿—具体意见—改稿—回读”的顺序。这个顺序可以先写进一份工作说明,明确让助手读取。
等它在不同任务里确实用过,再考虑封装成 Skill。Claude Code Skills 文档介绍了保存可复用指令的机制;如何防止规则越写越长,可以接着看Skill 维护实践。保存文件本身并不证明以后每次都能做好。
这次最终留下了初稿、编辑意见、两种语言的修订稿和事实核对表。下一位接手的人可以看见每项变化的理由,也能继续处理尚未完成的内容。