前言¶
零基础想学乐器时，常见问题不是「有没有教程」，而是条件怎么对齐：预算、练习时间、居住环境噪音、年龄与目标往往决定选钢琴、吉他还是尤克里里。自行查资料容易信息碎片化，和 AI 自由对话又容易缺固定流程，推荐口径也不一致。
下面介绍 SkillHub 社区 Skill「乐器入门指南」（@user_70c2f807/musical-instrument-starter-guide）。它用通用 SKILL.md 约束 Agent：先收集条件，再给出 2～3 个候选对比，并输出带购买建议与分阶段路径的结构化方案。Skill 标明不需要 API Key（requires_api_key=false），安装后由当前对话 Agent 按文档执行即可。
这是什么¶
「乐器入门指南」是面向 education 分类的社区 Skill，当前版本 1.0.0，发布者为 user_70c2f807，来源标注为 community。
一句话定位：在对话中充当「乐器选择与入门路径」顾问——根据年龄、预算、目标、时间与身体条件推荐乐器，并给出从购买到前几个月练习的指引。官方说明中明确 不适用于 专业音乐学院级教学、乐器维修，也不能替代真人老师。
SkillHub 页面：https://www.skillhub.cn/skills/user_70c2f807/musical-instrument-starter-guide
资源坐标：@user_70c2f807/musical-instrument-starter-guide
核心功能¶
以下能力均来自该 Skill 的 SKILL.md 说明，Agent 被要求在匹配场景下按步骤执行。
- 需求评估：年龄与身体条件、预算（含配件与课程）、学习目标、练习时间与噪音/空间限制。
- 乐器推荐与对比：筛选 2～3 个候选，从难度、花费、表现力等维度对比，并说明优劣与推荐理由。
- 入门路径：各价位购买建议、前三个月左右的学习里程碑、免费/付费学习资源、练习方法与常见入门问题。
- 结构化输出：默认以「乐器推荐方案」为纲，含条件摘要、推荐表、首推理由、购买建议、分周学习路径与资源列表。
- 边界与异常话术：预算极低、目标不切实际、身体条件受限、选择困难等场景有固定应对提示；并列出 FAQ、不适用场景与误用提醒。
Skill 在文档中强调：推荐为参考性质，鼓励试弹/试吹；进度时间为平均估计；品牌推荐基于公开口碑，非广告。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落到 ./skills/ 可能不会被识别。
skillhub install @user_70c2f807/musical-instrument-starter-guide --dir <skills 目录>
常用路径（来自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在 SkillHub 页面将安装提示发给 AI，让其按 https://skillhub.cn/install/skillhub.md 完成安装。
安装完成后，按你所用客户端要求重启或刷新 Agent，使 Skill 被加载。本 Skill 无需配置 API Key。
典型用法¶
触发条件写在 Skill 正文：当用户需要根据年龄、预算、目标推荐乐器并得到入门学习路径时使用。对话中直接描述自身情况即可，Agent 应先追问缺失维度（风格偏好、噪音、目标等），再进入推荐与路径规划。
示例 1：成人有限预算与时间
用户输入大意：
我30岁想学一个乐器，预算3000以内，每天能练30分钟
Skill 示例中 Agent 会继续问：音乐风格、是否需考虑邻居噪音、学习目标（自娱/表演/伴奏等），再给出方向。
示例 2：儿童选乐器
小孩6岁想学乐器，什么比较合适？
Skill 示例中会列举钢琴、小提琴（小尺寸）、尤克里里等，并可按「兴趣培养 vs 考级」展开分析。
示例 3：两选一对比
吉他和尤克里里哪个更适合入门？
Skill 要求做简短对比（弦数、上手周期、长期发展等），并结合用户具体情况收敛推荐。
输出时 Agent 应遵循文档中的「乐器推荐方案」模板：条件、推荐排名表、首推理由、购买与配件、分月/分周路径、学习资源。文档内附有民谣吉他场景的完整输出样例，可作为格式参考。
适用场景与注意¶
适合谁
- 零基础或初学者，需要在多种乐器间做条件化选择。
- 希望一次性拿到购买区间、前几个月里程碑和资源清单，而不是零散问答。
- 在 Cursor、Claude Code、Codex 等支持
SKILL.md的 Agent 环境中使用。
限制与注意
- 不能替代面对面纠正姿势与听辨；Skill 建议入门期至少上几节课纠正习惯。
- 专业考级深度教学、维修估价、乐理系统课等属于「不适用场景」，应转专业机构或教材。
- 推荐型号与进度为参考，最终应以试奏体验和个人练习为准；避免不看条件跟风选琴或只买不练。
SkillHub 公开数据（以页面/抓取信息为准）：分类 education，评分 100000，下载约 896 次（统计会随时间变化）。
结尾¶
「乐器入门指南」把选琴、对比、购买区间与分阶段路径写进同一套 Skill 流程，适合作为教育类 Agent 的固定顾问能力。若要在本地 Agent 中启用，从 SkillHub 安装 @user_70c2f807/musical-instrument-starter-guide 并指向对应 skills 目录即可。
官方 SkillHub 页面：https://www.skillhub.cn/skills/user_70c2f807/musical-instrument-starter-guide
