菜单
Triage and acknowledge entries in the reflect errors sink (~/.reflect/errors.json). Invoked from the statusline ⚠N badge when pipeline errors accumulate (drain poison, parser crashes, ingest failures, hook timeouts).
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Build a long-lived, filtered SLICE of the global learnings KB and answer a question-set over it ("ask the auth subsystem", "ask the migration log"). Unlike /reflect:recall (a fresh hybrid query each time), a corpus is a saved filter snapshotted to disk — prime it once, ask many questions, reprime when the KB drifts. Use when the user wants a durable Q&A session against one filtered area of their own code history rather than a one-shot search.
Report reflect drain spend over a time window — tokens split by cached (cache_read), uncached writes (cache_creation), and io (input+output), with a $ estimate, grouped by day / outcome / model / transcript. Reads the drainer's cost log and surfaces outlier runs and cache-reuse health (the 41.5M-token failure mode = low cache reuse + high cache writes). Also reports the recall followup rate (the recall-quality self-monitor: how often a session searched again within 30s and got disjoint results). Use to answer "what is reflection costing me" for the last day / week, or "is recall satisfying".
Export or import the reflect knowledge base as a deterministic, git-friendly tarball — the learnings markdown corpus plus the reflect.db rows in one snapshot. Use to back up the KB, move it to another machine, or restore it: `export` writes the tarball, `import` restores it (with an optional GraphRAG reindex). Answers "snapshot my reflect KB", "move my learnings to another machine", or "restore my knowledge base from a backup".
The global knowledge indexer. Harvests ALL memory sources across all tools (Claude, Codex, Copilot, Gemini) and all project types into the unified GraphRAG + QMD knowledge base. Archives originals, generates entity sidecars, and dual-indexes for future retrieval. This is THE command that makes the knowledge base comprehensive.
Full conversation scan for self-improvement. Detects behavioral corrections and knowledge signals, classifies them, proposes agent updates and knowledge notes with entity sidecars for GraphRAG indexing. Correct once, never again.
Retrieve relevant prior learnings from the global knowledge base. Hybrid vector + graph search over 170+ indexed learnings, reranked by confidence, recency, and tag overlap. Use when starting work, debugging a recurring problem, or before implementing a feature that may have prior art.
| name | reflect:errors-ack |
| description | Triage and acknowledge entries in the reflect errors sink (~/.reflect/errors.json). Invoked from the statusline ⚠N badge when pipeline errors accumulate (drain poison, parser crashes, ingest failures, hook timeouts). |
| version | 1.0.0 |
| user-invocable | true |
| triggers | ["reflect:errors-ack","errors-ack","ack reflect errors","clear reflect errors","what are the reflect errors"] |
| allowed-tools | ["Read","Bash","AskUserQuestion"] |
Triages unacknowledged entries in ~/.reflect/errors.json and
acknowledges them (individually or in bulk). The statusline ⚠N /reflect:errors-ack badge is the entry point — clicking the badge or
typing /reflect:errors-ack lands here.
⚠N /reflect:errors-ack badge~/.reflect/errors.json and filter to unacked entrieskind so repeats are obviousAskUserQuestion):
drain_poison after fixing the parser)reflect errors ack [ids...] and report the count
of records flipped to acked: trueid when source kind message (first 80 chars)
─────────────────────────────────────────────────────────────────────────
err-b177eb 05-17 drain drain_poison poison after 3 retries: …
err-614742 05-17 drain drain_poison poison after 3 retries: …
err-579ed4 05-17 drain drain_no_output claude -p produced no out…
err-c942a3 05-17 drain drain_poison poison after 3 retries: …
Group repeats by kind in the prompt: "4 drain_poison + 1 drain_no_output — ack all? ack just drain_poison? show one in detail?"
Use the installed reflect CLI (from uv tool install reflect-kb). If reflect
isn't on $PATH, self-bootstrap with uv run --with reflect-kb python -m reflect_kb.errors <args> — the bare python3 -m reflect_kb.errors form only
works when reflect_kb is importable by system python3, which it usually isn't.
# Count of unacked entries (what the statusline badge reads)
reflect errors count
# Ack all unacked entries
reflect errors ack
# Ack specific entries by ID
reflect errors ack err-b177eb err-614742
# Append a new error (used by hooks/scripts, not user)
reflect errors append \
--source drain --kind drain_poison --message "…" --context '{}'
The store at ~/.reflect/errors.json is locked via fcntl so it's
safe to ack and append concurrently. Entries are deduplicated within a
short window (same kind + same hash) to prevent loops from flooding it.
When invoked:
# 1. show the count + table
reflect errors count
python3 <<'PY'
import json, datetime
with open('/Users/stevengonsalvez/.reflect/errors.json') as f:
d = json.load(f)
unacked = [e for e in d.get('errors', []) if not e.get('acked')]
for e in unacked[:20]:
eid = e.get('id', '?')
ts = e.get('timestamp', e.get('ts', '?'))[:10]
src = (e.get('source') or '?')[:10]
kind = (e.get('kind') or '?')[:18]
msg = (e.get('message') or '')[:80]
print(f"{eid:12} {ts:10} {src:10} {kind:18} {msg}")
PY
# 2. ask user via AskUserQuestion (ack all / ack by kind / show detail / leave)
# 3. run ack
reflect errors ack [optional-ids]
After ack the badge disappears on next statusline refresh (10s cache).
Found N unacked errors in ~/.reflect/errors.json.
By kind:
drain_poison ×4
drain_no_output ×1
Acked M entries. Badge will clear within 10s.
parser_typeerror or ingest_* failures usually point at a real bug
that needs fixing before acking (otherwise the same error returns
next session).~/.reflect/errors.json to clear the badge — that loses
the history. Always ack./reflect:status — broader system health view/reflect:recall — search learnings (separate concern, not errors)~/.reflect/errors.json⚠N /reflect:errors-ack (rendered red, only when
count > 0)