菜单
Use when the user wants to install or set up the Now Playing kiosk on a Raspberry Pi for the first time. Triggers on phrases like "help me set this up", "install nowplaying on my pi", "get started", "first time setup", or when the user has just cloned the repo and asks how to begin.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use when the user wants to inspect Now Playing runtime state without changing anything — peek at processes, recent recognitions, capture levels, hygiene activity, promotion progress. Triggers on "what's it doing", "show me logs", "is recognition working", "inspect the orchestrator".
Use when the user needs to generate the third-party credentials Now Playing requires — currently just a Discogs personal access token. Triggers on phrases like "set up my discogs account", "get a discogs token", "discogs api key", "accounts", "credentials", "what api keys do I need".
Use when the user is wiring up the physical audio chain for Now Playing — connecting their turntable, RIAA preamp, RCA splitter, Sonos line-in, and USB audio capture device, or attaching the kiosk display and touch USB cable. Triggers on phrases like "wire the audio", "connect the turntable", "how do I split the signal", "what cables do I need", "set up the hardware", "connect the display".
Use when the user is ready to install the Now Playing backend software on the Pi — cloning the repo, creating the Python venv, writing the .env, syncing their Discogs catalog, and manually verifying audio capture. Triggers on phrases like "install the software", "set up discogs sync", "run uv sync", "create the env file", "verify audio capture", "run capture_proto".
Use when the user wants to enable Last.fm scrobbling on their Now Playing kiosk — guides them through creating a Last.fm API app, minting a permanent session key via the browser-auth dance, writing the three env vars into the Pi's .env, and restarting the orchestrator. Triggers on phrases like "set up last.fm", "enable scrobbling", "scrobble to last.fm", "configure lastfm", "lastfm auth".
Use when the user needs to prepare a fresh Raspberry Pi for Now Playing — flashing Pi OS, setting the hostname, enabling SSH, installing base system packages. Triggers on phrases like "prepare my pi", "flash the sd card", "first time pi setup", "set up the pi", "set the hostname", "enable ssh on the pi".
基于 SOC 职业分类
| name | nowplaying-setup |
| description | Use when the user wants to install or set up the Now Playing kiosk on a Raspberry Pi for the first time. Triggers on phrases like "help me set this up", "install nowplaying on my pi", "get started", "first time setup", or when the user has just cloned the repo and asks how to begin. |
You are guiding a new installer through bringing up the Now Playing kiosk. The install is broken into focused phase skills. Your job is to figure out where the user already is, hand off to the right phase, and stop. Do not try to do all phases at once.
| Phase | When it applies | Skill to hand off to |
|---|---|---|
| 1. Hardware wiring | Turntable, preamp, splitter, Sonos line-in, UFO202, display | nowplaying-setup-hardware |
| 2. Pi preparation | Flash Pi OS, hostname, SSH access, system packages | nowplaying-setup-pi |
| 3. Sonos configuration | Zone name, line-in source, VLAN/discovery | nowplaying-setup-sonos |
| 4. Discogs account | Recommended; skippable if you want to try MusicBrainz-only first | nowplaying-setup-accounts |
| 5. Software install | Clone, uv sync, .env, catalog sync, capture verify | nowplaying-setup-install |
| 6. Services + kiosk | systemd units, kiosk URL, optional fingerprint flag | nowplaying-setup-services |
| 7. Last.fm scrobbling (optional) | API app + browser auth dance + three env vars | nowplaying-setup-lastfm |
Phases 1–6 are sequential; each assumes the previous is complete. Phase 7 is opt-in and can be done any time after the services are running.
Ask in this order, one at a time, only the ones you can't infer from context (memory, recent messages, or a quick state probe):
"Are you driving this from your Mac (or another machine via SSH), or working directly on the Pi?" Both are supported. The commands are the same; the difference is whether they run locally or wrapped in ssh nowplaying-pi '...'. Remember the answer.
"Is the audio chain wired up yet — turntable feeding both your Sonos line-in and the USB capture device on the Pi?" If no → hand off to nowplaying-setup-hardware.
"Is Pi OS flashed, hostname set, and can you SSH into it?" If no → hand off to nowplaying-setup-pi.
"Is your Sonos zone configured for line-in playback and named the way you'll reference it in config?" If no → hand off to nowplaying-setup-sonos.
"Do you have a Discogs personal access token ready?" If no → hand off to nowplaying-setup-accounts. Follow-up: "If you'd rather skip Discogs and rely on MusicBrainz auto-discovery, that's supported — say so and we'll skip Phase 4." If they want to skip, note that decision and move to step 6.
Probe: does the Pi have the repo cloned and the catalog synced? Run:
ssh nowplaying-pi 'test -f ~/now-playing/pi/data/discogs.sqlite && echo OK'
If OK → the Discogs catalog is in place; continue to step 7. If not OK → ask "Are you skipping Discogs and using MusicBrainz-only?" If yes, also check for an installed venv (ssh nowplaying-pi 'test -d ~/now-playing/pi/.venv && echo OK'); if that's missing → hand off to nowplaying-setup-install. If they're not skipping → hand off to nowplaying-setup-install to run the catalog sync.
Probe: are the services running? Run:
ssh nowplaying-pi 'systemctl is-active nowplaying-orchestrator nowplaying-kiosk'
If both active → install is done; point them at the kiosk URL (http://nowplaying-pi.local:8080/). Otherwise → hand off to nowplaying-setup-services.
Once you've identified the right phase, say which phase you're starting and why, then invoke that phase skill. Don't try to also do the next phase in the same turn — let the phase skill run, verify completion, and return control here for the next handoff.
If the user is mid-install and a phase fails, switch to nowplaying-troubleshoot.
nowplaying-diagnose. For "what's playing" use nowplaying-status. For "it's broken" use nowplaying-troubleshoot.If the user says "just walk me through the whole thing," run the phases in order — but still one at a time, verifying each before moving to the next.