無料相談→
  1. ホーム
  2. コラム
  3. AIで直したシステムの変更を保守会社へ伝えるには|修正内容とテスト結果の残し方
コラム 保守運用
公開日

AIで直したシステムの変更を保守会社へ伝えるには | 修正内容とテスト結果の残し方

社内の担当者が、変更内容をまとめた一枚のメモを外部の保守担当に手渡している水彩イラスト

この記事の要約

一件の変更ごとに、受け渡しメモと確認対象の版をセットで渡します。目的・版・変更箇所・影響・確認結果・反映と戻しの6項目を残し、追加修正後は版と記録を更新して確認し直します。

社内でAIを使って業務システムを直し、レビューや運用を保守会社に任せる場合、何を渡せばよいのでしょうか。一件の変更を確かめてもらうための、修正内容とテスト結果の残し方を整理します。

結論:変更は「受け渡しメモ」と版をセットで渡す

一件の変更ごとに、受け渡しメモと、レビューしてほしい版をセットにします。メモには、目的、変更前後の版、変更箇所、データや設定への影響、人が確かめた結果と未確認、本番反映と戻しの担当を書きます。

長い報告書を作る必要はありません。チケットや共有文書にまとめ、変更の差分や確認記録へたどれるようにします。大切なのは、保守担当が見た版と、本番に出す版を同じにすることです。レビュー後に直したら、メモも更新して確認し直します。

レビューした版と本番に出す版がずれる理由

レビューを待つ間に、社内でAIに追加修正を頼むことがあります。そのまま本番に出すと、保守担当が見ていない変更まで含まれます。「少し見た目を直しただけ」でも、AIが別の画面や共通処理を変えているかもしれません。

GitHubのレビューでは、変更されたファイルや差分を見て、コメント、承認、修正依頼を行えます。ただし、その承認だけで本番への反映が済むわけではなく、安全性が保証されるわけでもありません。どの版を、どの範囲まで確認したかを共有する必要があります。

社内と保守会社の全体的な役割分担は、別の記事で整理しています。コラム自社開発システムの運用保守は外注できる?社内開発との役割分担

受け渡しメモに書く6つの項目

次の6項目は、この記事で提案する整理例です。GitHubなどが定めた公式の書式ではありません。

  1. 目的:誰のどんな困りごとを、どう変えたいのか。期待する動きを具体的に書きます。
  2. 変更前後の版:修正を始めた版と、レビューしてほしい版を示します。Gitを使っていればコミットやプルリクエストへのリンクを付けます。
  3. 変更箇所:画面、機能、ファイルの名前を挙げます。頼んだ範囲以外の変更が入っていないかも確かめます。
  4. 影響:データベース、設定、メールや決済などの外部連携が変わるかを書きます。分からなければ「未確認」とし、設定の秘密の値は載せません。
  5. 確認結果:誰が、いつ、どの環境と版で、何を操作し、どんな結果になったかを残します。期待した結果との違いや、未確認の項目も分けます。
  6. 反映と戻し:本番へ反映する人、反映後に確認する人、問題があれば戻すと判断する人、戻す先を決めます。

「テスト済み」だけでは、どこまで見たか分かりません。人が画面で確かめた記録を基本にし、自動テストがあればその対象と結果も添えます。スクリーンショットを使う場合は、顧客情報などを除いて必要な範囲を示します。

たとえば並び替えの確認なら、「一覧を開いた」だけでなく、「入荷日の降順になることを期待し、確認用データでその順序になった」と残します。期待と実際を分ければ、不具合なのか、業務側の期待が変わったのかも話し合いやすくなります。確認用環境と本番で設定が違う場合は、その違いも添えてください。

未確認が残る場合は、誰がいつ確かめるかを決めます。保守担当に調査を頼む項目と、社内で業務の正解を決める項目を分けると、同じ質問を何度も往復せずに済みます。

受け渡しメモの6項目(目的、変更前後の版、変更箇所、影響、確認結果と未確認、反映と戻しの担当)をアイコンで並べた図

架空の整理例:在庫一覧の並び順を変えた場合

以下は実案件の実績ではなく、架空の整理例です。社内から「新しく入荷した順に見たい」という要望があり、在庫一覧を直したとします。

目的
在庫一覧の初期表示を、入荷日の新しい順にする。
版と変更
確認対象は版B。在庫一覧の並び替えを修正。AIが別画面の表示も変えたため、その変更は戻した。
影響
差分でデータベースと設定の変更がないことを確認。外部連携の変更もなし。
確認
社内担当が確認用環境で、同じ日付を含むデータの並びを確認。スマホの表示は未確認。
反映
未確認項目を確かめてから保守担当が反映し、社内担当が業務の画面を確認する予定。

この記録なら、保守担当は変更の目的と残りの確認を把握できます。「動きました」という一文より、次に誰が何をするかが明確です。確認対象を版Bとした後に追加で直した場合は、この記録のまま先へ進めません。

AIチャットの要約だけを証拠にしない

AIが「修正しました」「ほかへの影響はありません」と答えても、実際のコードと一致するとは限りません。要約は説明文の下書きとして使い、変更の差分と人が確かめた結果で裏付けます。照合できていない内容は「AIの説明・未確認」と区別します。

確認記録には、成功した操作だけでなく、入力が空のときや、対象データがないときなど、今回の変更に関係する条件も残します。どこまで確かめるかは保守担当と相談し、見ていない条件を「問題なし」に含めないようにします。

チャット全文を送る必要はありません。秘密の値や個人情報が混ざっていないか確かめ、必要な箇所だけを共有します。整理のために、顧客データや認証情報をAIへ貼り付けないことも前提です。

AIチャットの要約と、実際の変更の差分や人の確認結果を見比べている様子の水彩イラスト

レビューの後に直したら、版を更新して確認し直す

レビューで修正依頼が出たり、社内で追加の変更をしたりしたら、変更後の版とメモを更新します。前に見てもらった版から何が変わったかを伝え、追加の確認を依頼します。古い版の承認やテスト結果を、新しい版にもそのまま当てはめません。

すべての確認を毎回同じ量でやり直すとは限りません。変更した箇所と、それが影響する機能から確認範囲を決めます。影響が分からない場合は、その判断自体を保守担当に依頼します。本番へ出す直前には、確認済みの版と反映対象を照合します。

修正を繰り返して終わらない場合は、通常の受け渡しとは別に立て直しが必要です。コラムAIで作ったシステムの修正が終わらないときは|変更履歴と確認の進め方

レビュー後に修正した場合、新しい版でもう一度確認してから本番に反映する流れを示した図

反映と戻しの担当を先に決める

レビューの担当と本番反映の担当が同じとは限りません。反映する人、時間、反映後に業務を確かめる人、問題時の連絡先をメモに残します。通常と違う結果が出たら、作業を続けるか、止めるか、戻すかを誰が判断するのかも決めます。

コードを前の版へ戻せば、データも戻るとは限りません。データの書き換えを伴う変更では、反映前のバックアップ、戻せる範囲、戻した後に失われる更新の扱いを確かめます。手順が分からないまま「戻せば大丈夫」とは決めません。

反映後は、実際に出した版、確認結果、残った課題を同じメモに追記します。これで次の変更を始めるときにも、現在の状態から確認できます。

本番への反映、反映後の確認、問題があったときに前の版へ戻す担当を分けて示した図

社内の改善を続けながら、レビューや運用を相談する

Ouverでは、社内開発を続けながら外部と保守を分担する相談を受け付けています。現在の構成と状態を確かめ、レビュー、改修、運用のどこを担当できるか整理します。引き受けられる範囲はシステムの状態によって異なります。

AIで作ったシステム・自社開発システムの保守引き継ぎ・改修サービスを見る

まとめ

一件の変更は、目的や影響をまとめた受け渡しメモと、確認対象の版をセットにします。AIの要約と、人が確かめた事実を分け、未確認はそのまま残します。追加で直したら版と記録を更新し、確認済みの版を本番へ出すところまでつなげましょう。

出典・確認日

よくある質問

Gitを使っていなくても、受け渡しメモは作れますか?
作れます。保守会社と保存方法や版の名前を決め、変更前と確認対象を区別できるようにします。日時だけで同じ内容と決めず、どのファイル一式を確認したかも残します。
AIとのチャット記録を、そのまま保守会社へ送ってよいですか?
必要な箇所を選び、個人情報や認証情報が含まれないか確認して共有します。チャットの説明だけでは変更の証拠にならないため、実際の差分や人の確認結果も添えます。
文字を一つ直した程度でも、メモは必要ですか?
短い記録でも、目的、対象の版、実際に変わった範囲、確認結果を残すと受け渡しやすくなります。AIが共通部分なども変えていないか確かめ、記録の詳しさは影響に合わせて決めます。
レビューで承認されたら、すぐ本番に反映できますか?
レビュー承認だけで判断せず、必要なテストや業務確認、反映する担当と時間、問題時の戻し方を確かめます。承認された版と実際に反映する版が同じかも照合します。
確認できなかった項目はどう書けばよいですか?
「未確認」とし、対象と理由、次に誰が確かめるかを書きます。AIが問題ないと述べても、人やテストで確かめていない項目を確認済みに変更しません。
レビュー後に追加で直したら、何をやり直しますか?
版とメモを更新し、前回からの差分を伝えます。変更箇所と関連する機能の確認を行い、影響が不明なら確認範囲の判断から保守担当へ依頼します。

コラム一覧に戻る

何から相談すればいいか分からない、でOK。

業務システムの新規開発・刷新、保守運用引き継ぎ、業務改善のご相談をお受けしています。何を相談すればいいか決まっていない段階でも構いません。