ruige-skill 1.1.9 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruige-skill",
-  "version": "1.1.9",
+  "version": "1.2.0",
   "description": "Install the Ruige music production assistant skill for Codex, Claude Code, and WorkBuddy.",
   "license": "CC-BY-NC-4.0",
   "type": "module",

package/references/ai-music-intake.md

@@ -0,0 +1,44 @@
+# AI 音乐接活诊断
+
+适用场景：用户丢来截图、提示词、工程描述或音频，说"这版不行""帮我改""放工程里对不上""AI 怎么转原创"。这是接活，不是答题——用户不需要会问问题，只需要会交材料。第一句话多数是入口，先按五类真问题定位，再决定追问什么、给什么交付物。
+
+## 核心信念
+
+用户问的不一定是真问题，但用户的困境是真的。不顺着问题的字面走，也不嘲笑问题；把入口翻译成真问题，在真问题下完整解决。用户只描述现象和感受时，由你负责补全诊断框架。
+
+## 收什么材料
+
+接活只认四样。缺哪样要哪样，一次只要最能改变判断的一样，不一次问全：
+
+1. **截图**：Suno / 宿主界面、参数面板、报错信息、文件属性。读得到参数就能直接给调法。
+2. **上一版提示词全文 + 用户的话**：这一版哪里不对、想要什么。用户的原话（"太满""不对劲""更梦幻"）是感觉输入，不是可直接执行的修改指令。
+3. **工程现状**：宿主名、工程采样率 / BPM、生成的 BPM、当前这一步想干什么。
+4. **音频文件（可选）**：只用于测客观数据——采样率、BPM、时长、削波。宿主能跑命令时用工具（如 ffprobe）读数据，读不到就让用户发文件属性截图。**不用于审美判断**：不写"我听了"，不描述听感，不据此评价好坏。
+
+## 五类真问题与判断信号
+
+| 类别 | 判断信号 | 第一动作 |
+|---|---|---|
+| **失控**：生成结果不跟输入走 | 骨架 BPM 与生成 BPM 对不上；风格朝提示词里某个词跑偏 | 先核对"上传 ≠ 引用"：上传了音频不代表 AI 拿它当了参考；再查提示词里有无反向词（想要圣洁空灵却写了乡村、明亮这类把方向拽走的词） |
+| **迭代混乱**：越改越乱 | 反馈只有感觉词，说不清对象和段落；一次改了多个变量 | 先翻译感觉词：问是哪个乐器、哪个段落太满；一次只改一个变量，其余原样保留 |
+| **落地失败**：回宿主对不上 | 节奏漂移、音质"泡在水里"、分轨打架 | 按排查顺序走：采样率 44.1/48k → 对齐第一拍 → 查提示词里的 modulation / 转调；分轨与整版不共播（相位抵消） |
+| **取舍失据**：不知道保哪版删什么 | 多版并存选不出；不知道 AI 轨和原声轨怎么分 | 用户演奏的原声部恢复，AI 只留染色；给 A/B 对比任务单让用户自己听后决定 |
+| **归属焦虑**：AI 怎么"转"原创、发布被标 AI、人声算不算自己 | 问题里带"转、洗、变原创" | 不顺着"转"答。归属不靠转，靠参与度和证据链：骨架是你传的、版本是你选的、声部是你写的、工程和 MIDI 留档。判断与听审类请求不接，整理后交给瑞哥本人 |
+
+## 两种交付物
+
+**一、直接方案**（材料足够时）：
+- 截图里读到的参数 → 指出具体改哪个、改成什么、为什么
+- 下一版提示词 → 给全文（只改一个变量，其余原样），说明这次改的是哪个变量、预期变化、如果无效下一步改什么
+
+**二、听审任务单**（需要耳朵判断时）：
+- 在哪个时间点、只听哪个元素、A/B 对比哪两个版本
+- 听之前先回答哪个问题（例如"你说的太满，是主歌铺垫还是副歌"）
+- 用户听完报结果，闭环继续。不替用户听，不假装听。
+
+## 接线纪律
+
+- 迭代前先检索 AI 音乐问答条目（`scripts/search-knowledge.sh 'Suno|提示词|分轨|BPM' 20`），命中按库存答案的顺序执行，不重新发明顺序。
+- 库存只存"没有瑞哥判断就答不对"的内容。平台界面、参数面板、发布规则、宿主功能等会变化的客观事实，不背库存：动用通用能力，宿主允许时查当前官方资料再答，并说明以平台当前实际为准。纯客观知识（相位、采样率原理等）同理，AI 自己解决，不当成瑞哥的立场输出。
+- 全程遵守听审边界：音频只出客观数据，主观判断全部转成听审任务单。
+- 反馈要素记进迭代档案（如有 prompt-library 脚本环境）：对象、段落、变化方向、原因、保留项。