業務効率化くんシリーズ / 画面録画くん / コラム
不具合の報告は画面録画で(伝わるバグ報告の書き方テンプレート)
2026年9月30日 公開
- 不具合の報告は、件名・再現手順・期待した結果・実際の結果・環境と日時の5つを書きます。
- 再現手順は、1行に1操作で番号を振ります。
- 起きる所までの画面録画を添えると、書き忘れた操作まで伝わります。
そのまま使える不具合報告のテンプレート(6項目)
この記事は、社内のシステムや自社のWebサイトで不具合が出て、開発会社やサポートに伝える人に向けて書いています。
エンジニアでなくても書ける形にしました。
開発側が知りたいのは、同じことを自分の画面で起こせるかです。
下の6項目を埋めれば、その材料がそろいます。
| 項目 | 書くこと | 例 |
|---|---|---|
| 1. 件名 | どの画面で・何をすると・どうなるか | 請求書の画面で、保存を押すとエラーが出る |
| 2. 再現手順 | 起きるまでの操作を、1行1操作で番号付きに | 1. ログインする 2. 請求書の新規作成を開く 3. 金額に10000と入れる 4. 保存を押す |
| 3. 期待した結果 | 本来どうなるはずだったか | 保存されて、一覧に1件増える |
| 4. 実際の結果 | 実際に起きたこと。エラーの文言はそのまま | 「保存に失敗しました」と出て、一覧に増えない |
| 5. 環境と日時 | パソコン・ブラウザと版・起きた日時・頻度 | Windows 11/Chrome/9月30日 10時15分ごろ/3回やって3回とも |
| 6. 画面録画 | 手順の最初から、エラーが出るまでを録ったURL | 起きる所までを1分で録りました(URL) |
チャットやメールに貼る時は、次の形をそのまま使えます。
【件名】
【再現手順】
1.
2.
3.
【期待した結果】
【実際の結果】
【環境と日時】パソコン: ブラウザ: 日時: 頻度:毎回/時々
【画面録画】URL:
- 1つの報告に1つの不具合だけ書きます。
2つあれば2通に分けます - 急ぎかどうか(仕事が止まっているか)も1行添えると、順番を決めてもらいやすくなります
PR画面録画くんでできること(30秒)
再現手順の書き方(1行1操作・最初の画面から)
いちばん抜けやすいのが再現手順です。
「保存できません」だけだと、開発側はどこから試せばいいか分かりません。
| 伝わらない書き方 | 伝わる書き方 |
|---|---|
| 保存ができません | 請求書の新規作成で、金額を入れて保存を押すと、エラーが出ます |
| いろいろ入力したら止まった | 取引先名に「株式会社ABC」、金額に「10000」と入れました |
| さっきから変です | 今日の10時ごろから。昨日までは同じ操作で保存できていました |
| 画面を開いて保存したら | 1行に1操作。「開く」と「保存」は別の行に分ける |
- ログインした所から書くどのメニューから、どの画面を開いたかを最初に書きます。
- 入れた値をそのまま書くどんな文字や数字を入れたかで、起きるかどうかが変わることがあります。
- 書いた手順で、もう一度やってみる同じことが起きるかを確かめます。
毎回か時々かも書きます。
もう一度やっても起きない時は、「1回だけ起きた」と正直に書きます。
その時の画面録画があれば、大きな手がかりになります。
期待した結果・実際の結果と、環境の調べ方
期待した結果と実際の結果は、並べて書くと差がはっきりします。
仕様の勘違いだった時も、ここで開発側がすぐ気づけます。
エラーの文言は、要約せずにそのまま写します。
長い時は、画面録画で読めれば大丈夫です。
環境は、次の場所で確かめられます。
| 知りたいこと | 確かめる場所 |
|---|---|
| Windowsの版 | Windowsキーを押しながらRを押し、winverと入れてEnterキー(またはOK) |
| Macの版 | 画面左上のアップルメニュー(リンゴのマーク)→ このMacについて |
| Chromeの版 | 右上の⋮ → 設定 → Chrome について |
| Edgeの版 | 右上の… → 設定 → Microsoft Edge について |
| 起きた日時 | エラーが出た時の時刻をメモ。画面録画を録った時刻でも可 |
メニューの名前は、版によって少し違うことがあります。
画面録画を添えると早い理由と、録り方のコツ
文章で書いた手順は、書いた人には当たり前の操作が抜けがちです。
画面録画なら、書き忘れた操作も映ります。
| 文章だけ | スクリーンショット | 画面録画 | |
|---|---|---|---|
| エラーの文言 | 写し間違いが起きる | そのまま残る | そのまま残る |
| 起きるまでの操作 | 書き忘れが出る | 最後の1枚しか分からない | 最初から順に見える |
| 操作の流れ | 伝わりにくい | 伝わらない | 画面の変わり方で分かる |
- 手順の最初の画面から録るエラーの画面だけでなく、ログイン後の画面から録り始めます。
- 操作を口で言いながら録る「ここに10000と入れて、保存を押します」と言うと、見る側が止めて確かめやすくなります。
- エラーが出たら、数秒そのまま映すすぐ閉じずに、文言が読めるまで止めておきます。
- 1本は短く起きる所までの1〜2分で十分です。
1本に1つの不具合だけ入れます。
録画の用意に時間がかかる時は、文章の再現手順だけ先に送り、録画はあとから足してもかまいません。
録る前に隠すもの(パスワード・個人情報)
不具合の画面には、お客様の情報や社内の数字が出ていることが多いです。
URLは転送されることがある前提で、録る前に確かめます。
- パスワードを入れる場面は録らない。
ログインが済んでから録り始めます - お客様の名前・住所・電話番号が並んだ一覧は、見本のデータに替えるか、映さない
- メールやチャットの通知。
録る範囲を画面全体でなくタブにすると、ほかのアプリの通知は映りません(録っているページの中に出るお知らせは映ります) - 関係のないタブ・ウィンドウ・ブックマークの名前
テスト用の画面や見本のデータで同じ不具合が起きるなら、そちらで録ると安心です。
画面録画くんで録って、報告にURLを貼る
画面録画くんは、パソコンのブラウザ(Chrome・Edge)で、自分の顔と画面を一緒に録画して、URLで送れる道具です。
登録もインストールもいりません。
- 不具合が起きる画面の手前を開く上の隠すものを片付けて、手順の最初の画面を開きます。
- 録る範囲と顔の丸を選んで録る範囲はタブ・ウィンドウ・画面全体から選べます。
顔は右下の丸に入り、「背景ぼかしなし」「背景ぼかしあり」「カメラなし」から選べます。 - 止めて、URLをテンプレートの6番に貼る相手はURLを開くだけで、スマホでも見られます。
| 無料 | ライト(月980円・税込) | |
|---|---|---|
| 1本の長さ | 5分まで | 60分まで |
| 録れる本数 | 1日3本まで(同じネット回線の方と合わせて) | 1日の本数の制限なし |
| 残る期間 | 3日で自動で消える | 契約中は20GBまで保存 |
できないこともあります。
- スマホのブラウザでは録れません(見るのはできます)
- 無料の動画は3日で消えます。
対応に日数がかかりそうな時は、録った直後の画面でダウンロードしておくか、ライトで録ってください - 開発会社の管理ツールに直接つながる機能はありません。
URLを貼るか、ダウンロードしたファイルを添付します
録画そのものができない時は画面録画ができない時の直し方、チャットでの送り方は画面録画をチャットで送る方法を見てください。
不具合ではなく操作の説明や修正の依頼なら操作説明の動画の作り方が合っています。
よくある質問
バグ報告には何を書けばいいですか?
件名・再現手順・期待した結果・実際の結果・環境と日時の5つに、画面録画かスクリーンショットを添えます。
再現手順は1行に1操作で番号を付けます。
不具合の報告で、再現手順はどこまで細かく書けばいいですか?
ログインした所から、開いた画面・入れた値・押したボタンを1行ずつ書きます。
書いた手順でもう一度やってみて、同じことが起きるかを確かめると確実です。
一度しか起きなかった不具合は、報告しても意味がありますか?
意味があります。
1回だけ起きたことと、その日時・環境を書いて報告します。
その時の画面録画があれば、原因を探す手がかりになります。
不具合の報告は、スクリーンショットと画面録画のどちらがいいですか?
エラーの文言だけならスクリーンショットでも伝わります。
起きるまでの操作や順番が関係しそうな時は、画面録画の方が書き忘れた操作まで伝わります。
開発会社の担当者がスマホしか見られなくても、画面録画は見てもらえますか?
画面録画くんの場合、相手はURLを開くだけで、スマホでも見られます。
録画はパソコンのブラウザ(Chrome・Edge)で行います。
