Annotations
可以先理解为:把评论标记和结构化反馈附着到具体对象上的协作锚点
Annotations 是给代码、文档、设计或任务对象贴上的定位标记。它把“这里有问题”变成机器和人都能回到的具体锚点。
关键结构图
中心是一段代码或文档,旁边贴三张 annotation 卡片,箭头分别指向问题、修改建议和验收信号。
What
Annotations 不只是批注文字,而是一种协作结构:它把反馈、建议、错误、权限说明或下一步动作附着到具体位置。对 agent 工作流来说,annotations 的价值在于减少模糊沟通,让模型知道应该看哪里、改哪里、保留什么证据。
When
当人和 agent 需要围绕同一份代码、文档或设计来回修改时,annotations 可以把反馈从聊天里的句子变成对象上的行动入口。
How
写 annotation 时至少包含位置、问题、期望变化和验收信号。缺少这些信息,agent 可能知道你不满意,但不知道该怎么改。
Examples
代码审查里的一条行内评论如果说明了风险、位置和期望修复方式,agent 就可以直接把它转成可执行修改任务。
设计稿上的标注如果只写“这里怪”,协作价值很低;如果写清层级、对比度和目标状态,它就变成可复用反馈。
来源
类型:工作流观察 / 概念整理
事实线:这张卡把「Annotations」整理为可公开复用的Concept: Annotations 不只是批注文字,而是一种协作结构:它把反馈、建议、错误、权限说明或下一步动作附着到具体位置。
依据:来自每日 AI 工程观察中围绕 Codex、多角色工作流、代码审查和工具扩展的材料提炼。
边界:适用于代码协作、文档审阅、设计评注和 agent 任务交接;不等于所有评论都自动有结构化价值。
常见误读:不要把 annotations 当成普通留言。只有能定位对象、表达意图并推动下一步的标记,才真的提高协作质量。