核心用法
Home Music 是一款专为 macOS 设计的全屋音乐场景自动化工具，通过整合 Spotify 桌面应用与 Airfoil 音频路由软件，实现"一句话控制全屋音响"的体验。用户只需输入 home-music morning、、home-music party 或 home-music chill` 等简单命令，即可自动完成播放列表切换、目标扬声器选择、音量调节等一系列操作。
该技能采用 Bash 脚本 + AppleScript 的混合架构，底层通过 osascript 与 Airfoil 应用通信，控制音频源选择和扬声器连接，同时调用 spotify-applescript 技能管理 Spotify 的播放状态。预设场景包括：晨间模式（Sonos Move 单音箱、40% 音量、咖啡氛围）、派对模式（全屋所有音箱、70% 音量、摇滚歌单）、放松模式（单音箱、30% 音量、 lounge 音乐）以及静音模式。
显著优点
1. 极致简化操作：将原本需要 10+ 次点击的多步骤操作压缩为单一命令，大幅降低全屋音乐系统的使用门槛。
2. 场景化设计：预设模式覆盖常见生活场景，用户无需记忆复杂的设备名称和音量参数。
3. 高度可定制：支持修改播放列表 URI、添加自定义场景（如健身、晚餐）、配置任意 AirPlay 音箱，满足个性化需求。
4. 文档完善：从安装配置到故障排查，SKILL.md 提供了详尽的指导，包括直接可用的 AppleScript 代码片段供高级用户手动调试。
5. 本地优先：所有控制均在本地完成，无网络依赖，响应速度快且隐私风险极低。
潜在缺点与局限性
1. 平台锁定严重：仅支持 macOS，Windows 和 Linux 用户无法使用；依赖 AppleScript 这一苹果专有技术。
2. 外部依赖复杂：必须同时安装并运行 Spotify 桌面应用、Airfoil 商业软件以及 spotify-applescript 技能，任一环节故障都会导致整体失效。
3. 硬件成本：Airfoil 为付费软件（Rogue Amoeba 出品），且需要支持 AirPlay 的音箱设备，入门门槛较高。
4. 无远程控制能力：纯本地架构意味着无法通过手机 App 或网络远程触发场景，必须在 Mac 终端或配合 Clawdbot 使用。
5. 错误处理有限：虽然使用了 set -euo pipefail，但部分 AppleScript 调用失败时仅静默忽略（|| true），可能导致场景"部分生效"而用户无感知。
适合的目标群体
- macOS 重度用户：已深度融入苹果生态，拥有多台 AirPlay 音箱的家庭。
- 智能家居爱好者：追求自动化体验，愿意通过终端/语音助手控制家居环境的技术早期采用者。
- Spotify + Airfoil 现有用户：已购买并配置好相关软件，希望进一步提升使用效率的人群。
- 开发者/极客：具备 Bash 和 AppleScript 基础，能够根据文档自行扩展自定义场景的用户。
使用风险
1. 依赖项失效风险：Spotify 或 Airfoil 的更新可能破坏 AppleScript 接口兼容性，导致技能突然失效。
2. 音箱连接不稳定：AirPlay 设备在网络波动时可能出现连接失败，脚本虽会尝试重连但无持久化状态管理。
3. 音量突变风险：场景切换时音量可能从 30% 跳变至 70%，若用户未预期可能造成惊吓或扰民。
4. 权限累积：长期使用 osascript 控制应用可能导致系统积累大量辅助功能权限，存在潜在的权限管理混乱风险。