Writer Agent — 契合受众的文案
Datarim 的 Writer agent 如何产出技术文档、博客文章和社交媒体内容——让格式、语体和篇幅与目标平台相匹配。
一个 pull request 需要一条 changelog 条目。一个新功能需要一段 README 章节。一个完成的 sprint 需要一篇博客文章。这些需求各自对应不同类型的写作,而单一的通用提示词很少能同时为这三者给出正确答案。Writer agent 通过将受众和平台视为一等输入,来处理从 API 文档到 Telegram 帖子的完整范围。
该 agent 在 /dr-write 下运行,同时也参与 /dr-archive,在反思步骤中产出最终的文档审查。
它产出什么
技术方面:README 文件、API 参考文档(OpenAPI、JSDoc、docstrings)、架构决策记录、changelog、迁移指南和故障排查文档。内容方面:有研究支撑的文章、操作指南,以及针对 Telegram、LinkedIn、Twitter/X 和 Facebook 的平台适配社交帖子。多语言输出——英语和俄语——是标准能力的一部分,而非特殊模式。
每种输出类型都有各自的约束。一条 Telegram 文本帖子在平台截断之前有约 4 000 个俄语字符的硬性上限。一段 API docstring 需要贴近它所描述的代码。Writer 在起草过程中就应用这些约束,而不是事后。
一个具体示例
以一个新增的认证端点为例。Writer 从同一来源产出三样东西:一段为阅读代码的开发者描述参数和返回值的 JSDoc 块;一段为从上一版本升级的团队说明变更内容的迁移指南章节;以及一条面向普通技术受众撰写的简短 Telegram 公告。三种受众,三种语体,一个任务。
强制执行的写作原则
该 agent 应用一套规则,以对抗常见的 AI 写作模式。每段一个观点。具体优于抽象——点名具体技术,引用实际数字。尽可能使用主动语态。不用填充短语。对于社交内容,还有一条额外规则:链接放入第一条评论,而非帖子正文,这是 Facebook、LinkedIn 和 Telegram 上的平台惯例,可保持正文可读。
它在流水线中的位置
Writer 运行在 Sonnet 级模型上——结构化程度足以产出有纪律的输出,速度也足以支持迭代起草。当草稿需要事实核查时,该 agent 加载 factcheck 技能。当输出有显得机械的风险时,humanize 技能提供针对具体应避免模式的参考。
完整能力列表见 Writer 参考卡片,或阅读Datarim 是什么以了解更宏观的图景。