バグ報告ワークフロー

目標

エンジニアが初回で再現できるバグ報告を作成する。

出力パッケージ

• 注釈付きスクリーンショット 1 枚
• 短い再現手順リスト 1 つ
• オプション：10〜30秒の録画（macOS/Windows のみ；Linux beta ではスキップ）

ワークフロー

1. 一度再現して状態を固定

• 問題を再現します。
• 正確な壊れた状態で止めます。
• 期待する動作と比較する必要がある場合は、両方の状態をキャプチャしてピン留めします。

2. 証拠をキャプチャ

1. F2 を押してキャプチャします。
2. 周囲のコンテキスト（ツールバー、タブ名、ステータスエリア）を含めます。
3. 過度なトリミングを避け、再現に必要な手がかりを含めます。

3. 診断のために注釈を付ける

1. ステップバッジ を使って手順（1、2、3）をマークします。
2. 矢印 を使って障害箇所を指し示します。
3. テキスト を使って簡潔な事実を追記します：エラーコード、予期しない値、タイムスタンプ。
4. モザイク を使ってプライベートなトークンやユーザーデータを隠します。

4. エクスポートして明確な名前を付ける

以下のような構造化された名前で保存します：

bug-login-timeout-win10-2026-02-24.png

5. オプション：短い証拠動画を録画

問題がタイミングやアニメーションに依存する場合は、macOS/Windows でのみ録画します。Linux beta には録画が含まれていないため、このステップはスキップしてください。

1. トレイメニューからフルスクリーン録画を開始するか、snaptray record start を実行します。
2. 10〜30秒録画します。
3. 停止して MP4 としてエクスポートします。

バグ報告テンプレート

タイトル：[プラットフォーム] 問題の簡単なまとめ

環境：
- アプリバージョン：
- OS：

再現手順：
1. ...
2. ...
3. ...

期待する動作：
実際の動作：

添付ファイル：
- screenshot.png
- recording.mp4 (オプション、macOS/Windows のみ)

品質チェックリスト

• 再現手順が確定的である。
• スクリーンショットに問題とコンテキストの両方が含まれている。
• 注釈で手順と影響が説明されている。
• プライベートなデータがマスクされている。

次のチュートリアル

修正作業中に仕様やバグのスクリーンショットを画面に表示したままにするには ピン留めで常時参照 を使用してください。