Hui-Yi

SKILL.md

---
name: hui-yi
description: >
  Trigger for cold-memory recall and archive work under memory/cold/. Use for older
  low-frequency context, historical continuity, resurfacing, cooling, rebuild, and
  repetition-driven reinforcement. Do not use for fresh daily notes, stable high-frequency
  facts, tooling/setup notes, or unvalidated new learnings.
---

# Hui Yi

Hui Yi manages the cold reinforcement layer under `memory/cold/`.

Core rule:

**Repeatedly reactivated information deserves reinforcement first. Ebbinghaus sets the pace, not the sole trigger.**

## Use Hui Yi when

- older low-frequency context would materially improve the current answer
- the user asks what was done before, asks to recall/archive something, or wants historical continuity
- a reusable lesson, decision, troubleshooting result, or stable background note should be preserved in `memory/cold/`
- durable content from daily notes should be cooled into cold memory
- cold-memory notes, metadata, or retrieval quality need maintenance

## Do not use Hui Yi when

- the content is today's transient note → `memory/YYYY-MM-DD.md`
- the content is a stable high-frequency fact → `MEMORY.md`
- the content is tooling, machine path, or environment setup → `TOOLS.md`
- the content is a fresh mistake or still-unvalidated lesson → `.learnings/`
- the content contains secrets, tokens, or passwords

## Boundary

OpenClaw primary memory handles:
- current chat continuity
- recent daily notes
- stable high-frequency facts
- tooling and environment notes
- fresh learnings

Hui Yi handles:
- low-frequency, high-value knowledge under `memory/cold/`
- historical context that keeps resurfacing across real conversations
- durable experience, decisions, and troubleshooting notes that should not pollute primary memory

## Files and scripts

Cold-memory area:
- `memory/cold/index.md`
- `memory/cold/tags.json`
- `memory/cold/retrieval-log.md`
- `memory/cold/_template.md`
- `memory/cold/schedule.json`
- `memory/heartbeat-state.json`

CLI entry scripts:
- `scripts/create.py`
- `scripts/validate.py`
- `scripts/search.py`
- `scripts/rebuild.py`
- `scripts/decay.py`
- `scripts/cool.py`
- `scripts/review.py`
- `scripts/scheduler.py`
- `scripts/install_hook.py`
- `scripts/smoke_test.py`
- `scripts/scrub_metadata.py`

Core modules:
- `core/signal_detect.py`
- `core/signal_pipeline.py`
- `core/openclaw_signal_hook.py`
- `core/openclaw_runtime_probe.py`

## Sanity check

```bash
python3 scripts/smoke_test.py
```