プログラムの不具合相談で、最初に伝えると助かる5つのこと

「エラーが出るけれど、何を伝えればよいかわからない」

プログラムの修正を相談するとき、専門用語で説明する必要はありません。まずは次の5つが分かると、状況を整理しやすくなります。

1．本来どうなってほしいか

「ボタンを押すとCSVを保存したい」など、期待する結果を教えてください。

2．実際にどうなっているか

「何も起きない」「空のファイルができる」など、目に見える状態をそのまま書いていただければ大丈夫です。

3．どんな手順で起きるか

起動してから問題が起きるまでの操作を、順番に並べてください。毎回起きるのか、ときどき起きるのかも手がかりになります。

4．エラーの全文と実行環境

エラーが出た場合は、最後の1行だけでなく、表示されたメッセージ全体が役立ちます。PythonやJavaScriptのバージョン、OS、実行方法も分かる範囲でお知らせください。

5．確認に使えるコードやサンプルデータ

問題を再現できる小さな例があると、調査する範囲を絞れます。パスワード、APIキー、個人情報は含めず、必要に応じて架空のデータに置き換えてください。

【そのまま使える相談テンプレート】

使用言語・バージョン：

OS・実行方法：

期待する動作：

実際の動作：

再現手順：

エラーメッセージ：

変更してよい範囲：

希望納期：

すべてを最初から埋める必要はありません。分かる範囲をまとめていただければ、必要な確認事項を整理できます。

私は、小規模なプログラム修正や作業自動化について、ココナラ内のメッセージを中心に対応しています。文章と資料で状況を共有し、作業範囲と納期を確認してから進めます。