mcpField
C
claude-vision-skill

claude-vision-skill

github.com/asuojunエージェントワークフロー2.3k63 回インストール6 日前に更新
リポジトリ

claude-vision-skill について

claude-vision-skillは、現在のモデルが画像入力に対応しない場合に、Node.jsスクリプトで画像を扱う手順をエージェントに示します。ローカルパス、URL、クリップボードに対応し、フォールバックと設定方法も説明します。

主な機能

  1. 01ローカル画像パスの処理
  2. 02リモート画像URLの処理
  3. 03クリップボード画像の読み取り
  4. 04パス不在時のフォールバック

活用シーン

  1. 01ユーザー提供のローカル画像の説明
  2. 02URLで共有された画像の分析
  3. 03パスが見えない貼り付け画像の処理

インストール

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

$npx skills add https://github.com/asuojun/claude-vision-skill --skill claude-vision-skill

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

同梱ファイル

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

AGENTS.md
.gitignore
README.md
cyberboss-setup.md
clipboard.ps1
CLAUDE.md
vision.js
clipboard.swift

詳細

Vision Helper

現在のモデルはネイティブの画像入力に対応していない可能性があります。ユーザーが画像のパスまたは URL を指定した場合、画像を直接見ようとせず、代わりに次を実行してください。

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js "<absolute image path>" "<prompt>"

画像 URL の場合:

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js --url "<image url>" "<prompt>"

ユーザーが画像をチャットに貼り付けたものの、ファイルのパスも URL も表示されていない場合:

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js --clipboard "<prompt>"

--clipboard はシステムのクリップボードから現在の画像を読み取ります(macOS では同梱の Swift ヘルパーを、Windows では同梱の PowerShell スクリプトを使用します。貼り付けた画像は通常、まだクリップボードに残っています)。失敗した場合は、画像をファイルに保存し、絶対パスを指定するようユーザーに依頼してください。

フォールバックのルール(自動):

  • ローカルパスが指定されているものの、ファイルが存在しない場合、vision.js は自動的にクリップボードにフォールバックします。
  • 画像のパスも URL も指定されていない場合、vision.js は自動的にクリップボードを試します。
  • --no-fallback を渡すと、この動作が無効になり、明示的なエラーが返されます。

ルール:

  • 常に vision.js の絶対パスを使用してください。
  • ローカルファイルには絶対画像パスを使用し、リモート画像には --url を使用してください。
  • ユーザーがアクセス可能なパスを指定せずに画像を貼り付けた場合は、--clipboard を優先してください。
  • ユーザーから別途指定がない限り、説明には中国語を使用してください。
  • 設定は vision.js と同じ場所にある .env に保存されています(DASHSCOPE_API_KEY、VISION_MODEL、DASHSCOPE_BASE_URL)。API キーを表示したり、コミットしたりしないでください。
  • API 呼び出しが失敗した場合は、エラーをユーザーに伝え、キー、モデル、またはベース URL を確認するよう依頼してください。

コメント