用途：pp-spotify 是驱动 spotify-pp-cli 二进制的技能，封装 Spotify Web API，用于发现音乐与播客、管理 Spotify 曲库、控制音频播放等操作。
安装：需先确认 CLI 已安装，再使用技能中的命令。安装方式（保持原样）：npx -y @mvanhorn/printing-press-library install spotify --cli-only；验证：spotify-pp-cli --version。若未安装，可用 Go 方式（需 Go 1.26.6 或更新）：go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/spotify/cmd/spotify-pp-cli@latest。若 --version 提示 command not found，说明运行环境无法在 $PATH 中看到二进制目录，需将安装目录加入 $PATH 后再继续。
认证：先运行 spotify-pp-cli auth setup 获取令牌的 URL 与步骤（可加 --launch 打开链接），然后执行 spotify-pp-cli auth set-token YOUR_TOKEN_HERE 保存令牌，或设置环境变量 SPOTIFY_OAUTH_2_0。运行 spotify-pp-cli doctor 验证配置。
主要能力：命令按实体组织，包括 albums、artists、audio-analysis、audio-features、audiobooks、browse、chapters、episodes、markets、me、playlists、recommendations、shows、spotify-web-search、tracks、users 等，可查询目录信息、管理曲库（如 me create-playlist、me save-library-items、me remove-library-items）、读取当前播放与队列、以及播放控制（如 me pause-a-users-playback、me skip-users-playback-to-next-track）。部分旧端点标注 deprecated。
使用方式：任意命令可加 --agent，展开为 --json --compact --no-input --no-color --yes；输出为可管道 JSON，错误走 stderr。可用 --select 保留字段子集（点号路径可下探嵌套结构，路径相对数据而非 {meta, results} 外层）。可用 spotify-pp-cli which "<自然语言能力描述>" 查找匹配命令，退出码 0 表示有匹配，2 表示无把握。
示例：将曲目列表解析为播放列表时，可用 tracks resolve 读取 stdin 的每行标题，例如 pbpaste | spotify-pp-cli tracks resolve --artist Northlane --agent > resolved.json，再用 jq 检查未解析项，最后 me create-playlist 与 playlists items add-to-playlist 添加 URI；tracks resolve 的行内 match_kind 说明匹配方式，可用 --fail-on-miss 在未命中时以退出码 2 结束。读取播放列表内容应使用 .item 而非 .track，如 jq 取 .results.items[].item.name；playlists tracks 子树指向旧 /tracks 端点，当前凭据会返回 HTTP 403，建议改用 playlists items 子树。
限制：播放控制相关接口（如暂停、切歌、设置音量、重复、随机、转移播放）仅对 Spotify Premium 用户生效；需有效 OAuth 2.0 访问令牌；Web API 基础地址为 https://api.spotify.com/v1。其余收费、价格、平台细节暂未提供。