菜单
Run and interpret nervepack's health check (np-doctor.sh) — when to use it, what each check means, how to fix FAIL/WARN results. Use post-install, after moving the repo, when a nervepack feature stops working, or when the user says "run the doctor" / "check nervepack health" / "/np-doctor".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Sync ~/Code/nervepack with origin/main using strict-safe semantics (fast-forward only; never auto-rebase or autostash). Use when the user says "sync nervepack", "pull nervepack", "what's new in nervepack", when starting work after a known cron run, or when the SessionStart status file reports anything other than "up to date".
Single entry point for capturing something worth remembering. Classifies the input as durable (→ nervepack repo) or session-scoped (→ local Claude memory store) and routes it to the right destination. Use when the user says "capture this", "remember this", "save this learning", "/capture", or "/learn" — any phrasing that signals "this is worth keeping" without specifying where.
Capture a new durable learning (rule, preference, plugin choice, environment quirk, useful command) into the correct nervepack file. Use when the user says "remember this in nervepack", "save to nervepack", "add this to my AI context", "save this to the team layer", or whenever you notice a fact worth keeping across sessions.
Send a task or a handoff to a fresh agent and supervise it. Use when you want another agent to carry out work — executing a [[np-core-handoff]] doc, running a long/risky job, or parallelizing — especially when you tried to "continue" a previously spawned agent and the SendMessage capability isn't available in this environment. Covers the spawn-fresh-with-context fallback, scoping, stop-points, and verification. The dispatch half of the continuity pair with [[np-core-handoff]] (handoff writes the doc; dispatch sends it).
Pull episodic working-memory themes ("what we did / decided / where we left off") from nervepack's episodic/ layer on demand. Use when the user says "/recall", "what did we do on X", "remind me where we left off on Y", or wants prior-session context that wasn't auto-injected. Read-only — episodic is the lowest-authority layer; durable skills/sources/wiki override it.
Turn Nervepack features on/off and adjust their settings. Use when the user says "toggle off X", "disable memory/lessons/the evaluator/the directive", "turn X back on", "what nervepack features are on", or wants to change a param like the sync interval. Wraps engine/setup/nervepack-toggle.sh.
| name | np-core-doctor |
| description | Run and interpret nervepack's health check (np-doctor.sh) — when to use it, what each check means, how to fix FAIL/WARN results. Use post-install, after moving the repo, when a nervepack feature stops working, or when the user says "run the doctor" / "check nervepack health" / "/np-doctor". |
bash ~/Code/nervepack/engine/setup/np-doctor.sh
Or from the MCP tool: call nervepack_doctor (output identical to the CLI).
[MUST ] llm-cli PASS
[SHOULD] dashboard-data WARN (run 35-link-dashboard-data.sh)
PASS / FAIL (reason) / WARN (reason) / MISSING / UNSUPPORTED.| Check | What it verifies | Fix |
|---|---|---|
knowledge | Skill symlinks exist (~/.claude/skills/np-core-sync/SKILL.md) | Re-run 30-link-skills.sh |
llm-cli | np-llm.sh complete exits 0 with output | Auth: set ANTHROPIC_API_KEY or run claude /login; path: check CLAUDE_BIN |
git-sync | Repo has a remote | git remote add origin <url> |
toggles | np_enabled function is available | Source np-toggle-lib.sh in the failing hook/script |
content | NP_CONTENT_DIR resolves to a real dir | Set NP_CONTENT_DIR or write ~/.config/nervepack/content-dir; single-repo users: write the path to the engine root |
| Check | Fix |
|---|---|
team | Set NP_TEAM_DIR or ~/.config/nervepack/team-dir if you have a team overlay; otherwise safe to ignore |
dashboard-data | bash ~/Code/nervepack/engine/setup/35-link-dashboard-data.sh |
hook-scripts | Re-run the failing bootstrap (the error names the missing script) |
session-start | Re-run 51-install-nervepack-directive-hook.sh (+ 52/53/56 for other hooks) |
session-end-capture | Re-run 52-install-episodic-hooks.sh |
session-end-flush | Re-run 54-install-session-flush-hook.sh |
scheduled-maint | Re-run 70-install-memory-cron.sh (Linux/macOS) or 70-install-memory-schtasks.sh (Windows) |
pii_filter_full | bash ~/Code/nervepack/engine/setup/25-install-pii-deps.sh |
llm-cli FAIL on Windows — --bare was historically passed and skips keychain reads;
fixed in engine ≥ commit 6e98a88. Also check that ANTHROPIC_API_KEY is set if using
API-key auth.
content PASS with implicit-fallback warning — writers (episodic-maintain, metrics)
skip commits until NP_CONTENT_DIR is explicit. Set it to avoid silent no-ops.
dashboard-data WARN after moving the repo — the symlink points to the old path;
re-run 35-link-dashboard-data.sh.
Adapter checks report MISSING — no ~/.config/nervepack/adapter.json yet; run the
onboarding flow ([[np-core-onboard]]) to wire the adapter and generate the file.
Re-run the doctor; exit 0 + "MUST tier OK ✓" means the engine is healthy.