菜单
Project-specific Steam Deck Game Mode UI rules for decky-music. Use when designing, implementing, or reviewing the `/music` Decky route, provider pages, QAM entry points, gamepad focus behavior, Footer Legend text, or UI mockups.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
发布 decky-music 新版本(pre-release 或正式)。当用户说"发版 / 发布新版本 / pre-release / 发 beta"时使用。覆盖版本号、二进制构建、remote_binary 指纹、tag、GitHub Release、CI 出包与 zip 抽验的完整流程。
把"已提交但尚未真机验证"的改动登记成 GitHub issue,避免未验收当已完成。当改动触碰 AGENTS.md 要求真机验收的运行时/UI 行为,但验证被阻塞(没拿到部署授权、或用户选择先提交后验证)时使用。
Autonomous develop-deploy-debug loop for Steam Deck Decky Loader plugins — sideload deploys, log pulling, CEF/CDP automation of the running Steam UI (navigate, click, screenshot, key input), sleep inhibition, and on-device verification. Use when developing, deploying, or debugging any Decky plugin against a real Steam Deck.
Drive and inspect the running Steam client UI over the Chrome DevTools Protocol (CEF remote debugging, port 8080) — list targets, evaluate JS probes, navigate routes, click elements, dispatch keys, capture screenshots, stream console errors. Use for hands-free UI automation and read-only diagnosis of Steam's gamepad UI on a Steam Deck (or any Steam with CEF debugging enabled).
| name | steamdeck-ui-design |
| description | Project-specific Steam Deck Game Mode UI rules for decky-music. Use when designing, implementing, or reviewing the `/music` Decky route, provider pages, QAM entry points, gamepad focus behavior, Footer Legend text, or UI mockups. |
Use this skill for decky-music UI work. It is adapted from steamdeck-ui-design-skill.zip and intentionally narrowed to this project.
Read these before changing UI behavior:
docs/DESIGN.md §6: architecture-level UI constraints.docs/ui-design/specs/steam-deck-ui-rules.md: shared visual, focus, button, Footer Legend, and host-safety contract.docs/ui-design/specs/qq-ui.md: QQ provider page rules.docs/ui-design/specs/ncm-ui.md: NCM provider page rules.docs/ROADMAP.md: current P3+ implementation order.The upstream archive contained broad 10-foot UI guidance. For this repo, apply these corrections:
/music content. QAM itself is a SteamOS side panel and remains valid for provider selection, login, settings, and project links.Focusable action-description props; Steam renders icon style, layout, and the left STEAM item.Start blind play/pause, Y queue overlay, and Now Playing / radio pages for full controls.View to multi-select or playback controls unless a real project need is validated. It is not part of the P3 required path./music uses top horizontal provider Tabs and full-width content.L1/R1 hints, and the current-track status badge in the content header row.Every interactive element must be reachable by gamepad focus.
| Button | decky-music meaning |
|---|---|
| A | Confirm, play, enter detail, submit search, refresh QR. |
| B | Back, close overlay, cancel manual lyric/comment browsing. |
| X | Context menu; NCM lyrics/comment toggle; radio page may override for trash/next. |
| Y | Queue overlay on normal pages; radio pages may override for like/favorite. |
| Start | Global play/pause blind operation. Hide the hint when queue is empty or backend is unavailable. |
| View | Reserved; do not use for required flows. |
| L1/R1 | Top-level provider page switching. |
| L2/R2 | Secondary Tabs or long-list paging. |
| D-Pad / left stick | Focus roaming; lyrics manual scroll; slider micro-adjustment. |
| Steam / QAM | System reserved, never bind. |
Hard rules:
Focusable or a Decky component that participates in the focus tree.MAINTAIN_X for grids and multi-column layouts.#1a9fff as the main interaction color.onError placeholder; never send image bytes through bridge RPC.Steam UI and plugin UI share one Chromium context. A plugin bug must not freeze Steam.
Before considering UI work done:
/music, switch Tabs, search/open content, play, pause/resume, open/close queue, open/close context menu.