こんにちは！Kredo Blog編集部です！
不具合の様子は分かるのに、英語にすると「It doesn’t work.」で止まってしまう。詳しく伝えたつもりでも、「こちらでは再現しません」と返ってきて困ることがあります。
まずそろえたいのは、件名・再現手順・期待結果・実際の結果・環境の5項目です。この記事では、学習時間メモの不具合を使って報告文を書き、追加質問への回答と修正後の確認まで練習します。後半には、相手と結果が違うときの返信を考える3問も用意しました。
英語のバグ報告に必要な5項目
「It doesn’t work.（動きません）」だけでは、画面が開かないのか、保存できないのか、結果が間違っているのか分かりません。次の5項目を埋めると、調べる場所を絞れます。
表は横にスクロールできます。
| 項目 | 書くこと | 今回の例 |
|---|---|---|
| Title / Summary 件名・概要 |
どの操作で何が起きるか | 時間が空欄でも記録が保存される |
| Steps to reproduce 再現手順 |
開始状態と、押した順番 | 内容を入力→時間を空欄→保存 |
| Expected behavior 期待する動作 |
本来どうなるか | 保存せず、時間の入力を促す |
| Actual behavior 実際の動作 |
画面で確認したこと | 0分の記録が一覧に追加される |
| Environment 環境 |
アプリ版、OS、ブラウザなど | 教材v0.1、macOS、Chrome |
報告先に指定のテンプレートがある場合は、その項目に沿って書きます。GitHubにも、リポジトリ側で用意したIssueテンプレートや入力フォームを選んで問題を報告する仕組みがあります。出典：GitHub公式：Issueの作成。
練習する不具合を、日本語で整理する
ここで使う学習時間メモは、記事用に制作したダミーアプリです。不具合の動作は実際に確認し、英語の報告・会話はその動作に基づく練習用の例文として作成しています。
同じアプリで動きを確かめたい方は、AIアプリのテスト方法とダウンロード教材を使って練習できます。
英語にする前に、操作を日本語で短く書いてみましょう。今回の教材では、学習時間は1〜1440分の整数だけを保存するというルールにしています。
- 学習時間メモのv0.1を開き、記録がない状態にする。
- 学習内容に「英単語の復習」と入力する。
- 学習時間は空欄のままにする。
- 「保存する」を押す。
期待結果：記録を追加せず、学習時間を入力するよう案内する。
実際の結果：「保存しました。」と表示され、「英単語の復習 / 0分」が追加される。
この操作は2026年10月5日に、macOSのChrome、ローカルHTTP環境で確認しました。この時点で他のブラウザやスマートフォンでは確認していません。報告文にも、試していない環境を「同じ問題が起きる」と書かないようにします。
英語のバグ報告例と、伝わる表現の使い方
件名は「何をしたら、何が起きたか」に絞ります。本文では画面上のボタンや表示をそのまま引用すると、相手が探しやすくなります。日本語UIなら、日本語の文字列を残して英訳を添えて構いません。
Title: A study record is saved when the duration is empty
Environment:
- App: Study Time Memo, v0.1
- OS: macOS
- Browser: Chrome
- Page: Local test page
Steps to reproduce:
1. Open v0.1 with no records in the list.
2. Enter "英単語の復習" in the study topic field.
3. Leave the duration field empty.
4. Click "保存する" (Save).
Expected behavior:
The app should show a validation message and should not add a record.
Actual behavior:
The app shows "保存しました。" (Saved.) and adds a record with 0 minutes.
Impact:
A user can create a record without entering a study duration.
Other environments:
I have not tested other browsers or mobile devices yet.実務で提出するときは、OSやブラウザの正確なバージョン、対象ページ、必要なログなど、報告先が求める情報も追加してください。上の例では、この教材の確認で把握している範囲だけを書いています。
この報告には、まだ原因の断定がありません。利用者が見た事実だけでも、問題を調べ始める材料になります。「保存処理が壊れているはずだ」と推測を事実に混ぜる必要はありません。
ここからは、報告例に使った表現を目的ごとに整理します。
操作は Enter / Leave / Click で順に書く
再現手順は、1文に操作を詰め込まず、1行に1操作で書きます。今回なら次の3つで大部分を説明できます。
| 英語 | 意味・使い方 |
|---|---|
| Enter “30” in the duration field. | 時間の欄に30を入力してください。 |
| Leave the duration field empty. | 時間の欄は空欄のままにしてください。 |
| Click the Save button. | 保存ボタンをクリックしてください。 |
| Reload the page. | ページを再読み込みしてください。 |
| Open the page in another browser. | 別のブラウザでページを開いてください。 |
スマートフォンの画面に触れる操作なら、Clickの代わりにTapを使えます。環境を説明したうえで、実際の操作に合う言葉を選びましょう。
ExpectedとActualを、同じ対象で比べる
期待結果を「使いやすくなる」、実際の結果を「0分が保存された」と書くと比較しづらくなります。両方とも、保存されるか、表示されるかといった同じ動作で書きます。
Expected: The app should not add a record when the duration is empty.
時間が空欄のときは、記録を追加しないはずです。
Actual: The app adds a record with 0 minutes.
実際には、0分の記録を追加します。
画面がエラーで止まった場合は、その文言も添えます。「an error occurred」とだけ書くより、表示されたエラーをそのまま記録したほうが、相手が手がかりを探しやすくなります。
未確認のことは、未確認と書く
| 伝えたいこと | 英語の例 |
|---|---|
| 原因はまだ分からない | I’m not sure what causes this yet. |
| Chromeでだけ確認した | I have only tested this in Chrome so far. |
| スマートフォンでは未確認 | I haven’t tested this on a mobile device yet. |
| 今回は再現しなかった | I couldn’t reproduce the issue in this test. |
| 条件を教えてほしい | Could you share the steps you followed? |
「今回は再現しなかった」と「問題が存在しない」は意味が違います。試した条件を添えると、確認範囲を正確に伝えられます。発生頻度を書くときも、実際に数えた回数だけを書いてください。
追加質問への回答と、修正後の報告
バグ報告は送って終わりではありません。別の条件でも起こるか、入力を変えるとどうなるかを聞かれることがあります。以下は、教材で確認した動作を使った練習用のやり取りです。
「30分を入力しても起こりますか？」
質問：Does this also happen when you enter 30 minutes?
回答：No. When I enter 30, the app saves a record with 30 minutes. The problem occurs when I leave the duration field empty.
日本語：いいえ。30を入力すると、30分の記録が保存されます。時間を空欄にしたときに問題が起きます。
この回答は空欄の問題について答えたものです。0や負の数、小数を入れた場合も試したなら、その結果は別に追記できます。1つの回答に別の不具合まで詰め込まないほうが、確認しやすくなります。
「再読み込みしても記録は残りますか？」
質問：Does the record remain after you reload the page?
回答：No. I saved a 30-minute record and reloaded the page. The list was empty afterward. I’ll report that as a separate issue.
日本語：いいえ。30分の記録を保存して再読み込みすると、一覧が空になりました。これは別の問題として報告します。
空欄が保存される問題と、再読み込みで記録が消える問題は、直す場所も確認手順も異なります。別の報告にすると、どちらが直ったかを追いやすくなります。
修正依頼と「直った」の報告は、確認範囲まで書く
修正を頼むときは、期待する動作を丁寧に伝えます。相手の書き方や能力への評価を入れる必要はありません。
Could you add validation so that an empty duration is not saved?
空欄の時間を保存しないよう、入力チェックを追加していただけますか。
Please keep the existing behavior for valid values such as 30.
30のような正しい値を保存する動作は維持してください。
直したと連絡を受けたら、最初の報告と同じ操作を行います。教材のv0.2では空欄の保存を止め、入力案内が出ることを確認できました。30分の正常な保存も確かめた場合、次のように返せます。
Thanks for the fix.
I retested the empty-duration case in v0.2 using Chrome on macOS.
The app now shows a validation message and does not add a record.
I also confirmed that a valid value of 30 minutes can still be saved.
I haven't tested other browsers yet.「修正ありがとうございます。v0.2で空欄のケースを再確認しました。案内が表示され、記録は追加されません。30分は引き続き保存できます。他のブラウザは未確認です」という意味です。何を確かめたかが分かるので、単に「Fixed!」と返すより、次の判断に使いやすくなります。
自分で書くバグ報告テンプレート
次は、別の不具合を報告してみましょう。「30分を保存すると一覧に出るが、再読み込みで消える」というv0.1の問題が課題です。
Title:
Environment:
Steps to reproduce:
1.
2.
3.
Expected behavior:
Actual behavior:
What I have checked:
What I have not checked yet:件名の解答例：A saved study record disappears after reloading the page.
期待結果の解答例：The 30-minute record should remain in the list after a reload.
実際の結果の解答例：The list is empty after I reload the page.
書き終えたら、相手が同じ操作をできるか、期待結果と実際の結果が区別されているか、試していないことを断定していないかを確かめます。英文の短さよりも、必要な情報が抜けていないことを優先してください。
AIに英文を整えてもらうなら、「確認していない情報や原因を追加せず、事実と意味を変えずに校正してください」と伝えましょう。スクリーンショットやログを添える際は、他人の情報や認証情報が混ざっていないかも確認します。
再現しないと言われたら、試した条件をそろえる
「I couldn’t reproduce it.（再現できませんでした）」と返ってきたら、どちらが正しいかを決める前に条件を並べましょう。アプリの版、入力値、開始時のデータ、操作順、OSやブラウザを一つずつ照合すると、次に何を確かめるかが見えてきます。
Mozillaのバグ報告ガイドも、再現手順・期待結果・実際の結果を具体的に示し、観測した事実と推測を区別するよう案内しています。時々しか起きない場合には、その状況を補足します。出典：Mozilla：Bug Writing Guidelines。
ここからの3問は、返信の練習用に作った状況です。アプリ・環境・回数は問題文の設定で、前半の学習時間メモの実測結果ではありません。先に自分の英文を考えてから、例と比べてみてください。
1. 自分は5回中2回、相手は3回中0回
架空のメモアプリv1.2で、メモを入力してSaveを押したときのエラーを報告しています。自分はWindows 11のChromeで5回中2回発生。相手はmacOSのFirefoxで3回試し、発生しませんでした。ブラウザの正確なバージョン、開始時のデータ、細かい操作手順はまだ照合していません。
書いてみよう：自分の結果を伝え、相手と照合したい情報を質問してください。Chromeが原因、発生率は常に40%とは断定しません。
Thanks for checking.
I saw the save error in 2 out of 5 attempts using Chrome on Windows 11 with app v1.2.
You reported no error in 3 attempts using Firefox on macOS.
Could we compare the exact steps, the starting data, and the browser versions?
We have not identified the cause yet.確認へのお礼→自分と相手の試行結果→照合したい条件→原因は未特定、という順番です。
気をつけたい点：OSや開始状態も異なり、原因は特定できません。2/5は今回の観測回数で、いつでも同じ割合になる保証ではありません。
2. 「Save doesn’t work」だけ届いた
架空のアプリについて「Save doesn’t work.」という連絡だけが届きました。入力値、押すまでの手順、期待結果、実際の画面、アプリ版・OS・ブラウザは不明です。まだ自分では試していません。
書いてみよう：相手が答えやすいよう、操作と結果を先に質問し、環境の確認を続けてください。エラーや原因を補ってはいけません。
Could you share the steps you followed, including the values you entered?
What did you expect to happen, and what happened instead?
Please also share the app version, OS, and browser version.
If a message appeared, could you include its exact text?入力値を含む手順、期待と実際、環境の順に尋ねます。「もし表示されたら」と条件を付け、エラー表示があったと決めつけません。
気をつけたい点：サーバー障害は未確認です。調査していない段階で原因や修正期限を約束しません。
3. 広い画面では直ったが、390pxでは残る
架空のお問い合わせフォームv1.2の修正確認です。Windows 11のChromeで、ブラウザの表示領域を1280pxにすると送信ボタン全体が見えました。390pxではボタン右端が欠けています。他の幅・ブラウザ・実機スマートフォンは未確認です。
書いてみよう：直った範囲と残った問題を分け、次の確認を頼んでください。「スマホ全部で不具合」「すべて修正済み」とは書きません。
Thanks for the update.
In form v1.2 using Chrome on Windows 11, the full submit button is visible at a viewport width of 1280px.
At 390px, the right edge is still clipped.
Could you check the narrow layout?
I have not tested other widths, other browsers, or physical mobile devices yet.同じフォーム・ブラウザで幅を変えた結果です。390pxの表示領域での確認と、実機スマートフォンでの確認は区別します。
気をつけたい点：確認結果は一部の条件に限られます。PCの狭い表示領域だけで、すべてのスマートフォンの結果は分かりません。
入力できる練習シートで、別の言い方も試す
英語バグ報告・条件確認の練習教材をダウンロード（ZIP）して展開し、index.htmlをブラウザで開いてください。自分の返信を書き、「解答例を見る」で比較できます。同じページを開いている間は、問題を切り替えても回答を保持します。再読み込みや終了で消えるので、残したい英文は手元のメモへコピーしてください。
解答例は唯一の正解ではありません。「事実を変えていないか」「未確認を明記したか」「次に何を頼むかが分かるか」を自分で確認する教材です。自動採点やAI添削は行いません。解答付きのテキストと、条件を並べて記入するCSVも同梱しています。
よくある質問
英語が苦手でもバグ報告はできますか？
短い文で、操作・期待結果・実際の結果を分けるところから始められます。まず日本語で事実を書き、Enter、Click、The app showsのような型に当てはめてください。文法を整えるときも、入力値やエラー文は勝手に変えないようにします。
bug、error、issueはどう使い分けますか？
bugはソフトウェアの不具合、errorはエラーや誤りを指すときに使います。issueは問題や検討事項を広く扱う言葉です。GitHubのIssueには、不具合以外の依頼や作業も含まれます。原因が分からない段階でも、件名に実際の症状を書けば報告を始められます。
原因が分からないと報告できませんか？
原因を特定できていなくても報告できます。再現手順と画面で確認した結果を示し、推測する場合は「原因かもしれない」と分かる書き方にします。確認した事実と推測を混ぜないことが大切です。
スクリーンショットだけ送れば十分ですか？
画面は役立ちますが、その状態になった手順や期待結果も添えましょう。画像だけでは、何を入力し、どの順番で操作したのかが分からない場合があります。
まとめ：事実をそろえて、短い英語で伝えよう
今回のように1つの問題を報告して、質問に答え、修正を確かめるまで進めると、英語を使う目的がはっきりします。まずは自分のアプリの動きを、日本語と英語でそれぞれ短く説明してみてください。
授業中の聞き返しにはプログラミング授業で使える英語フレーズ、継続的な練習にはエンジニアの英語勉強法、説明を読む練習には英語の公式ドキュメントを読む5手順も役立ちます。
英語を使いながらAIを学びたい方へ
KredoのAI留学では、英語でAIを学び、作ったものを英語で発表する機会があります。参加前の英語の準備は、AI留学に必要な英語力と苦手な人の準備で紹介しています。
英語でIT・AIを学べるKredo
英語×IT・AIのスキルを身につけてグローバルに活躍しませんか？
当メディアを運営しているKredoは、英語×ITをオンラインで学ぶ「Kredoオンラインキャンプ」と、フィリピンのセブ島で英語とIT・AIを学ぶ「KredoIT留学」「KredoAI留学」を提供しています。これまでの卒業生は3,000名以上。卒業生の多くが、国内外のIT企業への転職、フリーランスなどへのキャリアチェンジを実現しています。これからの時代に必要な英語×IT・AIのスキルを身につけてグローバルに活躍しませんか？
