feat: add post-install script and troubleshooting guide

Add scripts/post-install.sh to clear stale skillsSnapshot cache from
existing sessions, ensuring the skill loads immediately after install.
Update README with corrected install path and post-install instructions.
Include detailed troubleshooting report documenting the snapshot cache
root cause analysis.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-14 12:36:12 +10:00
co-authored by Claude Opus 4.6
parent dcc9093182
commit 38c1fe875d
3 changed files with 259 additions and 3 deletions
+15 -3
View File
@@ -55,12 +55,21 @@ v1 direction.
### Install
```bash
cd ~/.openclaw/workspace/skills/
cd ~/.openclaw/workspace/main/skills/
git clone https://github.com/dtzp555-max/memory-continuity.git
cd memory-continuity
bash scripts/post-install.sh
```
No npm install, no API keys, no external database.
> **Why `post-install.sh`?**
> OpenClaw caches each session's skill list in a `skillsSnapshot`. If you
> install this skill while the gateway is stopped (or restart the gateway
> after cloning), existing sessions won't detect the new skill until their
> snapshot is cleared. The post-install script handles this automatically.
> New sessions created after install are unaffected.
### Test the current skill version
1. Start a multi-step task with your agent
@@ -158,16 +167,19 @@ Memory continuity is for:
```text
memory-continuity/
├── SKILL.md
├── SKILL.md # Behavior contract / skill definition
├── skill.json # Skill metadata for OpenClaw loader
├── _meta.json # Workspace skill registry metadata
├── README.md
├── LICENSE
├── plugin/
│ └── lifecycle-prototype.ts # Phase 2 probe / not production yet
│ └── lifecycle-prototype.ts # Phase 2 probe / not production yet
├── references/
│ ├── template.md
│ ├── doctor-spec.md
│ └── phase2-hook-validation.md
└── scripts/
├── post-install.sh # Clears stale skill snapshots
└── continuity_doctor.py
```