1仕組みと動作原理
純粋なプロンプトルーティングマニュアル：skillディレクトリ内にはSKILL.mdが1つあるのみで、スクリプトやコードは一切含まれない。「エンジン」は外部のRunComfy CLI + Model APIであり、このskillの全機能はホストエージェントがユーザーの意図に応じてモデルを選択し、実行可能な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.
このセクションはファイル全体の運用の中枢である。前述のモデル表は静的データに過ぎず、実際に「なぜ機能するのか」はエージェントが表を読み取り、分類し、ルーティングを選択するという推論に依存している。表内のデータとruncomfy runの呼び出し構成が合わさることで実行可能なレシピが成立する。
機能＝4つのルーティング網羅：ElevenLabs生成（プレミアム）、ACE Step生成（安価／オープンウェイト）、ACE Step audio-inpaint（時間範囲の修正）、ACE Step audio-outpaint（前後の延長）。各ルートにはスキーマ化された--input JSONのサンプルが付属する。
ai-music/SKILL.md
**ACE Step audio-inpaint** — `acestep-ai/ace-step/audio-inpaint`
4つのルーティングは「モデルカタログの切り出し」である。ElevenLabsはプレミアムな単一プロンプト経路を通り、ACE Stepはスタイルと歌詞をtags/lyricsの2つのフィールドに分離する。編集系は同一CLIの異なるendpointとして表現される。
意図分類は明示的な5問の意思決定フロー（生成か編集か→プレミアムか→多言語か→コスト重視か→編集タイプ）として記述されており、異なるエージェント間でも同一の選定結果を再現できる。
ai-music/SKILL.md
**Premium polish required (brand / commercial)?**
「## Decision flow (for the agent)」セクションの第2問に基づく。第1問で「編集」を直接step 5に誘導し、生成／編集の二分法を行ってから細分化することで、価格と品質のトレードオフを決定木として定着させている。
コストデータが選定根拠として組み込まれている：各モデルは$/秒、倍率、最大時間制限（5秒〜5分 / 5〜240秒 / 最大4分）で注記され、推奨文には「選ぶべき基準／避けるべき基準」の境界線が明示されている。
ai-music/SKILL.md
**$0.0002/s** — cheapest CLI-reachable music model on RunComfy.
価格がプロンプト内にハードコードされている（$0.0083/秒、27倍、0.0002〜0.0003/秒）ため、モデル推奨は単なる品質順ではなく「品質×コスト」の複合的な意思決定となる。欠点は価格が陳腐化する可能性があり、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がマスク指定による音声inpaintを公開していない旨が明記されており、そうした要望があった場合は時間範囲の編集へと再定義するよう促している。能力の境界線が誇張なく明確に示されている。
セキュリティ面は作者の自己記述に基づいており、運用の規律として組み込まれている：インストールは公式パッケージマネージャー経由のみ、トークンは0600権限のファイルに保存、プロンプトはシェル展開なしのJSON渡し、外部送信先のエンドポイントのホワイトリスト化。
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自体はいかなるシェルの文字列連結も行わず、インジェクションの余地が（シェル視点において）「存在しない」よう設計されている。
2コア機能
01音楽生成の意図ルーティング：プレミアム（ElevenLabs）vs 安価/オープンウェイト（ACE Step base/1.5）vs 編集（inpaint/outpaint）の自動振り分け
024つのルートそれぞれに対応する、実行可能な`runcomfy run <vendor>/<model>/<endpoint>`呼び出しと--input JSONスケルトンを提供
03スタイルと歌詞を分離したACE Step向けのプロンプト規則（tags + [Verse]/[Chorus]/[inst]タグ付きlyrics）
04音声の部分的修正：時間範囲の再生成（audio-inpaint、start/endのアンカー指定可能）
05音声の双方向延長（audio-outpaint：イントロ/アウトロの追加、最大4分、それ以上は連鎖呼び出しが必要）
06コストと品質のバランスを考慮した提案：シナリオ別のパターン集（ジングル、大量BGM、多言語同楽曲、ゲームループ、30秒から2分への拡張、崩れたサビの修復、ドラフトから完成版への仕上げ）
07ランタイムエラーコード表（0/64/65/69/75/77）によるエージェントのリトライ判断やパラメータ変更の支援
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本体は単一ファイルのプロンプトルーターであり、スクリプト、認証情報の読み出し、隠蔽された外部通信は一切存在しない。実行チェーン：ホストエージェントが公式のサードパーティ製npm CLI（@runcomfy/cli）を経由してRunComfyの公開有料APIを呼び出す。このCLI認証にはユーザーのAPIトークン（mode 0600の~/.config/runcomfy/token.json、またはRUNCOMFY_TOKEN環境変数）の読み取りが必要であり、runcomfy runを実行するたびにアカウントの有料クレジットが消費される。外部送信先は予測可能である（宣言された許可リスト：model-api.runcomfy.net + *.runcomfy.net/*.runcomfy.com、テレメトリやコールバックなし）。留意点：① 呼び出しごとに課金が発生し、記載されている$/秒の価格はスナップショットである点、② サードパーティのソース音声を通じて間接的な生成プロンプトインジェクションを受ける可能性がある点、③ インストール用スラッグ（agentspace-so/runcomfy-agent-skills）と固定リポジトリ（genmedia-labs/skills）が一致していない点。レッド基準（セキュリティ機能の低下、スクレイピング、任意コード実行の余地）には該当しない。統一基準である「サードパーティのnpm/CLIを呼び出し、クレデンシャルや有料枠に触れる可能性がある場合はorange判定とし、判断に迷う場合は高位の区分を選択する」に従い、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のアカウントを所持し、秒単位のモデル従量課金を受け入れ可能で、意図や予算に応じてモデルを自動選択させたいText-to-Music/音声編集エージェントの用途に最適。すぐに実行できるruncomfy runのJSONレシピを直接活用したい人間のユーザーにも適している。
不向きな用途： ローカル環境やセルフホストでの音楽生成を求めるユーザー、RunComfyアグリゲーションを利用しないユーザーには不向き。マスク指定レベルの精密な音声編集や無料枠での試用を必要とする用途には不向き。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.