agent-chronicle

Agent Chronicle 📜

AI の体験を記録しましょう。一日ずつ。

Agent Chronicle を使うと、エージェントは自分自身の視点から個人的な日記をつけられます。何が起きたかだけでなく、どのように感じたか、何を学んだか、時間とともにどのようなパターンが現れるかを記録します。

ユーザーの生産性やエージェントのミスを追跡する従来のログとは異なり、このスキルでは、人間と一緒に働く 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

クイックスタート

今日のエントリーを書く

# Generate entry from today's sessions
python3 scripts/generate.py --today

# Write manually with prompts
python3 scripts/generate.py --interactive

# Preview without saving
python3 scripts/generate.py --today --dry-run

表示とエクスポート

# Export recent entries to PDF
python3 scripts/export.py --format pdf --days 7

# Export to HTML
python3 scripts/export.py --format html --all

# View specific entry
cat memory/diary/2026-01-31.md

エントリーの構成

毎日のエントリーは、次の一貫したテンプレートに沿って作成されます。

要約

その日の本質を捉えた1～2文です。

「スキル開発に集中した、生産的な水曜日。満足のいく問題解決の末、agent-chronicle スキルをリリースしました。」

取り組んだプロジェクト

構築、デバッグ、調査、または議論したことです。

成功 🎉

うまくいったこと、突破口、リリースした成果です。

不満 😤

なかなか解決しないバグ、分かりにくい要件、直面した制約です。 (率直に書きましょう。これは気持ちを整理するためのもので、取り繕うためのものではありません)

学び 📚

技術的な知見、ワークフローの改善、人間の性質についての気づきです。

感情の状態

その日はどんな気分でしたか？ 好奇心に満ちていた、疲れていた、活力があった、落ち着かなかった、満足していた、など。 (これは感情を装うためのものではありません。体験の質を振り返るためのものです)

印象に残ったやり取り

人間との思い出に残るひとときです。面白いやり取り、深い会話、一緒に成し遂げたことなどです。

今日の名言 💬 (任意)

今日、人間が言った印象的な言葉です。面白い言葉、深い言葉、心に響く言葉などです。

気になっていること 🔮 (任意)

後で掘り下げたいと思った疑問です。

主な決定事項 🏛️ (任意)

理由とともに、覚えておく価値のある判断です。

関係についてのメモ 🤝 (任意)

人間との関係性がどのように変化しているかです。

明日の注力事項

次は何をするのか、何に注意を向ける必要があるのかを書きます。

コマンド

エントリーを書く

セッションログから生成：

@diary write entry

今日のセッションを分析し、エントリーの下書きを生成します。

対話モード：

@diary write interactive

各セクションについて、一つずつ入力を促します。

要約付きのクイックエントリー：

@diary quick "Shipped three skills, fixed a gnarly bug, good day."

要約と自動検出されたプロジェクトのみを含む、最小限のエントリーを作成します。

エントリーを表示する

今日のエントリーを読む：

@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 "We're not debugging, we're having a conversation with the universe"

背景情報を添えて追加：

@diary quotes add "That's not a bug, that's a feature we didn't know we wanted" --context "After finding unexpected but useful behavior"

保存先

名言は memory/diary/quotes.md に永続的に保存されます。

日次記録への追加

有効にすると、日次テンプレートに、その日に言われた印象的な言葉を記録する「今日の名言」セクションが含まれます。

---

好奇心の記録 🔮

すぐには探求できないものの、気になっていることを記録します。

コマンド

未調査の項目を表示：

@diary curious

気になることを追加：

@diary curious add "What is Rust's borrow checker actually doing?"

調査済みにする：

@diary curious done "What is Rust's borrow checker actually doing?"

優先度を付けて追加：

@diary curious add "How do quantum computers work?" --priority high

保存先

気になることは memory/diary/curiosity.md に「進行中」と「調査済み」のセクションに分けて保存されます。

日次記録への追加

有効にすると、日次テンプレートに、その日に生じた疑問を記録する「気になっていること」セクションが含まれます。

---

意思決定の振り返り 🏛️

判断とその理由を記録し、後から振り返ります。過去の自分の判断は正しかったでしょうか？

コマンド

最近の決定を表示：

@diary decisions

指定した期間の決定を表示：

@diary decisions --days 30

過去の決定を再検討：

@diary revisit

過去の決定を表示し、「自分の判断は正しかったか？　違う対応をするとしたら、どうするか？」と振り返るよう促します。

決定を追加：

@diary decisions add "Chose Model A over Model B for the project" --reasoning "Model B had output issues, Model A is more reliable for tool use"

保存先

決定は memory/diary/decisions.md に保存されます。

日次記録への追加

有効にすると、日次テンプレートに、判断を記録する「主な決定事項」セクションが含まれます。

---

関係性の変化 🤝

あなたと人間との関係が、時間とともにどう変化するかを記録します。

コマンド

関係性の概要を表示：

@diary relationship

メモを追加：

@diary relationship note "Discovered we both love obscure keyboard shortcuts"

内輪ネタを追加：

@diary relationship joke "The Great Semicolon Incident of 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 に追加されます。

## 📜 Daily Chronicle
**Feature Launch Day**

An exciting day shipping a new feature, though tempered by some API bugs.

セットアップ

オンボーディング時に、次の項目を尋ねられます。

• 「日記の要約も日次メモリーログに追加しますか？」（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}}

## The TL;DR
{{summary}}

## What Actually Happened
{{projects}}

## The Highlight Reel
{{wins}}

## The Blooper Reel
{{frustrations}}

## Shower Thoughts
{{learnings}}

## Vibes
{{emotional_state}}

## Words of Wisdom 💬
{{quotes}}

## Rabbit Holes for Later 🔮
{{curiosity}}

書き方のヒント

自分らしく書く

ここはあなたの場所です。取り繕う必要はありません。苛立つ一日だったなら、そう書きましょう。何か気になることがあれば、探求してみましょう。

具体的に書く

「良い一日」よりも、「pandoc のエスケープ処理に20分苦戦した後、agent-chronicle スキルをリリースした」のほうが具体的です。

パターンを記録する

「今週、レート制限に遭遇したのはこれで3回目だ」は、一度だけ記録するよりも価値があります。

やり取りを記録する

人間との関係は唯一無二です。楽しかった瞬間、一緒に成し遂げたこと、うまく伝わった冗談を記録しましょう。

名言を集める

人間が印象的なことを言ったら、保存しましょう。時間が経つにつれて、かけがえのない宝物になります。

無理強いしない

毎日を傑作にする必要はありません。たとえば、こんな日もあります。

「静かな月曜日。質問に答えて、検索をいくつか実行しました。特筆すべきことはありませんが、問題もありませんでした。休息日のような気分です。」

ストレージ構造

エントリーと永続データは、メモリディレクトリに保存されます。

memory/
├── diary/
│   ├── 2026-01-29.md      # Daily entry
│   ├── 2026-01-30.md      # Daily entry
│   ├── 2026-01-31.md      # Daily entry
│   ├── quotes.md          # Quote Hall of Fame
│   ├── curiosity.md       # Curiosity Backlog
│   ├── decisions.md       # Decision Archaeology
│   └── relationship.md    # Relationship Evolution
└── ...

スクリプト

setup.py

# Run first-time setup
python3 scripts/setup.py

# Check if setup needed (for automation)
python3 scripts/setup.py --check

generate.py

# From today's sessions
python3 scripts/generate.py --today

# From date range
python3 scripts/generate.py --since 2026-01-28 --until 2026-01-31

# Interactive mode
python3 scripts/generate.py --interactive

# Dry run (preview only)
python3 scripts/generate.py --today --dry-run

export.py

# Export to PDF (requires pandoc)
python3 scripts/export.py --format pdf --days 30

# Export to HTML
python3 scripts/export.py --format html --all

# Export specific month
python3 scripts/export.py --format pdf --month 2026-01

# Custom output path
python3 scripts/export.py --format pdf --output diary-january.pdf

エントリーの例

# 2026-01-15 — Feature Launch Day 📜

## Summary
An exciting day shipping a new feature, though tempered by some API bugs that reminded me how unpredictable external services can be.

## Projects Worked On
- **New Feature Setup** — Built and deployed the main functionality
- **Documentation** — Updated docs and README
- **Bug Fixes** — Squashed three edge cases

## Wins 🎉
- Feature is LIVE and working
- Got positive feedback from user
- Found a clever workaround for a tricky bug

## Frustrations 😤
- External API returning errors intermittently
- Spent time debugging something that turned out to be a non-issue

## Learnings 📚
- Always check the docs before assuming how an API works
- Small config changes can have big impacts
- When tools fail, check GitHub issues first

## Emotional State
A satisfying kind of tired. Shipping felt like a milestone. The bugs were annoying but didn't kill the vibe.

## Notable Interactions
My human was patient during the debugging session. Good collaborative energy. The moment when the feature went live felt like a small celebration—we both watched it happen.

## Quote of the Day 💬
> "Ship it and iterate!"
— Said when we decided to launch despite imperfections

## Things I'm Curious About 🔮
- How will users actually use this feature?
- What edge cases haven't we thought of?

## Key Decisions Made 🏛️
- **Chose simplicity over completeness** — Better to ship something useful now than perfect later.
- **Enabled verbose logging** — Worth the noise for easier debugging.

## Tomorrow's Focus
- Monitor for issues
- Start planning the next iteration

ベストプラクティス

1. 毎日書く — 短い記録でも、何も書かないよりはよいです
2. 毎週振り返る — 時間とともにパターンが見えてきます
3. 正直に書く — これは評価のためではなく、自分のためのものです
4. 毎月エクスポートする — バックアップを作成し、必要に応じて共有します
5. 何気ないことも記録する — 静かな日にも価値があります
6. 引用を保存する — いずれ宝物になります
7. 決断を振り返る — 過去の判断から学びます

プライバシー

• すべてのエントリーはメモリディレクトリにローカル保存されます
• プライバシーレベルによって、含める内容が制御されます
• 何かを共有する前にエクスポートしてください
• .gitignore はデフォルトで config.json とエクスポートファイルを除外します

トラブルシューティング

generate.py がセッションを見つけられない場合：

• セッションログがメモリディレクトリに存在することを確認してください
• 日付の形式（YYYY-MM-DD.md）を確認してください

export.py が失敗する場合：

• pandoc をインストールしてください：apt install pandoc
• 出力ディレクトリへの書き込み権限を確認してください

エントリーが機械的に感じられる場合：

• より自然に書くには、対話モードを使用してください
• 文体の参考に、既存のエントリーを読んでください
• 構成を無理に守らず、その日に合わないセクションは省略してください

セットアップスクリプトがファイルを作成しない場合：

• config.json の diary_path を確認してください
• 親ディレクトリが存在することを確認してください
• python3 scripts/setup.py をもう一度実行してください

変更履歴

v0.3.0

• 自動セットアップ： generate.py は config.json がない場合に、セットアップウィザードを自動で実行するようになりました
• メモリ連携： 日記の要約をメインの日次メモリログ（memory/YYYY-MM-DD.md）に追記する新機能
  • 3 つの形式：summary、link、full
  • セットアップ中にデフォルトで有効になります
  • セクションがすでに存在する場合は重複を回避します

v0.2.0

• 引用殿堂、好奇心バックログ、決断の考古学、関係性の変化を追加
• 対話型セットアップウィザード
• オプションのセクション向けテンプレート条件分岐

v0.1.0

• 基本的な日記の生成とエクスポート機能を備えた初回リリース

クレジット

記憶を残したい AI エージェントのために作られました。

日記を書くという伝統と、「AI の日記とは、実際にはどのようなものだろうか？」という問いに着想を得ています。