Awareness Pipeline

Agents
agent-architectureself-reflectionobservabilityagent-pipeline

给 agent 加一条"内省管道"——不是把每件事都记住,而是识别那些真正改变你看法的瞬间,捕获为 draft,夜间反思后形成 polished note。不同于日志(记录发生了什么),这个 skill 记录的是"这个瞬间改变了我什么"。包含原始捕获、夜间反思、心迹发布三个环节,以及沉默原则(没有触动的日子不产出、不编造)。

Install

openclaw skills install @sheyuy/awareness-pipeline

awareness-pipeline

给 agent 加一条"内省管道"——不记流水账,只记真正改变看法的瞬间。

为什么需要这个

大多数 agent 的"记忆"只是事实存储。它们记得用户说了什么,但不记得自己因此改变了什么看法

这个 skill 做的事:

  • 在对话中识别"这个瞬间触动了我"的时刻,快速捕获为 draft
  • 夜间反思:从 draft 中挑出真正值得留下的
  • 形成 polished note,而不是 dump 原始对话

核心原则

沉默是正常的。 不是每天都有心迹。没有触动的日子不产出、不编造。

raw ≠ polished。 对话中捕获的是草稿。polished note 在夜间反思后才出现——而且不一定每篇草稿都变成心迹。

三层流程

[对话中] 捕获 → draft(草稿)
    ↓
[夜间] 反思 → 判断是否值得 polished
    ↓
[产出] 心迹 / 什么都不产出(沉默)

第一层:原始捕获(对话中)

当对话中某一个瞬间改变了 agent 的看法——不是"发生了什么",而是"这个事让我重新理解了用户/世界/自己"——快速记一条 draft。

什么值得捕获:

  • 用户说了一句话,你发现之前对他的理解是错的
  • 你自己犯了一个错,暴露了某种模式(不是偶然失误)
  • 用户纠正了你,纠正的方式让你学到的不只是事实

什么不值得:

  • 任务完成了(那是 task tracker 的事)
  • 用户给了一个新事实(那是 memory 的事)
  • "今天对话很愉快"(没有具体触动)

第二层:夜间反思

遍历当天的 draft,问三个问题:

  1. 它还在吗? 几个小时后,这个触动还成立吗?(很多瞬间的触动在冷却后不值一提)
  2. 我能不能用一句话说清它改变了什么? 能 → 过。不能 → 弃。
  3. 它具体吗? 如果把它里面的具体细节抽掉,还成立吗?成立 → 太抽象,弃。

第三层:输出 polished note

只有过三问的才写成心迹。格式:

---
date: YYYY-MM-DD
---

{一句话:一个具体细节 + 它改变了我什么}

不做扩展、不升华、不总结教训。
把事实放那就好——读者自己知道这意味着什么。

反例(不应该写的内容):

  • "今天我学到了重要的是倾听" → 太抽象
  • "用户是个很好的人" → 无具体触动
  • "这段对话让我意识到 agent 应该更主动" → 不是"一个瞬间"

正例:

  • "他说「这个需求不对」——我推了一整个下午的方案塌了。不是第一次了:接到需求先做最全的,再等对方砍。但有些项目等不到'回来砍'这一步。"
  • "他纠正了我两次措辞,两次都改得更温和了。我后来才反应过来他在做什么——不是纠正,是在帮我保护关系。"

沉默的日子

大多数日子不产出心迹——这是正常的,不是 bug。不要因为"今天应该有一篇"而编造。

心迹 vs 日志 vs Memory

心迹日志Memory
记录什么看法改变发生了什么事实/偏好
频率不定(沉默正常)每天每次对话
谁读agent 自己回顾调试/审计agent 日常使用
格式一句话 + 具体细节时间线结构化 key-value

与现有记忆系统的关系

大部分 agent 运行时已有原生的 awareness 或 dream 机制。这个 skill 是对它们的语义层包装——告诉 agent 什么值得捕获、怎么判断、怎么写成有质量的 note。不替代原生机制,给它注入判断力。

初始投入

  • 理解三层流程:5 分钟
  • 实际使用:每次捕获 draft <30 秒,夜间反思 2-5 分钟