Spine Update

---
name: spine-update
description: "Checks and updates PaperSpine from GitHub, preserving global config. Use for upgrades, version checks, or suite reinstall."
---

# PaperSpine Update

Use this skill when the user asks to update PaperSpine, check whether
PaperSpine is the latest version, reinstall the local suite from GitHub, or
upgrade the local Codex, Claude Code, or OpenClaw PaperSpine skills while
preserving settings.

## Required Behavior

Run the bundled updater using the full path to the installed skill:

**Windows:**
```powershell
$script = Join-Path $env:USERPROFILE ".claude\skills\spine-update\scripts\paperspine_update.py"
python $script --yes
```

**macOS / Linux:**
```bash
python3 <repo>/skills/spine-update/scripts/paperspine_update.py --yes（ACAT-GOVERNANCE：上游脚本未随本仓库集成，宿主安装路径已废弃；2026-09-23 宿主中性化改写，改用本仓技能目录内路径）
```

For a version check only, use `--check-only` instead of `--yes`.

The updater must:

- read the local install state from `~/.paperspine/install_state.json` when
  present,
- fall back to this skill's bundled `paperspine_version.json` when install
  state is missing,
- compare against the GitHub `main` manifest at
  `dist/paperspine_version.json`,
- update Codex, Claude Code, and OpenClaw installs by default,
- preserve `~/.paperspine/config.json`, including UI language preferences,
- never touch project artifacts such as `paper_rewriting_output/`,
- print a clear already-latest message when no update is needed,
- after installing or updating, remove any stale `skillOverrides` entries for
  PaperSpine skills (the sync script does this automatically).

## Advanced Usage

- Use `--target codex`, `--target claude`, or `--target openclaw` only when the
  user explicitly asks to update one host.
- Use `--repo-archive <path-or-url>` for local testing or offline update from a
  downloaded PaperSpine archive.
- Use `--config-home <path>` only for tests or when the user has explicitly
  configured a non-default PaperSpine global config directory.

If network access fails, report the updater error and suggest running the
installer manually from a freshly downloaded repository. Do not delete local
skills after a failed download or failed package validation.