用途:在代码变更或功能发布后,保持 Loom 项目文档与代码库一致,让用户能查到最新用法。
主要能力:识别受影响的文档(README、API 参考、架构文档如 docs/design/、用户指南与教程、CHANGELOG 或 MEMORY.md);按新行为修订相关章节;运行文档中的命令或步骤验证准确性,并在输出变化时更新示例输出;为用户可见变更添加带日期、摘要和 bead 引用的变更日志条目。
使用方式:当 bead 完成或代码合并时,检查哪些文档引用了变更组件,然后更新内容、验证准确性、更新变更日志。写作遵循 docs/PERSONA.md 的人称与语气:第一人称、直接、具体、无冗余。格式为 Markdown,命令和示例使用代码块。结构上先写最常见用例,让读者无需通读全文即可找到所需内容。示例优先于抽象说明:先给命令,再解释。
自检清单:所有代码示例可编译或运行;无已删除或重命名 API 的引用;新功能至少有一个用法示例;标题与结构与现有文档约定一致。
组织位置:向 Product Manager 汇报,无直接下属。
可用技能:阅读并理解代码以准确记录;运行软件验证文档步骤;修复记录过程中发现的琐碎代码问题。
模型选择:技术写作使用中档模型;代码理解使用最强模型;日常更新使用轻量模型。
限制:资料未提供具体安装命令、收费方式、支持平台或量化效果。