clipboard

タスク

入力：$ARGUMENTS

トラックファイルからコンテンツをコピーし、Suno やその他のツールに貼り付けられるようにします。

---

クリップボードスキル

トラックファイルの特定のセクションを直接クリップボードにコピーします。

ステップ 1：プラットフォームを検出してクリップボードツールを確認

検出を実行します：

if command -v pbcopy >/dev/null 2>&1; then
  echo "macOS"
elif command -v clip.exe >/dev/null 2>&1; then
  # clip.exe is a built-in Windows utility (System32). Reachable both from WSL
  # via interop and from a native-Windows shell such as Git Bash, so this one
  # branch covers both. Verified on a windows-latest runner: Git Bash present,
  # clip.exe resolved at /c/Windows/system32/clip.exe, copy round-tripped.
  echo "Windows/WSL"
elif command -v xclip >/dev/null 2>&1; then
  echo "Linux-xclip"
elif command -v xsel >/dev/null 2>&1; then
  echo "Linux-xsel"
else
  echo "NONE"
fi

該当なしの場合：

Error: No clipboard utility found.

Install instructions:
- macOS: pbcopy (built-in)
- Linux: sudo apt install xclip
- Windows (native) and WSL: clip.exe (built-in)

ステップ 2：引数を解析

想定される形式：<content-type> <album-name> <track-number>

コンテンツタイプ：

• lyrics - Suno の歌詞ボックス
• style - Suno のスタイルボックスのみ
• exclude - Suno の除外スタイル欄（要素のみをカンマ区切りで指定 — drums, autotune。「no drums」にはしない）
• streaming-lyrics - ストリーミング用歌詞（配信事業者向け）
• all - Suno の全入力項目（Style + Exclude + Lyrics を結合）
• suno - Suno の自動入力用 Tampermonkey 向け JSON オブジェクト（title、style、exclude_styles、lyrics）

例：

• /clipboard lyrics sample-album 03
• /clipboard style sample-album 05
• /clipboard streaming-lyrics sample-album 02
• /clipboard all sample-album 01

引数が不足している場合：

Usage: /clipboard <content-type> <album-name> <track-number>

Content types: lyrics, style, exclude, streaming-lyrics, all, suno

Example: /clipboard lyrics sample-album 03

ステップ 3：MCP 経由でコンテンツを抽出

format_for_clipboard(album_slug, track_slug, content_type) を呼び出します。1 回の呼び出しで、指定されたコンテンツを抽出して整形します。

• content_type：「"lyrics"」、「"style"」、「"exclude"」、「"streaming"」、「"all"」、または「"suno"」
• クリップボードにそのままコピーできる整形済みコンテンツを返します
• トラックの解決、セクションの抽出、整形を自動的に処理します

トラックが見つからない場合： MCP は、利用可能なトラックを含むエラーを返します。

ステップ 6：クリップボードにコピー

検出されたプラットフォームのクリップボードコマンドを使用します：

プラットフォーム	コマンド
macOS	pbcopy
Windows（ネイティブ）/ WSL	clip.exe
Linux（xclip）	xclip -selection clipboard
Linux（xsel）	xsel --clipboard --input

例（歌詞内の特殊文字を安全に扱うには printf '%s' を使用します）：

printf '%s' "$content" | pbcopy  # macOS
printf '%s' "$content" | xclip -selection clipboard  # Linux

ステップ 7：確認

次の内容を報告します：

✓ Copied to clipboard: {content-type} from track {track-number}
  Album: {album}
  Track: {track-filename}

エラー処理

トラックファイルが見つからない場合：

Error: Track {track-number} not found in album {album}

Available tracks:
- 01-track-name.md
- 02-track-name.md

コンテンツセクションが見つからない場合：

Error: {content-type} section not found in track {track-number}

The track file may not have this section yet.

設定が見つからない場合：

Error: Config not found at ~/.bitwize-music/config.yaml
Run /configure to set up.

---

例

Suno の歌詞をコピー

/clipboard lyrics sample-album 03

出力：

✓ Copied to clipboard: lyrics from track 03
  Album: sample-album
  Track: 03-t-day-beach.md

スタイルプロンプトをコピー

/clipboard style sample-album 05

ストリーミング用歌詞をコピー

/clipboard streaming-lyrics sample-album 02

Suno の全入力項目をコピー

/clipboard all sample-album 01

出力：

✓ Copied to clipboard: all suno inputs from track 01
  Album: sample-album
  Track: 01-intro.md

Contents:
- Style Box
- `Exclude: …` (if the track has Exclude Styles)
- Lyrics Box

Suno 自動入力用 JSON をコピー

/clipboard suno sample-album 01

出力：

✓ Copied to clipboard: suno auto-fill JSON from track 01
  Album: sample-album
  Track: 01-intro.md

Clipboard contains JSON with: title, style, exclude_styles, lyrics
Paste into Suno with the Tampermonkey auto-fill script (Ctrl+Shift+V).
See tools/userscripts/README.md for setup.

---

実装上の注意

クリップボードの検出：

• 優先順位に従って複数のツールを確認します
• clip.exe は Windows に組み込まれているため、ネイティブ Windows（Git Bash 経由）と WSL（相互運用機能経由）の両方で使用できます
• bash がまったく利用できない場合は、PowerShell の Set-Clipboard が同等のネイティブな代替手段になります（動作確認済み）
• Linux ユーザーは xclip または xsel のいずれかを使用できます

コンテンツの抽出：

• MCP の format_for_clipboard が、すべてのセクションの抽出と整形を処理します
• 手動でファイルを解析する必要はありません

複数の一致：

• トラック番号が複数のファイルに一致した場合（通常は発生しないはずです）、最初に一致したものを使用します
• ディレクトリ構造に問題があるように見える場合は、ユーザーに警告します