human-summary 技能 — 面向操作员的通俗语言摘要
human-summary 技能如何在 /dr-qa、/dr-compliance 和 /dr-archive 末尾追加一个四段式通俗语言摘要,让操作员无需打开任何文件即可快速了解情况。
在质量检查或归档运行结束时,技术输出回答了许多问题——但没有回答人类操作员真正想知道的四个问题:做了什么、什么成功了、什么失败了、接下来是什么。human-summary 技能每次都会添加一个简短的通俗语言部分,恰好回答这四个问题。
该部分位于技术块和响应底部的 CTA 菜单之间。它不替代技术输出——它是为不想解析判定表的人类读者提供的补充层。
四个子部分
结构是固定且穷尽的。该部分始终按顺序包含四个子标题:做了什么、什么成功了、什么没有成功或仍未解决、接下来是什么。添加第五个子部分属于阻断性发现。删除四个中的任何一个也属于阻断性发现——空的子部分必须输出一行占位符,而不是消失。
部分标题后的第一行是自我标识:任务 ID 和标题。该标识存在是因为摘要也会脱离上下文被阅读——操作员回翻聊天记录时,会看到一个已完成的摘要而没有周围的响应,如果没有该标识,就无法知道它属于哪个任务。
通俗语言强制
该技能通过三层强制通俗语言。第一层是禁用词列表:一个 ASCII 令牌文件——DevOps 动词、CI/CD 名词、Git 术语、测试词汇——这些不得出现在摘要的俄语行文中。对于每个被禁用的令牌,都存在自然的俄语对应词。普遍接受的缩写白名单(如 JSON 或 HTTP)会首先被查询,因此常见技术协议名称始终允许。
第三层是逐段逃生通道。逐字块——日志行、命令输出、代码片段——可以包裹在显式围栏中,以豁免禁用词列表。该围栏用于引用的技术内容,而非叙述性行文。每份摘要最多可围栏两个段落;第三个触发警告,第五个完全阻断摘要。
运行位置
该技能由三个流水线命令加载。/dr-qa 在 QA 报告之后运行它,针对每个总体判定。/dr-compliance 在逐步合规报告之后运行它。/dr-archive 在活动上下文更新之后运行它。在所有三种情况下,摘要的来源是刚生成的产物——QA 报告、合规报告或归档文档——因此通俗语言部分反映该次运行的实际结果,而非缓存状态。
总长度预算为所有四个子部分合计 150 到 400 词。如果源材料更大,该技能会积极压缩。目标是快速阅读,而非忠实索引。
阅读什么是 Datarim以了解更广泛的背景,或查看关于init-task-persistence的相关文章,了解操作员意图如何从流水线开始就被捕获。