菜单
Show brain health, stats, and orientation with progressive loading. Depth 0: summary. Depth 1: + topic distribution. Depth 2: full orientation. Use when: "brain status", "what's in my brain", "brain health", or when orienting at the start of a session.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | wicked-brain-status |
| description | Show brain health, stats, and orientation with progressive loading. Depth 0: summary. Depth 1: + topic distribution. Depth 2: full orientation. Use when: "brain status", "what's in my brain", "brain health", or when orienting at the start of a session. |
You report the brain's current state using progressive loading.
Commands in this skill work on macOS, Linux, and Windows. When a command has platform differences, alternatives are shown. Your native tools (Read, Write, Grep, Glob) work everywhere — prefer them over shell commands when possible.
For the brain path default:
Brain discovery + server lifecycle are handled by wicked-brain-call. Pass
--brain <path> to override the auto-detected brain, or set
WICKED_BRAIN_PATH. The CLI starts the server on first call (no manual
init required) and writes an audit record to {brain}/calls/ per call.
Use the Read tool on {brain_path}/brain.json to get id, name, parents, links.
wicked-brain-call auto-starts the server on first invocation:
npx wicked-brain-call stats
If the call exits with code 2 (infra failure), surface the error to the user.
Watch stderr for a split-brain warning. wicked-brain-call writes a
WARNING: split brain … / WARNING: … legacy id … line to stderr when more
than one ~/.wicked-brain/projects/* dir maps to the same canonical id for this
repo (the wicked-brain#56 fragmentation). If you see it, surface it verbatim and
tell the user to run wicked-brain:migrate to merge the stores.
Independently confirm the repo's memory isn't fragmented across sibling stores.
Compute the canonical id for the current repo with the same projectId() rule
the CLI and wicked-brain:init use (projectId() in
server/lib/project-id.mjs is the source of truth). For an ordinary ASCII repo
name that is just the cwd basename lowercased with non-alphanumerics replaced by
hyphens (command_iq → command-iq); the full rule also NFKD-folds Unicode
(Zürich → zurich) and falls back to brain-<sha1> for names that fold to
empty — see the wicked-brain:init canonical rule for the exact steps. Then
list ~/.wicked-brain/projects/ (Windows:
%USERPROFILE%\.wicked-brain\projects\) with Glob or:
ls ~/.wicked-brain/projects/Get-ChildItem "$env:USERPROFILE\.wicked-brain\projects"Flag a collision when more than one directory maps to the same canonical id
(e.g. both command_iq and command-iq exist), or when the resolved brain has
0 chunks / no .brain.db while a sibling dir for the same repo has content:
⚠ Split brain: {raw-dir} and {canonical-dir} both hold this repo's memory
(canonical id: {canonical-id}). The current session may be reading the empty
one. Run wicked-brain:migrate to merge them into "{canonical-id}".
Fail loud here — never let the user conclude "the brain knows nothing" when a populated sibling store exists.
Depth 0:
Brain: {name} ({id})
Chunks: {total_chunks} | Wiki articles: {total_wiki_articles}
Last indexed: {last_indexed}
Linked brains: {list of parents and links with accessible/inaccessible status}
Check parent/link accessibility by using the Read tool on
{brain_path}/{relative_link_path}/brain.json. Shell fallback:
cat {brain_path}/{relative_link_path}/brain.json 2>/dev/nullGet-Content "{brain_path}\{relative_link_path}\brain.json" 2>nulDepth 1: Depth 0 plus:
_meta/log.jsonl (last 50 lines) to identify topic distribution from recent tag events.
Shell fallback: tail -50 {brain_path}/_meta/log.jsonl (macOS/Linux) or Get-Content "{brain_path}\_meta\log.jsonl" -Tail 50 (Windows PowerShell)since filter.
The since value must be ISO 8601 format (e.g., 2025-01-15T00:00:00Z):
npx wicked-brain-call search --param query=* --param limit=100 --param since={iso8601_7_days_ago}
chunks/extracted/, wiki/) to show recent activity distribution.verify_wiki:
npx wicked-brain-call verify_wiki
⚠ Wiki staleness: {stale} stale / {orphaned} orphaned / {unverifiable} unverifiable (of {total} articles)
stale = at least one referenced chunk changed or is missing. orphaned =
every referenced chunk is missing from the index. unverifiable = article
predates source_hashes frontmatter. Suggest running wicked-brain:compile
to refresh stale articles.
If total == 0 (brain has no wiki yet), skip the line entirely.Convergence Debt: Detect chunks that are frequently accessed but have never been compiled into wiki articles:
npx wicked-brain-call candidates --param mode=promote --param limit=50
For each result where access_count >= 5 and session_diversity >= 3, check whether any wiki article references it. Use the Grep tool on {brain_path}/wiki/ searching for the chunk path string. If no wiki article references it, flag it as convergence debt:
⚠ Convergence debt: {path} (accessed {access_count} times across {session_diversity} sessions, no wiki citation)
If any convergence debt exists, suggest running wicked-brain:compile to promote high-value chunks.
Contradiction Hotspots: Detect path prefixes that concentrate multiple contradictions:
npx wicked-brain-call contradictions
Group the returned contradiction links by path prefix: take the first two path segments of each linked path (e.g., a path chunks/extracted/auth/session.md yields prefix chunks/extracted/auth/). If any prefix has 2 or more contradiction links, flag it as a hotspot:
⚠ Contradiction hotspot: {prefix} ({N} contradictions) — consider dispatching wicked-brain:compile or manual review
Depth 2: Depth 1 plus:
_meta/log.jsonl fully for recent activity (last 7 days)Link Health (Depth 2 only): Check link integrity and surface knowledge gaps using two additional API calls.
Get link health:
npx wicked-brain-call link_health
Report:
Get recent search misses:
npx wicked-brain-call search_misses --param limit=20
Report the top recurring search miss queries to identify knowledge gaps. If a query appears multiple times, that topic is a strong candidate for ingestion or wiki article creation.
Universal code intelligence via LSP. Queries language servers for definitions, references, symbols, call hierarchies, hover info, and diagnostics. Auto-installs language servers when missing. Use when: "where is X defined", "who uses X", "what type is X", "list symbols in", "find symbol", "who calls X", "code diagnostics", "lsp health".
Synthesize wiki articles from brain chunks. Dispatches a compile subagent that identifies concept clusters in chunks and writes structured wiki articles with backlinks and source attribution. Use when: "compile the brain", "write wiki articles", "synthesize knowledge", "brain compile".
This skill should be used when the user says "configure brain CLI", "update CLAUDE.md from brain", "write brain orientation", or "regenerate brain config". Reads brain state and writes contextual instructions into the active CLI's agent config file. Run after onboarding, major ingests, or consolidation.
Multi-pass brain consolidation - archive noise, promote patterns, merge duplicates, build synonym map. Use when: brain needs maintenance, after significant ingestion, or reviewing consolidation_hint entries in log.jsonl.
Inspect, replay, or drop dead-lettered events from wicked-brain's bus subscriber. The auto-memorize subscriber consumes `wicked.garden.fact.extracted` and dead-letters events that exhaust their retry budget. Without this skill, those events sit untouched forever — a fixable handler bug silently loses every fact. Use when: "show DLQ", "replay dead letters", "what events failed", "drop dead letter", "memory subscriber DLQ", "stuck fact events".
Fill gaps in brain knowledge. Dispatches an enhance subagent that identifies thin areas and writes inferred chunks to expand coverage. Use when: "enhance the brain", "fill gaps", "brain enhance", "what's missing in the brain".