mcpField
P
paper-spine-update

paper-spine-update

github.com/wubing2023Agent 工作流6.1k209 次安装2 周前更新
代码仓库

关于 paper-spine-update

paper-spine-update 是用于维护 Codex、Claude Code 或 OpenClaw 中 PaperSpine 技能的更新工具。它会检查 GitHub 版本清单，并在保留 PaperSpine 配置和项目文件的同时更新本地套件。

主要功能

  1. 01检查可用更新
  2. 02更新受支持的 PaperSpine 安装
  3. 03保留全局配置
  4. 04不触碰项目文件

适用场景

  1. 01检查 PaperSpine 是否为最新版本
  2. 02更新已安装宿主中的 PaperSpine
  3. 03从 GitHub 重新安装本地套件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wubing2023/paperspine --skill paper-spine-update

安装后在 Claude Code 中输入/paper-spine-update确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

paperspine_version.json
agents/
openai.yaml
scripts/
_paper_spine_utils.py
humanize_check.py
paperspine_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

仅检查版本时，使用 --check-only 代替 --yes。

更新程序必须：

  • 在存在时读取 ~/.paperspine/install_state.json 中的本地安装状态，
  • 安装状态缺失时，回退到此技能捆绑的 paperspine_version.json，
  • 与 GitHub main 分支中的清单 dist/paperspine_version.json 进行比较，
  • 默认更新 Codex、Claude Code 和 OpenClaw 安装，
  • 保留 ~/.paperspine/config.json，包括界面语言偏好，
  • 绝不修改 paper_rewriting_output/ 等项目产物，
  • 无需更新时，清楚地提示已是最新版本，
  • 安装或更新后，移除 PaperSpine 技能中任何过时的 skillOverrides 条目（同步脚本会自动执行此操作）。

高级用法

  • 仅当用户明确要求更新某个主机时，才使用 --target codex、--target claude 或 --target openclaw。
  • 使用 --repo-archive <path-or-url> 从本地测试，或从已下载的 PaperSpine 归档文件离线更新。
  • 仅在测试或用户明确配置了非默认 PaperSpine 全局配置目录时，使用 --config-home <path>。

如果网络访问失败，请报告更新程序错误，并建议从刚下载的仓库手动运行安装程序。下载失败或软件包验证失败后，不要删除本地技能。

评论

支持 Markdown