無料相談→
  1. ホーム
  2. コラム
  3. AIで自作した業務システムを保守会社へ引き継ぐには|相談前の整理
コラム 保守運用
公開日

AIで自作した業務システムを保守会社へ引き継ぐには | 相談前の整理

AIで作ったシステムについて、動いているもの・業務のルール・未確認のことを担当者と専門家が整理する図

この記事の要約

AIで作った業務システムでも、保守を外部に相談できる場合はあります。引き受けられるかは、使ったAIツールの名前だけでは決まらず、実際に動いているコードや環境の確認が必要です。相談の前にすべてを調べ終える必要はありません。分かることと未確認のことを一枚のメモに分けて整理しましょう。

結論:AIで作ったかより、実際に動いているものを確かめる

AIで作った業務システムでも、保守を外部に相談できる場合はあります。引き受けられるかどうかは、使ったAIツールの名前だけでは決まりません。実際に動いているコード、動いている場所、使っている権限を確かめたうえで判断することになります。

相談の前に、すべてを調べ終える必要はありません。分かることと未確認のことを分けて書けば、相談を始められます。「AIで作ったから危ない」「作り直すしかない」と、最初から決めつける必要もありません。

この記事で扱うシステム

ここで扱うのは、AIチャットやAI開発ツールに指示して作った、在庫・受注・日程管理などの業務アプリです。AIに言葉で指示しながらアプリを作り進める、「バイブコーディング」と呼ばれる方法も含みます。AIモデルそのものの開発や、チャットボットなどのAI機能をシステムに組み込む話は扱いません。なお、IPA(情報処理推進機構)は、ソフトウェア開発でのAIの活用例として、コードの生成・レビュー・テストなどを紹介しています。

AIとのやり取りだけでは、今動いているものを確認できない

AIとのやり取りや後から作った資料を、現在のコードと動いている環境に照らし合わせる図

AIとのやり取りの記録は、「何を頼んだか」を知る手がかりになります。ただし、それだけで「今、何が動いているか」を確認したことにはなりません。頼んだ内容が、そのまま今のシステムに残っているとは限らないからです。

たとえば、次のようなことが起こりえます。

  • 修正を何度も頼むうちに、似たファイルやフォルダがいくつもできる。どれが実際に使われているか、分からなくなる
  • AIに後から書かせた仕様書や説明書が、今のコードと合っていない
  • 締め日や承認の順番などの業務ルールを、AIが推測で補っている。会社で決めたことかどうか、見分けがつかない

AIに後から書かせた資料には、「AIが後で書いた資料」と印を付けておきましょう。AIに「今のシステムの説明を書いて」と頼んだ場合も同じです。AIが読み込んだファイルが、実際に動いているものと同じとは限りません。実際の動きと照らし合わせるまでは、参考情報として扱ってください。

GitHub Docsの「Review AI-generated code」では、AIが作ったコードについて、人がテストし、要件や、周りのコード・目的と合っているかを確かめる方法が説明されています。次の節の4つの観点は、この考え方を参考にした、この記事独自の整理です。

照らし合わせるのは、コード・版・実行環境・業務ルールの根拠

コード・版・実行環境・業務ルールの根拠を四つのカードで整理した図

AIの説明と照らし合わせたいのは、次の4つです。分からない項目は「未確認」のままで構いません。

  • コード:実際に動いているファイルがどこにあるか。自分のPC、共有フォルダ、サーバー、サービスの画面上など、置き場所を確かめます
  • 版:今動いているのは、いつ時点のものか。変更の記録が残っているか。ファイル名に「最新」や日付が付いていても、それが使われている版とは限りません
  • 実行環境:どこで、誰のアカウントで動いているか。メールや決済など、つながっている外部のサービスは何か
  • 業務ルールの根拠:締め日、承認の順番、在庫の引き当てなどを、誰がなぜ決めたか。元になった紙やExcelがあるか

特に業務ルールの根拠は、コードを見るだけでは分からないことがあります。コードには「どう動くか」は書かれていても、「なぜそう決めたか」までは書かれていない場合があるからです。

もう一つ注意したいのが、パスワードやAPIキーなどの秘密の値です。コードを確認していて直接書き込まれた値が見つかっても、中身はメモにもAIにも貼らず、「ありそう」「分からない」と伝えてください。実際の共有方法や必要な権限は、確認担当者と相談して決めます。

ソースを書き出せないサービスは、調べられる範囲を先に共有する

AIアプリ作成サービスを利用している場合は、ソース(プログラムの元になるファイル)を書き出せるかを確認してください。できることはサービスや契約の内容によって違うため、利用中のサービスの説明を確かめます。書き出せない場合や、一部しか取り出せない場合は、その条件も相談先へ伝えます。

ソースを見られない場合は、サービスが用意している機能と、付与できる権限の範囲で調べることになります。たとえば、画面の設定、データの書き出し、外部サービスとの連携の設定などです。

相談の最初に「調べられる範囲に限りがある」と共有しておくと、お互いの見込みがそろいます。あわせて、アカウントの持ち主と、サービスを契約している人を確かめてください。担当者の個人アカウントで作った場合は、特に大切です。使い続けるか、別の形に移すかは、調べた後に決めれば十分です。

相談前の一枚メモは「分かる」と「未確認」を分けて書く

システムの目的など八項目について、分かることと未確認のことを記入する保守相談メモ

相談の前に、次の項目を一枚にまとめておくと話が早く進みます。項目ごとに「分かる」か「未確認」かを書き添えてください。未確認の項目が多くても、そのまま相談して構いません。

  • システムの目的:何のための仕組みか
  • 使う人:どの部署の誰が使うか
  • 止まると困る業務:止まったときに、まず困る作業
  • 使ったAIツール:分かる範囲で。判断材料の一つにすぎません
  • 動いている場所:社内のPC、社内のサーバー、サービス上など
  • 最後に正常だった時期:おおよそで構いません
  • 今困っていること:起きていることを、そのままの言葉で
  • 触ってよい範囲:見てよいもの、触ってはいけないもの

パスワード、鍵、顧客の個人情報、取引先の情報は、このメモに書かないでください。

架空の記入例

次は説明のために作った架空の例です。実在の会社の事例ではありません。

システムの目的
受注の入力と、出荷予定の一覧(分かる)
使ったAIツール
AIチャットにコードを書いてもらった(分かる)
動いている場所
事務所の共有PC(分かる)
最後に正常だった時期
先月の締め処理のころ(未確認)
今困っていること
一覧の合計が合わない日がある(分かる)。値引きの計算方法を誰が決めたかは未確認

全部の項目を埋める必要はありません。この程度の書き方でも、相談の入り口になります。

専門家は中身を調べ、会社は業務の正解を決める

専門家が調べる内容と、会社が決める業務ルール・優先順位・止めてよい時間・今後の直し方を分けた図

保守を外部に頼むときは、調べる役と決める役を分けて考えると進めやすくなります。

専門家が調べることの例です。

  • 今動いている版の特定
  • コードとデータベースの点検
  • 使っている部品や、更新の状況
  • セキュリティの確認
  • 仕様の整理

会社が決めることの例です。

  • 業務ルールの正解(締め日や計算方法など)
  • 直す順番
  • 止めてもよい時間帯
  • 今後も社内でAIを使って直すかどうか

業務ルールの正解は、コードを読むだけでは決められません。AIが補った計算方法が会社のやり方と合っているかは、会社にしか判断できないからです。根拠が未確認なら、専門家がコードから締め日や値引きの計算などの決まりを洗い出し、会社に確認を求める進め方があります。会社はその一覧を見て、どれが正しいかを決めます。

社内でAIを使った開発を続けながら、点検や更新を外部と分担する形もあります。Ouverでの対応内容は、記事末尾の案内とサービスページで確かめられます。

保守契約の分担や費用の考え方、担当交代のときの確かめ方、納品物と権限の受け取り方は、下の関連記事で説明しています。

よくある質問

AIで作ったシステムでも、保守を頼めますか?
頼める場合はあります。引き受けられるかどうかは、使ったAIツールの名前だけでは決まりません。ソースや動いている環境、権限を確かめる必要があります。まずは分かる範囲の情報で相談してみてください。
設計書や仕様書がなくても相談できますか?
相談はできます。設計書がない場合は、実際に動いているコードや画面、データから仕様を整理していくことになります。業務ルールの元になった紙やExcelがあれば、手がかりになります。
自分でコードが分からなくても大丈夫ですか?
相談の段階では、コードを理解している必要はありません。システムの目的、止まると困る業務、動いている場所など、業務の側で分かることを伝えてください。コードの中身は専門家が確かめます。
AIに書かせた仕様書は、引き継ぎの資料として使えますか?
参考にはなります。ただ、今のコードと合っているとは限りません。「AIが後で書いた資料」と分かるようにして渡し、実際の動きと照らし合わせてから使うようにしましょう。
AIで作ったシステムは安全ですか?
AIで作ったかどうかだけでは、安全かどうかは判断できません。秘密の値の扱い、権限の設定、使っている部品の更新の状況などは、点検してみないと分かりません。気になる場合は、点検を相談してください。
保守を頼んだ後も、社内でAIを使って直してよいですか?
社内での開発を続けながら、保守を分担する形もあります。その場合は、誰がどこを変えたかを互いに分かるようにしておくことが大切です。変更の伝え方は、保守を始める前に決めておきましょう。

コラム一覧に戻る

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

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