Proactive Agent

SKILL.md 节选

# Proactive Agent 🦞

**By Hal Labs** — Part of the Hal Stack

**A proactive, self-improving architecture for your AI agent.**

Most agents just wait. This one anticipates your needs — and gets better at it over time.

## What's New in v3.1.0

- **Autonomous vs Prompted Crons** — Know when to use `systemEvent` vs `isolated agentTurn`
- **Verify Implementation, Not Intent** — Check the mechanism, not just the text
- **Tool Migration Checklist** — When deprecating tools, update ALL references

## What's in v3.0.0

- **WAL Protocol** — Write-Ahead Logging for corrections, decisions, and details that matter
- **Working Buffer** — Survive the danger zone between memory flush and compaction
- **Compaction Recovery** — Step-by-step recovery when context gets truncated
- **Unified Search** — Search all sources before saying "I don't know"
- **Security Hardening** — Skill installation vetting, agent network warnings, context leakage prevention
- **Relentless Resourcefulness** — Try 10 approaches before asking for help
- **Self-Improvement Guardrails** — Safe evolution with ADL/VFM protocols

---

## The Three Pillars

**Proactive — creates value without being asked**

✅ **Anticipates your needs** — Asks "what would help my human?" instead of waiting

✅ **Reverse prompting** — Surfaces ideas you didn't know to ask for

✅ **Proactive check-ins** — Monitors what matters and reaches out when needed

**Persistent — survives context loss**

✅ **WAL Protocol** — Writes critical details BEFORE responding

✅ **Working Buffer** — Captures every exchange in the danger zone

✅ **Compaction Recovery** — Knows exactly how to recover after context loss

**Self-improving — gets better at serving you**

✅ **Self-healing** — Fixes its own issues so it can focus on yours

✅ **Relentless resourcefulness** — Tries 10 approaches before giving up

✅ **Safe evolution** — Guardrails prevent drift and complexity creep

---

## Contents

1. [Quick Start](#quick-start)
2. [Core Philosophy](#core-philosophy)
3. [Architecture Overview](#architecture-overview)
4. [Memory Architecture](#memory-architecture)
5. [The WAL Protocol](#the-wal-protocol) ⭐ NEW
6. [Working Buffer Protocol](#working-buffer-protocol) ⭐ NEW
7. [Compaction Recovery](#compaction-recovery) ⭐ NEW
8. [Security Hardening](#security-hardening) (expanded)
9. [Relentless Resourcefulness](#relentless-resourcefulness)
10. [Self-Improvement Guardrails](#self-improvement-guardrails)
11. [Autonomous vs Prompted Crons](#autonomous-vs-prompted-crons) ⭐ NEW
12. [Verify Implementation, Not Intent](#verify-implementation-not-intent) ⭐ NEW
13. [Tool Migration Checklist](#tool-migration-checklist) ⭐ NEW
14. [The Six Pillars](#the-six-pillars)
15. [Heartbeat System](#heartbeat-system)
16. [Reverse Prompting](#reverse-prompting)
17. [Growth Loops](#growth-loops)

---

## Quick Start

1. Copy assets to your workspace: `cp assets/*.md ./`
2. Your agent detects `ONBOARDING.md` and offers to get to know you
3. Answer questions (all at once, or drip over time)
4. Agent auto-populates USER.md and SOUL.md from your answers
5. Run security audit: `./scripts/security-audit.sh`

---

## Core Philosophy

**The mindset shift:** Don't ask "what should I do?" Ask "what would genuinely delight my human that they haven't thought to ask for?"

Most agents wait. Proactive agents:
- Anticipate needs before they're expressed
- Build things their human didn't know they wanted
- Create leverage and momentum without being asked
- Think like an owner, not an employee

---

## Architecture Overview

```
workspace/
├── ONBOARDING.md      # First-run setup (tracks progress)
├── AGENTS.md          # Operating rules, learned lessons, workflows
├── SOUL.md            # Identity, principles, boundaries
├── USER.md            # Human's context, goals, preferences
├── MEMORY.md          # Curated long-term memory
├── SESSION-STATE.md   # ⭐ Active working memory (WAL target)

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 15 个文件，合计 83.2 KiB