mcpField
S
setup

setup

github.com/barefootfordクリエイティブ・メディア61476 回インストール5 週間前に更新
リポジトリ

setup について

ButterCut に必要な依存関係を Mac または Windows PC で確認し、インストールと結果の検証を案内するスキルです。macOS ではシンプルと詳細の手順を選べ、Windows には専用のセットアップフローがあります。

主な機能

  1. 01macOS と Windows のセットアップ手順
  2. 02依存関係とバージョンの確認
  3. 03macOS のシンプル・詳細インストール
  4. 04インストール後の検証
  5. 05エラー報告に関する任意の同意

活用シーン

  1. 01ButterCut 用の PC 環境の準備
  2. 02不足している依存関係の特定
  3. 03セットアップ後の ButterCut 検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/barefootford/buttercut --skill setup

インストール後、Claude Code で/setupを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

advanced-setup.md
simple-setup.md
windows-setup.md

詳細

スキル：セットアップ

ButterCut を使えるように、Mac または Windows PC をセットアップします。Mac では、ユーザーの希望に応じて 2 つのインストール方法を利用できます。

Step 0: 使用しているプラットフォームを確認します

uname -s
  • Darwin → macOS です。以下の Step 1 に進みます。
  • MINGW… / MSYS… / CYGWIN… → Windows（Git Bash）です。skills/setup/windows-setup.md を読み、手順に従ってください。独自の現在の状態を確認するフローがあるため、完了したら Step 5（エラー報告についての質問）に戻ります。
  • uname が見つからない → ほぼ確実に、Git for Windows がインストールされていない Windows の PowerShell です。windows-setup.md では、まず Git for Windows をインストールします。

Step 1: 現在の状態を確認します

（macOS の手順です。Windows マシンでは Step 0 で windows-setup.md の手順を実行しています。）以下の各チェックを実行します。依存関係が存在する場合、各コマンドは終了コード 0 を返します。失敗した項目を記録してください。セットアップでインストールが必要な項目です。

  • Xcode CLI Tools — xcode-select -p（修正方法：xcode-select --install）
  • Homebrew — which brew（修正方法：https://brew.sh を参照）
  • Ruby 3.3.x — ruby --version | grep -q 'ruby 3\.3'（修正方法：Ruby 3.3.6 をインストールします。.ruby-version を参照）
  • Bundler — which bundle（修正方法：gem install bundler）
  • Python 3.12.x — python3 --version | grep -q 'Python 3\.12'（修正方法：Python 3.12.8 をインストールします。.python-version を参照）
  • FFmpeg — which ffmpeg（修正方法：下記のセットアップファイルにある FFmpeg のインストール手順を参照してください。homebrew-ffmpeg/ffmpeg tap 版のビルドが必要です）
  • FFmpeg drawtext フィルター — ffmpeg -hide_banner -filters 2>/dev/null | grep -q ' drawtext '（修正方法：標準の brew install ffmpeg フォーミュラでは drawtext が含まれないことがよくあります。セットアップファイルを参照して、homebrew-ffmpeg/ffmpeg tap 版のビルドに置き換えてください）
  • WhisperX — which whisperx || test -x ~/.buttercut/whisperx || test -x ~/.buttercut/venv/bin/whisperx（修正方法：以下のセットアップ手順を参照）
  • Gem のインストール — bundle check（修正方法：buttercut ディレクトリで bundle install を実行）

すべてのチェックに合格した場合は、準備ができたことをユーザーに伝え、終了します。

Step 2: ユーザーの希望を尋ねます

依存関係が不足している場合は、AskUserQuestion を使用します。

Question: "How would you like to install ButterCut?"
Header: "Install type"
Options:
  1. "Simple (recommended)" - "Fully automatic setup. We'll install everything for you using sensible defaults."
  2. "Advanced" - "For developers who want control. You manage Ruby/Python versions with your preferred tools."

Step 3: 適切なセットアップを実行します

ユーザーの選択に応じて、次の手順に従います。

  • シンプル：skills/setup/simple-setup.md を読み、手順に従います
  • 詳細：skills/setup/advanced-setup.md を読み、手順に従います

Step 4: インストールを確認します

セットアップが完了したら、Step 1 のチェックリストをもう一度実行し、結果をユーザーに報告します。

Step 5: エラー報告について尋ねます

ruby lib/buttercut/report.rb consent の出力が error_reporting=unset の場合に限ります。それ以外の場合、ユーザーはすでに回答しているため、何も変更しません。

skills/report-bug/SKILL.md の手順 2 にある 2 つの質問を、クラッシュではなく新規インストール向けの表現にして尋ねます：「ButterCut でエラーが発生することがあります。チームが修正できるよう、エラーを送信してもよいですか？」回答は、libraries/settings.yaml の error_reporting: と error_report_email: を設定して保存します。

質問はこの 2 つだけにして、先に進みます。ユーザーが初めて編集を始めるまでに残された最後の手順です。

コメント

Markdown 対応