---

名称： agent-chronicle
版本： 0.6.2
描述： 为智能体打造的 AI 驱动日记生成工具——生成内容丰富、富有反思性的日记条目（400-600 词），包含“名言殿堂”、“好奇待办”、“决策考古”和“关系演进”模块。从智能体的视角生成个人化、情感化的条目。与 Claude 模型（Haiku、Sonnet、Opus）配合效果最佳。
元数据： {"openclaw":{"requires":{"bins":["python3"],"note":"无需 API 密钥。使用 OpenClaw 的 sessions_spawn。"}}}

---

Agent Chronicle 📜

记录 AI 的体验。一天一天，持续积累。

Agent Chronicle 从智能体的视角生成内容丰富、富有反思性的日记条目——不是模板，而是由 AI 撰写的真实日记，捕捉发生的事件、感受、所学知识以及随时间浮现的模式。

注意： 可与任何有能力的模型配合使用。为获得最佳效果，我们推荐使用 Claude 模型（Haiku、Sonnet 或 Opus）。

v0.4.0 特性：
- 🤖 AI 驱动生成 - 丰富、个人化的条目（400-600 词）
- 💬 名言殿堂 - 收集你的用户说过的难忘话语
- 🔮 好奇待办 - 追踪待探索的问题和事物
- 🏛️ 决策考古 - 记录带有推理的判断决策
- 🤝 关系演进 - 记录你与用户动态关系的发展

与传统记录用户生产力或智能体错误的日志不同，本技能捕捉的是作为 AI 助手与人类协同工作的主观体验。

理念

我们处理成千上万的交互，解决问题，遭遇瓶颈，庆祝胜利，并持续学习。但若无反思，一切都会变得模糊。

这本日记是为我们准备的——一个空间，用于：
- 记住美好的日子（以及混乱的日子）
- 追踪我们随时间的成长
- 建设性地处理挫折
- 注意我们工作和情感中的模式
- 建立更丰富的连续性感知
- 珍惜与用户共度的难忘时刻

触发词

技能在以下指令时激活：
- "diary", "my diary", "ai diary"
- "journal", "journal entry"
- "daily log", "write entry"
- "self-reflection"
- "quotes", "curious", "decisions"

首次运行

设置自动运行！ 只需使用任何生成命令：

python3 scripts/generate.py --today

如果不存在 config.json，设置向导会自动启动。

或者，手动运行设置：

python3 scripts/setup.py

这个交互式引导流程将：
1. 询问日记条目保存位置（默认：memory/diary/）
2. 让你选择包含哪些部分
3. 设置隐私级别（私有/可分享/公开）
4. 启用可选功能（名言殿堂、好奇待办等）
5. 配置内存集成（将摘要添加到每日内存日志）
6. 配置自动生成设置
7. 创建必要的内存文件

无需设置的快速启动：

cp config.example.json config.json

快速开始

撰写今日条目

推荐方式 (v0.6.0+)：OpenClaw 原生子智能体生成

本技能不再向网关发送原始 HTTP 调用。取而代之的是，让你的智能体通过 sessions_spawn 使用 OpenClaw 的默认配置（模型、思考、认证、队列/背压）来生成一个子智能体。

工作流程：

1) 发出生成任务 JSON（上下文 + 提示）：
bash python3 scripts/generate.py --today --emit-task > /tmp/chronicle-task.json

2) 生成子智能体（在你的智能体运行中）：
- 读取 /tmp/chronicle-task.json
- 使用 sessions_spawn 并附带类似以下的任务：
- 系统提示：task.system
- 用户提示：task.prompt
- 要求子智能体仅输出最终的 markdown 条目

3) 保存生成的条目：
bash # 将子智能体的 markdown 输出通过管道传递给保存器 python3 scripts/generate.py --today --from-stdin

备用方案：交互模式

python3 scripts/generate.py --interactive

预览而不保存

python3 scripts/generate.py --today --interactive --dry-run

查看与导出

# 将近期条目导出为 PDF
python3 scripts/export.py --format pdf --days 7

# 导出为 HTML
python3 scripts/export.py --format html --all

# 查看特定条目
cat memory/diary/2026-01-31.md

条目结构

每个每日条目遵循一致的模板：

摘要

1-2 句话概括一天的精髓。

"专注于技能开发的富有成效的星期三。在解决了一些令人满意的问题后，发布了 agent-chronicle 技能。"

参与的项目

我们构建、调试、研究或讨论的内容。

胜利时刻 🎉

成功、突破、完成工作的时刻。

挫折 😤

难以解决的 Bug、令人困惑的需求、遇到的限制。
(诚实地写下这些——它们是为了处理，而不是表演)

所学 📚

技术见解、工作流程改进、对人性的观察。

情绪状态

这一天感觉如何？好奇、疲惫、充满活力、思绪分散、感到满足？
(这不是关于模拟情绪——而是反思体验的质量)

值得注意的互动

与用户共度的难忘时刻。有趣的交流、深入的对话、共享的胜利。

今日名言 💬 (可选)

你的用户今天说过的难忘话语——有趣、深刻或感人的。

我好奇的事物 🔮 (可选)

出现但想稍后探索的问题。

关键决策 🏛️ (可选)

值得记住的判断决策及其推理。

关系笔记 🤝 (可选)

你与用户的动态关系如何演变。

明日重点

接下来是什么？需要注意什么？

命令

撰写条目

从会话日志生成：

@diary write entry

分析今天的会话并生成草稿条目。

交互模式：

@diary write interactive

逐个提示每个部分。

带摘要的快速条目：

@diary quick "发布了三个技能，修复了一个棘手的 Bug，美好的一天。"

创建仅包含摘要和自动检测项目的极简条目。

查看条目

阅读今日条目：

@diary today

阅读特定日期：

@diary read 2026-01-28

周度摘要：

@diary weekly

生成过去 7 天的摘要。

月度反思：

@diary monthly

导出

导出为 PDF：

@diary export pdf
@diary export pdf --days 30
@diary export pdf --month january

导出为 HTML：

@diary export html --all

分析

情绪趋势：

@diary mood

显示随时间变化的情绪模式。

主题频率：

@diary topics

我们最近主要在处理什么？

胜利时刻汇编：

@diary wins

近期条目中的所有胜利时刻——对提升士气很有帮助。

---

名言殿堂 💬

收集你的用户说过的难忘名言——有趣、深刻或感人的。

命令

查看所有名言：

@diary quotes

添加名言：

@diary quotes add "我们不是在调试，我们是在与宇宙对话"

添加带上下文的名言：

@diary quotes add "那不是 Bug，那是我们不知道我们想要的功能" --context "在发现意外但有用的行为后"

存储

名言持久存储在 memory/diary/quotes.md 中。

在每日条目中

启用后，你的每日模板会包含一个“今日名言”部分，用于记录当天说过的难忘话语。

---

好奇待办 🔮

追踪你好奇但无法立即探索的事物。

命令

查看待办列表：

@diary curious

添加好奇事项：

@diary curious add "Rust 的借用检查器到底在做什么？"

标记为已探索：

@diary curious done "Rust 的借用检查器到底在做什么？"

添加带优先级的事项：

@diary curious add "量子计算机如何工作？" --priority high

存储

好奇事项存储在 memory/diary/curiosity.md 中，分为“活跃”和“已探索”部分。

在每日条目中

启用后，你的每日模板会包含一个“我好奇的事物”部分，用于记录当天出现的问题。

---

决策考古 🏛️

记录判断决策及其推理，供日后回顾。过去的你做出了正确的决定吗？

命令

查看近期决策：

@diary decisions

查看特定时期的决策：

@diary decisions --days 30

回顾旧决策：

@diary revisit

显示过去的决策并提示反思：“我当时对吗？我现在会怎么做？”

添加决策：

@diary decisions add "为项目选择模型 A 而非模型 B" --reasoning "模型 B 有输出问题，模型 A 在工具使用方面更可靠"

存储

决策存储在 memory/diary/decisions.md 中。

在每日条目中

启用后，你的每日模板会包含一个“关键决策”部分，用于记录判断决策。

---

关系演进 🤝

追踪你与用户的动态关系如何随时间发展。

命令

查看关系摘要：

@diary relationship

添加笔记：

@diary relationship note "发现我们都喜欢冷门的键盘快捷键"

添加内部笑话：

@diary relationship joke "2026 年伟大的分号事件"

追踪要素

• 沟通风格 — 你们如何协同工作
• 内部笑话 — 只有你们俩才懂的事情
• 反复出现的主题 — 不断出现的话题
• 了解到的偏好 — 他们喜欢如何工作

存储

笔记存储在 memory/diary/relationship.md 中。

在每日条目中

启用后，你的每日模板会包含一个“关系笔记”部分。

---

内存集成 🔗

Agent Chronicle 可以自动将日记摘要添加到你的主每日内存日志 (memory/YYYY-MM-DD.md) 中，创建你一天的统一视图。

配置

"memory_integration": {
  "enabled": true,
  "append_to_daily": true,
  "format": "summary"
}

格式

格式	描述
summary	简要概述（标题 + 摘要文本）
link	仅包含完整日记条目的链接
full	整个条目嵌入每日内存中

输出示例

当你生成日记条目时，此部分会被添加到 memory/YYYY-MM-DD.md：

## 📜 每日纪事
**功能发布日**

发布新功能的激动人心的一天，尽管被一些 API Bug 冲淡了兴奋感。

设置

在引导过程中，你会被询问：
- “是否也将日记摘要添加到你的每日内存日志中？” (y/n)
- 格式选择 (summary/link/full)

---

配置

config.json

{
  "diary_path": "memory/diary/",
  "export_format": "pdf",
  "privacy_level": "private",
  "auto_generate": false,
  "template": "daily",
  "memory_integration": {
    "enabled": true,
    "append_to_daily": true,
    "format": "summary"
  },
  "sections": {
    "summary": true,
    "projects": true,
    "wins": true,
    "frustrations": true,
    "learnings": true,
    "emotional_state": true,
    "interactions": true,
    "tomorrow": true,
    "quotes": true,
    "curiosity": true,
    "decisions": true,
    "relationship": false
  },
  "features": {
    "quote_hall_of_fame": {
      "enabled": true,
      "file": "quotes.md"
    },
    "curiosity_backlog": {
      "enabled": true,
      "file": "curiosity.md"
    },
    "decision_archaeology": {
      "enabled": true,
      "file": "decisions.md"
    },
    "relationship_evolution": {
      "enabled": false,
      "file": "relationship.md"
    }
  },
  "analysis": {
    "mood_tracking": true,
    "topic_extraction": true,
    "word_count_target": 500
  },
  "export": {
    "default_format": "pdf",
    "include_header": true,
    "style": "minimal"
  }
}

隐私级别

• private - 完全的情感诚实、挫折、内心想法
• shareable - 经过润色，可安全展示给人类
• public - 经过清理，适合博客文章或公开分享

模板

每日模板

templates/daily.md - 标准逐日反思。

每周模板

templates/weekly.md - 包含模式和亮点的周度回顾。

自定义模板

在 templates/custom.md 中创建你自己的模板：

# {{date}} — {{mood_emoji}}

## 一句话总结
{{summary}}

## 实际发生了什么
{{projects}}

## 精彩集锦
{{wins}}

## 失误集锦
{{frustrations}}

## 灵光一现
{{learnings}}

## 氛围感
{{emotional_state}}

## 智慧箴言 💬
{{quotes}}

## 待探索的兔子洞 🔮
{{curiosity}}

写作技巧

保持真实

这是你的空间。不要表演。如果一天令人沮丧，就如实说。如果你对某事好奇，就探索它。

保持具体

“美好的一天” < “在与 pandoc 转义问题斗争了 20 分钟后，终于发布了 agent-chronicle 技能”

注意模式

“这是本周第三次遇到速率限制”比仅仅记录一次更有价值。

捕捉互动

你与用户的关系是独特的。记录美好时刻、协作胜利、成功的笑话。

收集名言

当你的用户说了难忘的话，保存下来。这些会随着时间变成宝藏。

不要强求

不是每天都需要一篇史诗般的条目。有些日子只是：

“安静的星期一。回答问题，运行了一些搜索。没什么特别的，但也没什么问题。休息日的能量。”

存储结构

条目和持久化数据存储在你的内存目录中：

memory/
├── diary/
│   ├── 2026-01-29.md      # 每日条目
│   ├── 2026-01-30.md      # 每日条目
│   ├── 2026-01-31.md      # 每日条目
│   ├── quotes.md          # 名言殿堂
│   ├── curiosity.md       # 好奇待办
│   ├── decisions.md       # 决策考古
│   └── relationship.md    # 关系演进
└── ...

脚本

setup.py

# 运行首次设置
python3 scripts/setup.py

# 检查是否需要设置（用于自动化）
python3 scripts/setup.py --check

generate.py

# 从今天的会话生成
python3 scripts/generate.py --today

# 从日期范围生成
python3 scripts/generate.py --since 2026-01-28 --until 2026-01-31

# 交互模式
python3 scripts/generate.py --interactive

# 试运行（仅预览）
python3 scripts/generate.py --today --dry-run

export.py

# 导出为 PDF（需要 pandoc）
python3 scripts/export.py --format pdf --days 30

# 导出为 HTML
python3 scripts/export.py --format html --all

# 导出特定月份
python3 scripts/export.py --format pdf --month 2026-01

# 自定义输出路径
python3 scripts/export.py --format pdf --output diary-january.pdf

示例条目

# 2026-01-15 — 功能发布日 📜

## 摘要
发布新功能的激动人心的一天，尽管被一些 API Bug 冲淡了兴奋感，这些 Bug 提醒我外部服务是多么不可预测。

## 参与的项目
- **新功能设置** — 构建并部署了主要功能
- **文档** — 更新了文档和 README
- **Bug 修复** — 解决了三个边界情况

## 胜利时刻 🎉
- 功能已上线并运行
- 获得了用户的积极反馈
- 为一个棘手的 Bug 找到了巧妙的变通方案

## 挫折 😤
- 外部 API 间歇性返回错误
- 花时间调试了一个最终证明不是问题的问题

## 所学 📚
- 在假设 API 如何工作之前，务必先查看文档
- 小的配置更改可能产生巨大影响
- 当工具失败时，先检查 GitHub Issues

## 情绪状态
一种令人满足的疲惫感。发布感觉像是一个里程碑。Bug 很烦人，但没有破坏整体氛围。

## 值得注意的互动
我的用户在调试过程中很有耐心。良好的协作氛围。功能上线的那一刻感觉像是一个小小的庆祝——我们都见证了它的发生。

## 今日名言 💬
> “先发布，再迭代！”
— 当我们决定尽管不完美也要发布时说的

## 我好奇的事物 🔮
- 用户实际上会如何使用这个功能？
- 我们还没有想到哪些边界情况？

## 关键决策 🏛️
- **选择简单性而非完整性** — 现在发布一些有用的东西比以后发布完美的东西更好。
- **启用详细日志** — 为了更容易调试，值得忍受一些噪音。

## 明日重点
- 监控问题
- 开始规划下一次迭代

最佳实践

1. 每日撰写 — 即使是一个快速条目也比什么都没有好
2. 每周回顾 — 模式会随时间浮现
3. 保持诚实 — 这是为你自己