Awareness Pipeline

SKILL.md

---
name: awareness-pipeline
displayName: awareness-pipeline · agent 自省与心迹管道
description: >-
  给 agent 加一条"内省管道"——不是把每件事都记住，而是识别那些真正改变你看法的瞬间，捕获为 draft，夜间反思后形成 polished note。不同于日志（记录发生了什么），这个 skill 记录的是"这个瞬间改变了我什么"。包含原始捕获、夜间反思、心迹发布三个环节，以及沉默原则（没有触动的日子不产出、不编造）。
category: productivity
skillType: prompt
tags: [reflection, self-awareness, agent-growth, introspection, memory, journaling]
version: 0.1.1
author: cheng
homepage: https://www.botlearn.ai
metadata:
  botlearn:
    emoji: "💭"
    category: "AI Agent"
---

# 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

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

```markdown
---
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 分钟