無料相談→
  1. ホーム
  2. コラム
  3. AIで作ったシステムに仕様書がないときは|現状を確かめて引き継ぐ方法
コラム 保守運用
公開日

AIで作ったシステムに仕様書がないときは | 現状を確かめて引き継ぐ方法

画面の動き、コードの実装、業務のルールを照らし合わせ、未確認を分けて仕様メモにまとめる図

この記事の要約

仕様書がないAI開発のシステムでも、止まると困る一つの業務から、引き継ぎの準備を始められます。実装・画面・業務の三つの根拠で今の動きを確かめます。確かめた内容は「確認した動き」「業務の正解」「差異・未確認」に分け、一業務一枚の仕様メモに残します。

AIに指示しながら作った業務システムに仕様書がなくても、引き継ぎの準備は始められます。全部の機能を一度に書こうとはしません。止まると困る一つの業務を選び、実装・画面・業務の三つの根拠から今の動きを確かめます。確かめた内容は「確認した動き」「業務の正解」「差異・未確認」に分けて、一業務一枚の仕様メモに残します。引き継ぐか、直すか、作り直すかは、そのメモを材料に比べて決めます。

AIの説明は「仮説」として扱う

ここでいう仕様とは、システムが何を受け取り、どう処理し、何を出すかの決まりです。仕様書がないシステムにも、今実際に動いている決まりはあります。この記事では、その決まりを確かめて書き出すことを目指します。

AIによる説明は下書きに使えます。ただし、読ませたコードの範囲が違ったり、後の修正や設定が反映されていなかったりすると、今の動きとずれます。資料をAIや外部へ渡す前に共有範囲と方法を確認し、パスワード・鍵・個人情報はそのまま貼り付けないでください。

GitHub Docsも、AI生成コードを人がテストし、要件や目的と照らし合わせることを説明しています。ここからの仕様メモは、その考え方を参考にした記事独自の整理です。AIの説明を出発点として、実際の根拠を集めます。

止まると困る一つの業務から確かめる

止まると困る一つの業務について、入力・処理・結果・例外を順に確かめる図

最初から全機能を対象にすると、確認が終わらず、途中で止まりがちです。まずは次のような業務から選びます。止まると日々の業務が回らないもの。お金や在庫の数字に関わるもの。やり方を知っている人が一人しかいないもの。

選んだら、その業務の始まりと終わりを決めます。ここからは、架空の会社の受注管理を例にします。この会社では、注文を受けてから出荷指示を出すまでを、一つの業務として扱うことにしました。入力は注文の内容、処理は受注金額の計算、結果は受注金額と出荷指示です。送料の免除のような例外も、この流れの中で拾います。

今回は対象から外した業務も、一覧に名前を残しておきます。外したことが分かるようにしておけば、確かめていない業務まで確認済みだと思い込むのを防げます。

実装・画面・業務の三つの根拠を見る

今の動きを確かめる手がかりは、主に三つあります。どれか一つだけでは見落としが出やすいので、分担して集めます。

実装:プログラムとデータの流れを追う

実装とは、実際に書かれたプログラムと設定のことです。コードのほか、データをためておくデータベースや、外部のサービスとのつながりも含みます。どの画面の操作がどのデータを書き換えるかを追うと、画面からは見えない計算や条件が分かります。社内にコードを読める人がいなければ、ここは専門家に頼んでかまいません。AIにコードを読ませた結果も、仮説として扱います。

画面:実際に操作して観察する

画面では、入力できる値、表示される内容、エラーが出る条件を確かめます。データを書き換える操作は、本番では行いません。権限と試す範囲を関係者で合意した別の環境で、テスト用のデータを使って行います。別の環境がない場合は、書き換える操作は試さず、見るだけの確認と聞き取りにとどめます。別の環境を用意するかどうかは、技術担当や専門家と決めます。確認のために本番の設定やデータを勝手に変えないことが前提です。見るだけの確認でも、誰のアカウントで、どの版を見たかを記録します。権限によって、見える画面が変わるからです。

業務:担当者の手順を聞き取る

担当者が実際にしている手順を聞き取ります。システムの外での手作業、Excelとの併用、例外のときの扱いは、実装や画面だけでは分かりません。「いつもこうしている」という話と「本来はこうするはず」という話は、分けて書き留めます。

確かめた内容を三つに分けて書く

確認した動き、業務の正解、未確認や差異を別々の欄に記録して比較する図

集めた内容は、次の三つに分けて書きます。

一つ目は「確認した動き」です。実装を読んだ結果、画面で観察した結果、担当者から聞いた内容を、出所が分かる形で残します。条件・対象の版・証拠も添え、聞き取りは担当者の説明として区別します。根拠の数だけで正しさを決めず、裏付けが十分か、業務として正しいかを別に判断します。

二つ目は「業務の正解」です。会社として既に決まっている業務のルールを書きます。決めるのは業務の責任者です。「今後こうしたい」という追加の要望は、ここに混ぜず、別の一覧に分けます。混ぜてしまうと、今のシステムが守るべき決まりと、これから足したいことの区別がつかなくなります。

三つ目は「差異・未確認」です。ここには、根拠どうしが食い違うもの、まだ確かめられていないもの、業務の正解と違って見えるものを書きます。違って見えても、すぐに不具合と決めつけません。業務側の理解が古い場合もあれば、ルールがまだ決まっていない場合もあります。分からないものは、分からないまま「未確認」として残します。

よく出てくるずれには、次のようなものがあります。画面にはあるが、業務では使っていない機能。業務では必要なのにシステムになく、手作業で補っている処理。コードにはあるが、画面からは使えない処理。仕様の確認に修正作業を混ぜず、まず業務への影響と一緒に記録します。漏えいやデータ消失など重大な異常は、メモの完成を待たず、責任者と技術担当へ連絡します。

仕様メモは一業務一枚で残す

受注金額の計算と送料を題材に、確認した動きと未確認の免除条件を記した仕様メモの架空例

仕様メモは、一つの業務につき一枚にまとめます。項目は、業務名、範囲、入力、処理と判断のルール、出力と保存先、使う人、例外、外部とのつながりです。各行には、三つの区分のどれに当たるか、根拠(実装・画面・業務)、確認日、確認した人を書き添えます。

先ほどの架空の会社では、受注金額の計算について、次のようなメモになりました。画面で確かめたところ、受注金額には送料が加算されていました。これが「確認した動き」です。一方、受注の担当者からは、条件によって送料を免除することがあると聞きました。ただ、どんな条件で免除するのかはまだはっきりしません。そのため、業務の正解の欄は「担当者に確認」としました。担当者から免除の条件を聞き取ったうえで、業務の責任者がルールとして決めます。免除の条件は「差異・未確認」として残し、根拠の欄には確認したシステムの版と日時を書きます。

この段階では、送料の加算が誤りだとはまだ言えません。免除の条件が決まって初めて、システムと業務のどちらを合わせるかを考えられます。こうした「まだ言えないこと」を見える形で残すのが、メモの役目です。

変更のたびにメモを直し、次の判断に使う

仕様メモ、変更内容、確認結果を照らし合わせ、未確認の担当と次の確認を残してメモを更新する流れ

メモの置き場所と、更新する人を決めておきます。システムを変えたときや、未確認だった点を確かめたときは、そのたびにメモも直します。未確認のまま残す項目には、誰が次に何を確かめるかも書いておきます。古いままのメモには今の動きと違うことが書かれたまま残り、かえって誤解を生むからです。

分担の目安は次のとおりです。業務の責任者は、対象の業務を選び、業務の正解を決めます。社内の開発担当は、画面での確認、聞き取りの記録、AIを使った下調べを受け持ちます。専門家には、実装とデータベースの読み取りや、差異が業務に与える影響の見立てを頼めます。

メモがそろってきたら、保守を引き継ぐか、直すか、作り直すかを比べます。仕様書がないから作り直す、と一律に決める必要はありません。今の姿が分かってから比べたほうが、残せる部分と手を入れる部分を分けやすくなります。なお、メモがあっても、保守を引き受けてもらえるかどうかは、相手が中身を確かめてから決まります。どこまでのメモが必要かは、相談先と決めます。

まとめ

仕様書がないときは、優先する業務から始めます。三つの根拠で確かめ、三つの区分で一枚ずつ残します。メモが途中でも、未確認が多くても、相談は始められます。Ouverの自社開発・AI駆動開発システムの保守運用では、仕様の整理、コード・データベースの点検、ログインと権限の確認、社内開発と保守の分担について相談できます。対応できるかどうかや範囲は、実際の構成を調べてから判断します。下の関連記事では、相談前に整理しておくこと、AIとの修正が終わらないときの立て直し方、保守を引き継ぐときの確認項目を扱っています。

参考資料・確認日

GitHub Docs「Review AI-generated code」(確認日:2026年11月18日)

Ouver「自社開発・AI駆動開発システムの保守運用」(確認日:2026年11月18日)

よくある質問

AIに「このシステムの仕様書を書いて」と頼めば足りますか?
下書きには使えます。ただ、AIの説明は、読ませた範囲や作ったときの指示をもとにした推測です。今の動きとずれることがあります。実装・画面・業務のどれかで確かめるまでは「未確認」として扱います。確かめたら、条件・版・証拠を添えて「確認した動き」に移します。
全部の機能の仕様書がないと、保守会社に引き継げませんか?
全部がそろっていなくても、止まると困る業務の仕様メモがあれば、話し合いの材料になります。どこまでのメモが必要かは相談先によって違うため、相手と決めます。メモがあれば必ず引き受けてもらえる、というものではありません。
コードを読めない担当者だけでも進められますか?
画面での確認と業務の聞き取りは、社内で進められます。コードやデータベースの読み取りは、専門家に頼んでかまいません。誰がどの根拠を確かめたかをメモに残しておくと、後から確かめ直す範囲が分かりやすくなります。
本番の画面を操作して確かめてもよいですか?
データを書き換える操作は、本番では行わないのが基本です。権限と試す範囲を関係者で合意した別の環境で、テスト用のデータを使って行います。別の環境がなければ、見るだけの確認にとどめます。見るだけの確認でも、誰のアカウントで、どの版を見たかを記録します。
確かめている途中で不具合らしいものを見つけたら、すぐ直すべきですか?
すぐには直さず、まず「差異・未確認」として記録し、業務への影響の大きさを見ます。業務の正解と違って見えても、ルールがまだ決まっていないだけの場合もあります。ただし、漏えいやデータ消失など重大な異常は、記録の整理を待たず、すぐに業務の責任者と技術担当へ伝えます。それ以外は、責任者が直すかどうかと順番を決めます。
仕様書がないなら、作り直したほうが早いですか?
一律には言えません。今の動きが分からないまま作り直すと、今のシステムがしている処理や例外の扱いが抜け落ちるおそれがあります。仕様メモで今の姿をつかんでから、引き継ぐ・直す・作り直すを比べます。

コラム一覧に戻る

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

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