Mac で不具合報告用のスクリーンショットに注釈を付ける

必要最小限の範囲を撮影

問題と、それを判断できる周囲の情報を含めます。範囲撮影なら無関係なウインドウを避けられ、ウインドウ撮影なら対象アプリの境界を保てます。

既定では範囲撮影が Control–Option–S、ウインドウ撮影が Control–Option–W です。長いページは直接配布版のスクロール撮影も使えます。欠落や重複がないか結果を確認してください。

注目点を見つけやすくする

画像をエディタで開き、矢印ひとつか短い文字で注目点を示します。相手が見るサイズで読めるようにしましょう。

期待した動作と実際の動作は課題の説明に書きます。矢印は場所を示すだけで、再現手順の説明にはなりません。

1. 機密情報のないテストデータで、見えている不具合を撮影します。
2. 重要な箇所に短い注釈を加えます。
3. 画像の横に、再現手順、期待した動作、実際の動作を書きます。
4. 必要に応じて、アプリと macOS のバージョンを添えます。

共有前に書き出したファイルを確認

メールアドレス、トークン、顧客名、背景のウインドウを確認します。情報を隠すときは、実際の書き出しファイルを確認してください。装飾的なぼかしだけで秘密を復元不能にできるとは考えないでください。

あとで直す場合は編集可能なプロジェクトを非公開で保存します。元の情報が残る編集用文書ではなく、意図した書き出し画像を共有してください。

PNG、JPEG、HEIC、WebP、PDF に書き出せます。課題管理ツールが受け付ける形式を選んでください。文字を含むスクリーンショットなら、まずはロスレス PNG が適しています。

続報に使う画像を見つける

注釈付きの画像を一度貼り付けたら、別の無害な文字列をコピーしてみます。その後、Control–Option–V で履歴を開き、先ほどの画像を選んで Space で確認し、画像を受け付ける別の文書にもう一度貼り付けます。矢印や説明が残っていることまで確認すると、単に直前の画像を貼り付ける操作と、履歴から探して再利用する操作を分けて試せます。直接ペーストが動かない場合は、画像をコピーして貼り付け先で Command–V を使います。

撮影した画像を履歴に保存する設定と、クリップボードへコピーする設定は別々です。画像が見つからない場合は、この二つを確認してください。共有リンクをコピーした場合、履歴のリンクは画像そのものとは別の項目です。画像を貼り直す、共有リンクを送る、注釈を修正する、のどれが必要かを先に決めましょう。注釈を後で変更する場合は、編集可能なプロジェクトも手元に保存します。画像ホスティングへの送信は、設定したサービスへ自分でアップロードを選んだ場合だけです。

相手がローカル AI コーディングツールの場合

直接配布版では、選択した元画像の明示的な cliporigin://image/<SHA-256> 参照をコピーできます。ローカル MCP クライアントを設定・許可すると、その画像を取得できます。

クライアント接続は任意です。指定した元画像を共有するために履歴全体を許可する必要はありません。リモートやブラウザ専用のエージェントには別の転送が必要で、参照だけではローカルファイルを読めません。

プレビューを閉じた後に探す

スクリーンショットのプレビューは自動非表示にでき、最後の 10 秒にカウントダウンを表示します。操作中は非表示になりません。「最近のスクリーンショット」から開き直せます。「すべてのプレビューを閉じる」は履歴を削除しません。

よくある質問と回答