paper-spine-update について
paper-spine-update は、Codex、Claude Code、OpenClaw の PaperSpine スキルを管理する更新ツールです。GitHub のバージョン情報を確認し、設定とプロジェクトの成果物を保ったままローカルの一式を更新します。
主な機能
- 01更新の有無を確認
- 02対応環境の PaperSpine を更新
- 03グローバル設定を保持
- 04プロジェクト成果物に触れない
活用シーン
- 01PaperSpine が最新か確認
- 02インストール済み環境の PaperSpine を更新
- 03GitHub からローカル一式を再インストール
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ wubing2023/ paperspine --skill paper-spine-updateインストール後、Claude Code で/paper-spine-updateを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
paperspine_version.jsonagents/openai.yamlscripts/_paper_spine_utils.pyhumanize_check.pypaperspine_update.py詳細
PaperSpine の更新
ユーザーから PaperSpine の更新、PaperSpine が最新バージョンかどうかの確認、GitHub からのローカルスイートの再インストール、または設定を保持したままローカルの Codex、Claude Code、OpenClaw 用 PaperSpine スキルをアップグレードするよう依頼された場合に、このスキルを使用します。
必須の動作
インストール済みスキルのフルパスを指定して、同梱のアップデーターを実行します。
Windows:
$script = Join-Path $env:USERPROFILE ".claude\skills\paper-spine-update\scripts\paperspine_update.py"
python $script --yes
macOS / Linux:
python3 ~/.claude/skills/paper-spine-update/scripts/paperspine_update.py --yes
バージョン確認のみの場合は、--yes の代わりに --check-only を使用します。
アップデーターは次の処理を行う必要があります。
- 存在する場合は、ローカルのインストール状態を
~/.paperspine/install_state.jsonから読み取ります。 - インストール状態がない場合は、このスキルに同梱された
paperspine_version.jsonにフォールバックします。 - GitHub の
mainブランチにあるdist/paperspine_version.jsonのマニフェストと比較します。 - デフォルトで Codex、Claude Code、OpenClaw のインストールを更新します。
- UI の言語設定を含め、
~/.paperspine/config.jsonを保持します。 paper_rewriting_output/などのプロジェクト成果物には決して触れません。- 更新が不要な場合は、すでに最新であることを明確に表示します。
- インストールまたは更新後、PaperSpine スキルの古い
skillOverridesエントリを削除します(同期スクリプトが自動的に処理します)。
高度な使用方法
- ユーザーが 1 つのホストのみの更新を明示的に依頼した場合に限り、
--target codex、--target claude、または--target openclawを使用します。 - ローカルテスト、またはダウンロード済みの PaperSpine アーカイブを使ったオフライン更新には、
--repo-archive <path-or-url>を使用します。 --config-home <path>は、テストの場合、またはユーザーがデフォルト以外の PaperSpine グローバル設定ディレクトリを明示的に設定している場合に限り使用します。
ネットワークアクセスに失敗した場合は、アップデーターのエラーを報告し、新しくダウンロードしたリポジトリからインストーラーを手動で実行するよう案内します。ダウンロードまたはパッケージの検証に失敗した場合、ローカルのスキルは削除しないでください。
コメント
Markdown 対応