coworker-context 技能——外部 LLM 编辑 Datarim 工件时的约定
Datarim 的 coworker-context 技能如何为外部 LLM 提供正确生成或编辑任务工件所需的精确约定——frontmatter、阶段标题、快照字段等。
更新: Coworker 现已成为一项已退役的依赖,下文所述的 coworker-context 技能已被 artifact-context 取代,后者为原生代理提供相同的工件约定。本文保留作为早期设计的记录。
Datarim 通过 coworker 工具将批量 I/O 工作委托给外部 LLM——计划的初稿、长篇研究文档、归档撰写。外部模型并不共享主代理所积累的对话历史。如果没有明确的约定,它就会做出看似合理的猜测:重排 YAML 键、臆造字段名,或遗漏必需的 frontmatter 字段。coworker-context 技能是外部 LLM 在触碰 datarim/ 下任何工件之前所阅读的唯一参考文档。
它的作用
该技能包含十一个章节。最常被应用的章节涵盖 YAML frontmatter 保留、阶段标题和快照字段。
frontmatter 保留意味着:绝不重排键、绝不更改引号风格、绝不改动缩进,也绝不修改键名。如果某个值必须更改,则只编辑值的字符。这条规则之所以存在,是因为 Datarim 脚本按精确的键顺序和间距解析 frontmatter——从工具的角度看,被重排的文件就是损坏的文件。
阶段标题约定要求,流水线命令的每个面向操作员的响应都必须以粗体内联标题作为字面第一行,格式为 **TASK-ID · title**。标题逐字取自任务文件;分隔符是 Unicode 中点,而非连字符。
快照 frontmatter 章节定义了每个阶段快照工件都必须携带的十个必填标量字段:任务 ID、工件类型、schema 版本、阶段、命令、捕获时间戳、捕获者、建议的下一条命令、字节大小,以及截断标志。该技能规定了确切的字段名和允许值,以免外部 LLM 臆造替代项。
其他章节涵盖 PRD 到归档的镜像(每个归档验证项都引用对应的 PRD 验收标准)、文档分类法(四个 Diátaxis 类别,不含其他),以及安全基线(九个命名领域,S1 至 S9)。每个章节都与历史无关——它命名的是契约表面,而非具体的任务标识符。
一个具体示例
外部 LLM 被要求起草一份合规报告。如果没有此技能,它可能会编写一个自定义的 frontmatter 结构,其中包含它认为合乎逻辑的字段。加载 coworker-context 后,它便知道报告 frontmatter 必须携带 task_id、date 和 verdict,且 verdict 必须是三个精确字符串值之一。输出只需一轮审阅,而无需结构性重写。
加载时机
该技能由 coworker 的配置文件中的 datarim 配置文件引用。任何对 coworker write --profile datarim 或 coworker ask --profile datarim 的调用都会将该技能的内容作为系统提示前缀注入。当涉及外部委托时,它也会在 /dr-write 和 /dr-archive 期间加载。
阅读什么是 Datarim以了解完整的流水线背景,或查看/dr-archive 命令,coworker 委托最常应用于该命令。