mcpField

self-reflection

github.com/hopykyエージェントワークフロー129 回インストール
リポジトリ

self-reflection について

self-reflectionは、エージェントが失敗や学び、改善点を記録して継続的に改善するためのスキルです。定期チェックで振り返りを促し、コマンドライン操作やOpenClawのheartbeatワークフローに対応します。

主な機能

  1. 01振り返りが必要か確認
  2. 02振り返り内容の記録と読み込み
  3. 03統計の表示とタイマーのリセット
  4. 04OpenClaw heartbeatとの連携

活用シーン

  1. 01エージェントの定期的な振り返り確認
  2. 02API呼び出しのエラーと学びの記録
  3. 03後続タスク前に最近の学びを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hopyky/self-reflection --skill self-reflection

インストール後、Claude Code で/self-reflectionを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
LICENSE
README.md
self-reflection.example.json
bin/
self-reflection

詳細

🪞 Self-Reflection

継続的な自己改善のためのスキルです。エージェントは、定期的にハートビートをトリガーとして振り返りを行い、時間の経過に伴う間違い、学んだこと、改善点を記録します。

クイックスタート

# Check if reflection is needed
self-reflection check

# Log a new reflection
self-reflection log "error-handling" "Forgot timeout on API call" "Always add timeout=30"

# Read recent lessons
self-reflection read

# View statistics
self-reflection stats

仕組み

Heartbeat (60m) → Agent reads HEARTBEAT.md → Runs self-reflection check
                                                      │
                                            ┌─────────┴─────────┐
                                            ▼                   ▼
                                           OK              ALERT
                                            │                   │
                                       Continue            Reflect
                                                               │
                                                     ┌─────────┴─────────┐
                                                     ▼                   ▼
                                                   read               log
                                              (past lessons)     (new insights)

コマンド

コマンド説明
check [--quiet]振り返りの実施時期かどうかを確認します（OK または ALERT）
log <tag> <miss> <fix>新しい振り返りを記録します
read [n]直近の n 件の振り返りを読み込みます（デフォルト：5）
stats振り返りの統計を表示します
resetタイマーをリセットします

OpenClaw との連携

~/.openclaw/openclaw.json でハートビートを有効にします：

{
  "agents": {
    "defaults": {
      "heartbeat": {
        "every": "60m",
        "activeHours": { "start": "08:00", "end": "22:00" }
      }
    }
  }
}

ワークスペースの HEARTBEAT.md に追加します：

## Self-Reflection Check (required)
Run `self-reflection check` at each heartbeat.
If ALERT: read past lessons, reflect, then log insights.

設定

~/.openclaw/self-reflection.json を作成します：

{
  "threshold_minutes": 60,
  "memory_file": "~/workspace/memory/self-review.md",
  "state_file": "~/.openclaw/self-review-state.json",
  "max_entries_context": 5
}

作者

hopyky によって作成されました

ライセンス

MIT

コメント

Markdown 対応