1实现原理 · 为什么它能做到
纯提示词路由手册：skill 目录内只有一个 SKILL.md、零脚本零代码；『引擎』是外部 RunComfy CLI + Model API，skill 的全部工作是让宿主 agent 按用户意图挑模型并拼出可执行的 runcomfy run 命令。
ai-music/SKILL.md
The agent reads these tables, classifies user intent (premium vs cost-sensitive · multilingual · vocal vs instrumental · generate vs edit), and picks the matching subsection below.
这段是整份文件的运转中枢：前面的模型表是静态数据，真正『为什么能工作』依赖 agent 读表→分类→选路由的推理；表内数据与 runcomfy run 调用体共同构成可执行配方。
能力=四路由覆盖：ElevenLabs 生成（premium）、ACE Step 生成（廉价/开源权重）、ACE Step audio-inpaint（改时间区间）、ACE Step audio-outpaint（前后扩展）；每条路由都带 schema 化的 --input JSON 示例。
ai-music/SKILL.md
**ACE Step audio-inpaint** — `acestep-ai/ace-step/audio-inpaint`
四路由是『模型目录的切片』：ElevenLabs 走 premium 单 prompt 通道，ACE Step 把风格与歌词拆成 tags/lyrics 两个字段；编辑类由同一 CLI 的不同 endpoint 表达。
意图分类被写成显式 5 问决策流（生成还是编辑→是否 premium→多语言→成本敏感→编辑类型），让不同 agent 能复现同样的选型结果。
ai-music/SKILL.md
**Premium polish required (brand / commercial)?**
来自 '## Decision flow (for the agent)' 小节的第 2 问；第 1 问把『编辑』直接导流到 step 5，形成 生成/编辑 二分后再细分，相当于把价格-质量权衡固化成判定树。
成本数据内嵌为选型依据：不同模型按 $/秒、倍率、时长上限（5 s–5 min / 5–240 s / cap 4 min）做标注，推荐语同时给出『选它/别选它』边界。
ai-music/SKILL.md
**$0.0002/s** — cheapest CLI-reachable music model on RunComfy.
价格硬编码在提示词里（$0.0083/s、27×、0.0002–0.0003/s），使模型推荐成为『质量×成本』联合决策而非纯质量排序；缺点是价格可能过期，skill 无法自更新。
编辑类能力的关键机制是时间区间锚定：inpaint 用 start_time/end_time（可锚定轨首或轨尾），outpaint 用 extend_before_duration/extend_after_duration 双向扩展。
ai-music/SKILL.md
Regenerate a **time range** (start_time / end_time, anchorable to track start or end) inside an existing track.
SKILL.md 明确提示了 CLI 今日未暴露 mask 式音频 inpaint，遇到这类需求要 reformulate 成时间区间编辑——能力边界被显式写明，不夸大。
安全面由作者自述并内嵌为使用纪律：安装只走官方包管理器、token 存 0600 文件、prompt 走 JSON 无 shell 展开、外发端点 allowlist。
ai-music/SKILL.md
The CLI does not shell-expand prompt content; it transmits the JSON body directly to the Model API over HTTPS. **No shell-injection surface from prompt content**.
'## Security & Privacy' 是该系列每份 SKILL.md 的固定章节；此处同时是功能边界声明——skill 自己不做任何 shell 拼串，注入面被设计为『不存在』（对 shell 而言）。
2核心能力
01音乐生成意图路由：premium（ElevenLabs）vs 廉价/开源（ACE Step base/1.5）vs 编辑（inpaint/outpaint）自动分流
02给出四路由各自可运行的 `runcomfy run <vendor>/<model>/<endpoint>` 调用与 --input JSON 骨架
03风格/歌词分离的 ACE Step 提示词纪律（tags + lyrics 带 [Verse]/[Chorus]/[inst] 标记）
04音频局部修复：时间区间重生成（audio-inpaint，可锚定 start/end）
05音频双向扩展（audio-outpaint：加 intro/outro，cap 4 min，超长需链式调用）
06成本-质量联合建议：场景化 pattern 库（jingle、批量背景乐、多语言同曲、游戏循环、30s→2min、坏副歌修复、草稿→成片）
07运行期错误码表（0/64/65/69/75/77）辅助 agent 判断重试或改参
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| cli | @runcomfy/cli（npm 官方 CLI，安装） |
| cli | runcomfy（login/run 子命令） |
| network | RunComfy Model API |
| network | 生成结果下载白名单域 |
| network | ElevenLabs AI Music Generation（经 RunComfy 网关） |
| network | ACE Step / 1.5 text-to-audio + audio-inpaint + audio-outpaint（经 RunComfy 网关） |
| network | 模型目录/文档站（正文链接，供人浏览） |
4管控建议与判定依据
建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
- 网络端点: 声明外部网络访问: CLI → model-api.runcomfy.net（提交/轮询模型请求）
- 本地工作目录: 文件读写与工件输出: CLI 将生成音频下载至 --output-dir（示例 ./out）
- SKILL.md: 声明调用宿主 CLI 解释器或外部运行环境
审计说明： 。skill 本体=单文件提示词路由器，零脚本、零凭证读取、无隐藏外发；执行链=宿主 agent 经第三方官方 npm CLI（@runcomfy/cli）调用 RunComfy 公开付费 API：该 CLI 认证需读取用户 API token（~/.config/runcomfy/token.json，mode 0600，或 RUNCOMFY_TOKEN env），每次 runcomfy run 消耗账户付费配额，外发对象可预期（自述 allowlist：model-api.runcomfy.net + *.runcomfy.net/*.runcomfy.com，无遥测/回调）。注意点：① 调用即账单，内嵌 $/s 价格为快照；② 第三方源音频可间接注入生成；③ 安装 slug（agentspace-so/runcomfy-agent-skills）与 pin 仓库（genmedia-labs/skills）不一致。不满足红色特征（无安全降级/反爬/任意代码面）。按统一分档准则『调第三方 npm/CLI 且可能接触密钥/配额 → orange；拿不准取高一档』定档；若宿主将『官方 CLI 自认证闭环』视为可豁免特例，可下调为 yellow。
5第二遍独立确认
- [ok] 外部资源条目复核：npm CLI 安装行、runcomfy login/run 调用点、model-api.runcomfy.net allowlist — 逐条在 SKILL.md 找到原文；runcomfy run 出现 8 次、allowlist 句与 '## How it works' 相互印证。
- [ok] '无 shell 注入面'声明反查 — 全文件除 --input JSON 示例与 runcomfy 命令外无其他执行形态；未发现反引号/管道/$( ) 拼接用户输入的指令。
- [ok] 隐藏脚本/混淆内容扫描 — 目录仅 SKILL.md（ls -a）；正文代码块全部为 runcomfy 示例 JSON，无混淆/编码载荷。
- [discrepancy] 仓库 slug 一致性（安装命令 vs pin 仓库） — SKILL.md 安装行与 See-also 链均指向 agentspace-so/runcomfy-agent-skills，README 自称 runcomfy-agent-skills；而 git remote 与 GitHub API 显示本 pin 为 genmedia-labs/skills。按安装命令安装 ≠ 本分析对象，可能拿到不同/更新的内容。
- [unlocatable] 模型 id 与价格的远端真实性 — 模型 endpoint 存在性与 $/s 价格只能在 runcomfy.com/models 平台侧核实，源码仅能确认『skill 如此声明』；不影响本页展示，价格以平台为准。
- [ok] 第二遍对安全结论找反例 — 未发现漏掉的网络调用/凭证读取；'Credential' 相关词仅出现在自述安全章（禁止 echo token 等），无实际读取指令。
6结论
适合： 适合在 RunComfy 平台有账号、接受按秒计费模型成本，需要『按意图+预算自动选模型』的文生乐/音乐编辑 agent 场景；也适合想直接抄现成 runcomfy run JSON 配方的人类用户。
不适合： 不适合本地/自托管音乐生成或不用 RunComfy 聚合的用户；不适合需要 mask 级精细音频编辑或免费试用的场景；不适合期望 skill 自行校验价格/模型可用性的场景（数据为静态快照）。
Install Agent-Ready
① Verified Mirror 2026-09-09
Option A · Direct DownloadDownload ai-music.tar.gz
sha256:
Option B · Copy Guide for Agent88f8e8b389a70680…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit c163a9fd3a.