「ソースコードから仕様書を自動生成したい」と調べると、エンジニアがAIツールで試した記事と、ベンダーのサービス紹介が並びます。試した記事は書き手の環境と規模での結果で、サービス紹介はその会社の方法の説明なので、どちらを読んでも自社のシステムにどれが合うかまでは判断しにくいはずです。
方法は、汎用のAIツールを自社で使う、レガシー特化の専用製品を導入する、受託会社に委託する、の3つに分かれます。どれが合うかの分かれ目は、社内にコードを読めるエンジニアがいるか、業務上の意図まで文書にするか、コードを社外に出せるかの3点です。当社は3つ目の委託を提供する立場ですが、当社に向かないケースも書きます。AIで仕様書を作る手順そのものはAIで仕様書を作成する方法で扱っています。
方法の全体像
次の図は、3つの方法を、出せる仕様書の粒度と、お客様側に残る作業の量で位置づけたものです。右上に行くほど任せられる範囲が広がります。ただし、業務上の意図が正しいかを判断できるのは業務担当者様だけなので、その確認はどの方法を選んでもお客様側に残ります。
| 方法 | 例 | 出せるもの | 向いている場合 |
|---|---|---|---|
| 汎用のAIツールを自社で使う | GitHub Copilot、Cursor、Claude Code、DeepWiki | 関数・ファイル単位の説明、構成の概要、構造図 | 社内にエンジニアがいて、対象が小さい |
| レガシー特化の専用製品を導入する | Jitera、Swimm、AIベテランエンジニア、ワンダーロボ・リバース | 定型の設計書(画面設計書、テーブル定義、処理フロー、CRUD) | COBOLなどメインフレーム系、または継続的に多量の資産を文書化する |
| 受託会社に委託する | 大手SIerのリバースエンジニアリングサービス、当社のAI仕様書作成 | 機能一覧から処理フローまでの文章の仕様書と、確認事項の一覧 | 業務上の意図まで文書にしたい、確認事項の洗い出しから任せたい |
汎用のAIツールの自社利用
できること：
GitHub Copilot、Cursor、Claude Codeのようなコーディング支援ツールは、リポジトリを読ませて「この機能の処理を説明して」「画面の項目一覧を表にして」と指示すれば、関数やファイル単位の説明、モジュール間の依存関係、Mermaid形式の構成図を出せます。Cognition社のDeepWikiのように、リポジトリ全体をWiki形式の解説に変換するサービスもあります。公式サイトの掲載価格は、GitHub Copilot Proが月額10ドル、Cursor Individualが月額20ドル、Claude Proが月額20ドルで、個人単位で始められます。いずれも2026年9月時点の価格です。
限界：
定型の設計書をそのまま出力する機能はありません。画面設計書やテーブル定義書のような様式で数十画面を体系立てて出すには、どう指示すれば様式が揃うかを設計し、出力をコードと突き合わせ、分冊と目次を管理する作業をエンジニアが担います。セキュリティ会社のラックが2023年に公開した検証記事では、約200ステップのCOBOLから設計書を生成できた一方で、同じ指示でも出力の言い回しが毎回変わり、確認には対象言語を読める人が必要だったと報告されています。約200ステップは小さなプログラム1本分の規模です。対象が数万行になれば、この確認を機能の数だけ繰り返すことになります。
もう一つの限界は、業務上の意図がコードに書かれていないことです。たとえば特定の取引区分だけを集計から外す分岐があっても、コードから読めるのは外しているという事実までで、なぜ外すのかは分かりません。ツールはこうした箇所を推測で埋めるか、空欄にします。Zennに公開されたログラスの技術ブログでも、複雑な業務の文脈をコードから読み解く精度は低く、人のヒアリングで補ったと書かれています。
コードの扱い：
法人向けプラン（GitHub Copilot BusinessとEnterprise、Cursor TeamsとEnterprise、Claude TeamとEnterprise）は、入力をモデルの学習に使わない契約になっています。個人向けプランで業務コードを扱う場合は、学習利用の設定を確認する必要があります。
向いている場合：
社内にコードを読めるエンジニアがいて、対象が数千行から数万行、目的が引き継ぎ用の概要や特定機能の理解であれば、この方法が最も安く早い選択です。
レガシー特化の専用製品の導入
できること：
既存システムの文書化に特化した製品は、静的解析で構造を取り出し、生成AIで説明文を付ける構成が主流です。Jiteraは公式にCOBOL、JCL、Java、PHP、VBなど18言語への対応と、API設計書、ビジネスロジック設計書、DB設計書の生成を掲げています。Swimmは静的解析とLLMを組み合わせ、COBOLやPL/Iのプラグインを提供し、オンプレミスや閉域での運用に対応しています。東京システムハウスのAIベテランエンジニアはCOBOLに絞ってプログラム構成図やフローチャートを生成し、質問に答えるチャットを備えています。ワンダフルフライのワンダーロボ・リバースはCOBOL、PowerBuilder、VB6、VBA、Javaを対象にExcel形式の画面設計書やテーブル定義書を出力します。従来型の解析ツールであるUnderstandも、2025年にローカルのLLMで関数やクラスの説明を生成する機能を加えました。
限界：
静的解析で取り出せるのは、どのプログラムがどのテーブルを読み書きするかといったコードの構造までです。出力は定型の設計書で、業務上の意図は扱いません。製品を導入し、対象コードを取り込み、出てきた設計書を読み解く作業は自社に残ります。価格は行数や本数、クレジットによる従量のものが多く、金額を公開している製品は少ないため、比べるには個別に見積を取る必要があります。
向いている場合：
COBOLやPL/Iのようなメインフレーム系で、対象資産が数百万行におよぶ、あるいは継続的に多量の資産を文書化する必要があるなら、製品の導入が合理的です。
受託会社への委託
できること：
受託会社は、生成AIによる解析と技術者の検証を組み合わせて仕様書を納品します。2026年に入ってから大手SIerの発表が相次いでおり、公開されている数値では、富士通がCOBOL資産の設計書生成で作業時間を手作業比で約30分の1、SHIFTが46種類のドキュメントを生成、東芝デジタルエンジニアリングが従来比で費用と期間を約50%削減と、それぞれ発表しています。いずれもメインフレーム系を主な対象にした大規模案件向けで、価格は個別見積です。
当社の位置づけ：
当社のAI仕様書作成サービスは、PHP・Java・C#・VB・Accessなどのオープン系で、数万行から数十万行の業務システムを対象にしています。ソースコード、データベース定義、画面と帳票、ログの4つをAIが照合して暫定仕様書を作成します。区分値の意味や、仕様か不具合かの判断が必要な挙動は推測で埋めずに確認事項として一覧にし、業務担当者様との読み合わせで確定します。費用は規模と粒度により数十万円から数百万円が目安で、作業環境はお客様のAWSまたはAzure内に構築する方式も選べます。国内の受託サービスでは価格の目安とコードの持ち出し条件を公開している例が少ないため、当社はこの2点をサービスページに載せ、見積前に比べられるようにしています。
当社に向かないケース：
COBOLやPL/Iなどメインフレーム系の資産、数百万行規模の全社システムは、上記の大手サービスや専用製品が適しています。対象が数千行でエンジニアが社内にいる場合は、汎用のAIツールで十分なことが多く、委託の費用に見合いません。コードを一切社外に出せず、お客様のクラウド環境への専用環境の構築も難しい場合は、閉域で動く専用製品の導入をご検討ください。
比較の観点
3つの方法を、依頼や導入の前に確認しておきたい観点で並べました。方法を絞る段階で見るのは「精度の担保」「業務上の意図」「コードの持ち出し」の3行で、残りの行は候補を絞ったあとの比較に使います。
| 観点 | 汎用のAIツール | 専用製品 | 委託 |
|---|---|---|---|
| 対象言語 | 主要言語は広く対応。古い言語は精度が下がる | 製品ごとに固定。COBOL対応が多い | 会社ごとに得意領域がある |
| 出せる粒度 | 関数・ファイルの説明、構成図 | 定型の設計書 | 文章の仕様書と確認事項 |
| 業務上の意図 | 扱わない | 扱わない | 確認事項として抽出し、人が確定 |
| 精度の担保 | 自社のエンジニアが検証 | 静的解析で構造を保証、説明文は要確認 | 技術者の検証と業務担当者様の確認 |
| 出力形式 | Markdown、チャット | Excel、PDF、Wiki | 指定の書式に合わせる |
| コードの持ち出し | クラウドへ送信。法人プランは学習不使用 | オンプレミス対応の製品あり | 受託先の環境か、自社クラウド内 |
| 費用 | 月額10〜20ドルから | 従量、個別見積 | 個別見積が中心。当社は数十万円から数百万円の目安を公開 |
| 継続更新 | 都度指示 | 差分取り込み機能を持つ製品あり | 運用として契約 |
選び方の基準
表で方法を絞るときの3行は、発注前に社内で答えておく次の問いに対応します。
社内にコードを読めるエンジニアがいるか：
いなければ、汎用ツールの出力を検証する人がいないため、専用製品か委託になります。いる場合も、その方の時間を仕様書化に割いていただけるかを先に確認します。数十画面分の出力をコードと突き合わせる作業は、通常業務の合間には進みにくいためです。
業務上の意図まで文書にするか：
改修の影響範囲を調べる、特定の機能の処理を理解するといった目的なら、コードの構造と処理の説明で足りることが多く、ツールや専用製品の出力で間に合います。引き継ぎや監査で「なぜそうなっているか」まで残すなら、確認事項を洗い出して業務担当者様に答えていただく工程が入ります。この工程を担うのは委託先か自社のエンジニアで、ツールと専用製品には含まれていません。
コードを社外に出せるか：
出せない場合は、オンプレミス対応の専用製品か、自社クラウド内に環境を構築できる委託先を選びます。学習利用の有無や委託先への確認点はソースコードを生成AIに渡して大丈夫かにまとめています。
まとめ
方法を選ぶ前に決めておきたいのは、仕様書を何に使うかです。改修の影響調査や特定機能の理解が目的で、社内にエンジニアがいるなら、まず汎用のAIツールで対象の一部を試すのが最も安く済みます。メインフレーム系の資産を継続して文書化するなら、複数の専用製品から見積を取って比べるのが先です。引き継ぎや監査のために業務上の意図まで残す場合は、確認事項の洗い出しと読み合わせを自社のエンジニアで回せるかどうかが、自社で進めるか委託するかの分かれ目です。コードを社外に出せない場合は、その時点で候補がオンプレミス対応の製品か、自社クラウド内に環境を作れる委託先に絞られます。
委託を検討していて、自社のコードでどこまでの仕様書が出るのかを見てから判断したい場合は、当社のAI仕様書作成サービスの無料診断をご利用ください。オープン系の数万行から数十万行を対象に、ソースコードの一部を解析して、出せる仕様書の種類と粒度、確認事項の量の見込み、概算費用をご提示しています。
よくある質問
Q. 無料のAIツールだけで仕様書は作れますか？
小さな対象なら可能です。関数やファイル単位の説明、画面1つ分の項目一覧は、コードを渡せば出てきます。無料枠は入力できるコードの量に上限があることが多く、また個人向けプランでは入力が学習に使われる設定になっている場合があるため、業務コードを扱う前に設定を確認してください。
Q. 専用製品と委託は併用できますか？
可能です。専用製品で構造情報と定型の設計書を出し、業務上の意図の確認と文章の仕様書の仕上げを委託する組み合わせは、メインフレーム系の大規模資産で使われています。当社もお客様が導入済みの解析ツールの出力を入力として受け取ることができます。
Q. 生成された仕様書が正しいかは誰が確認するのですか？
方法によって変わります。汎用のAIツールでは自社のエンジニアが、専用製品では導入した部門が、委託では受託先の技術者がコードとの突き合わせを行います。ただし、業務上の意図が正しいかは、どの方法でも業務担当者様にしか判断できません。確認事項に答えていただく方と、その方が確認に割ける時間の目安は、方法を選ぶ段階で決めておくと進めやすくなります。
