Self-Reflection 技能：AI代理自我反思工具，用于错误追踪与持续改进 | OpenClaw 集成

self-reflection by hopyky/self-reflection

129 周安装量

1 GitHub Stars

GitHub

安装命令

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

自动化命令行工具生产力

🇨🇳中文介绍

🪞 自我反思

一个用于持续自我提升的技能。该代理通过定期心跳触发的反思，追踪错误、经验教训和随时间推移的改进。

快速开始

# 检查是否需要反思
self-reflection check

# 记录新的反思
self-reflection log "error-handling" "Forgot timeout on API call" "Always add timeout=30"

# 阅读近期经验教训
self-reflection read

# 查看统计信息
self-reflection stats

工作原理

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

命令

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

命令	描述
`check [--quiet]`	检查是否到了反思时间 (OK 或 ALERT)
`log <tag> <miss> <fix>`	记录一次新的反思
`read [n]`	阅读最近 n 条反思 (默认: 5)
`stats`	显示反思统计信息
`reset`	重置计时器

🇺🇸English

🪞 Self-Reflection

A skill for continuous self-improvement. The agent tracks mistakes, lessons learned, and improvements over time through regular heartbeat-triggered reflections.

Quick Start

# 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

How It Works

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

Commands

Command	Description
`check [--quiet]`	Check if reflection is due (OK or ALERT)
`log <tag> <miss> <fix>`	Log a new reflection
`read [n]`	Read last n reflections (default: 5)
`stats`	Show reflection statistics
`reset`	Reset the timer

OpenClaw Integration

Enable heartbeat in ~/.openclaw/openclaw.json:

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

Add to your workspace HEARTBEAT.md:

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

Configuration

Create ~/.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
}

Author

Created by hopyky

License

MIT

Weekly Installs

129

Repository

hopyky/self-reflection

GitHub Stars

First Seen

Jan 30, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

openclaw111

opencode104

gemini-cli97

codex97

cursor94

github-copilot91