用途：system-setup 是 Plugin Freedom System 的入口技能，在插件工作流开始前运行，负责验证并配置 JUCE 插件开发所需的全部依赖。它不委托其他技能或子代理，也不创建或修改插件目录。
主要能力：检测当前平台（macOS、Linux、Windows，当前目标平台为 macOS）；按顺序检查 Python 3.8+、构建工具（Xcode Command Line Tools、GCC 或 MSVC）、CMake 3.15+、JUCE 8.0.0+ 以及可选的 pluginval；提供自动安装、引导式手动安装和仅检查三种模式；验证工具是否真正可用；将验证后的路径与版本写入 .claude/system-config.json，并把该文件加入 .gitignore。
使用方式：通过 /setup 命令调用。若已有 30 天内验证过的配置，会提供重新验证、查看配置、重新配置单项或退出菜单；否则进入完整设置流程，选择模式后依次验证各依赖。所有检测由 assets/system-check.sh 执行，例如 bash .claude/skills/system-setup/assets/system-check.sh --detect-platform。支持 --test=SCENARIO 测试模式，此时所有 system-check.sh 调用都会附加 --test=$SCENARIO，并使用模拟数据、不实际修改系统。
适用场景：新用户首次搭建 JUCE 插件开发环境，或构建脚本检测到依赖缺失时重新验证。
限制：当前目标平台为 macOS，Windows/Linux 为后续扩展；pluginval 为可选依赖；自动化安装失败会回退到引导模式；具体安装命令与错误恢复细节需参考 references/platform-requirements.md、references/juce-setup-guide.md、references/validation-workflow.md 和 references/error-recovery.md。