「ソースコードから仕様書を自動生成したい」と調べると、エンジニアがAIツールで試した記事と、ベンダーのサービス紹介が並びます。どちらも自分の状況に当てはまるのか判断しにくいのは、方法が3つに分かれていて、それぞれ向いている対象が違うからです。
この記事では、汎用のAIツールを自社で使う、レガシー特化の専用製品を導入する、受託会社に委託する、の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から設計書を生成できた一方で、同じ指示でも出力の言い回しが毎回変わり、確認には対象言語を読める人が必要だったと報告されています。業務上の意図はコードにないため、ツールは推測で埋めるか空欄にします。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内に構築する方式も選べます。国内の受託サービスで価格の目安とコードの持ち出し条件を公開している例は少なく、比較しやすい状態にしておくことも当社が意識している点です。
当社に向かないケース：
COBOLやPL/Iなどメインフレーム系の資産、数百万行規模の全社システムは、上記の大手サービスや専用製品が適しています。対象が数千行でエンジニアが社内にいる場合は、汎用のAIツールで十分なことが多く、委託の費用に見合いません。コードを一切社外に出せず、お客様のクラウド環境への専用環境の構築も難しい場合は、閉域で動く専用製品の導入をご検討ください。
比較の観点
3つの方法を、依頼前に確認しておきたい観点で並べると次のようになります。
| 観点 | 汎用のAIツール | 専用製品 | 委託 |
|---|---|---|---|
| 対象言語 | 主要言語は広く対応。古い言語は精度が下がる | 製品ごとに固定。COBOL対応が多い | 会社ごとに得意領域がある |
| 出せる粒度 | 関数・ファイルの説明、構成図 | 定型の設計書 | 文章の仕様書と確認事項 |
| 業務上の意図 | 扱わない | 扱わない | 確認事項として抽出し、人が確定 |
| 精度の担保 | 自社のエンジニアが検証 | 静的解析で構造を保証、説明文は要確認 | 技術者の検証と業務担当者様の確認 |
| 出力形式 | Markdown、チャット | Excel、PDF、Wiki | 指定の書式に合わせる |
| コードの持ち出し | クラウドへ送信。法人プランは学習不使用 | オンプレミス対応の製品あり | 受託先の環境か、自社クラウド内 |
| 費用 | 月額10〜20ドルから | 従量、個別見積 | 個別見積が中心。当社は数十万円から数百万円の目安を公開 |
| 継続更新 | 都度指示 | 差分取り込み機能を持つ製品あり | 運用として契約 |
選び方の基準
方法を選ぶときの問いは3つです。
社内にコードを読めるエンジニアがいるか：
いなければ、汎用ツールの出力を検証する人がいないため、専用製品か委託になります。いる場合も、その方の時間を仕様書化に割いていただけるかを先に確認します。
業務上の意図まで文書にするか：
引き継ぎや監査で、なぜそうなっているかまで必要なら、確認事項を洗い出して業務担当者様に確認する工程が必要です。それを担うのは委託先か自社のエンジニアで、ツールと専用製品はこの工程を持ちません。
コードを社外に出せるか：
出せない場合は、オンプレミス対応の専用製品か、自社クラウド内に環境を構築できる委託先を選びます。学習利用の有無や委託先への確認点はソースコードを生成AIに渡して大丈夫かにまとめています。
まとめ
ソースコードから仕様書を自動生成する方法は、汎用のAIツールを自社で使う、レガシー特化の専用製品を導入する、受託会社に委託する、の3つに分かれます。ツールは安く早いものの体系化と検証は自社のエンジニアが担い、専用製品は定型の設計書を大量に出せる代わりに業務上の意図は扱わず、委託は文章の仕様書と確認事項まで任せられる代わりに費用がかかります。
選ぶ基準は、社内にコードを読めるエンジニアがいるか、業務上の意図まで文書にするか、コードを社外に出せるか、の3点です。当社のAI仕様書作成サービスはオープン系の数万行から数十万行を対象にしており、無料診断でソースコードの一部を解析し、出せる仕様書の種類と粒度、確認事項の量の見込み、概算費用をご提示しています。
よくある質問
Q. 無料のAIツールだけで仕様書は作れますか？
小さな対象なら可能です。関数やファイル単位の説明、画面1つ分の項目一覧は、コードを渡せば出てきます。無料枠は入力できるコードの量に上限があることが多く、また個人向けプランでは入力が学習に使われる設定になっている場合があるため、業務コードを扱う前に設定を確認してください。
Q. 専用製品と委託は併用できますか？
可能です。専用製品で構造情報と定型の設計書を出し、業務上の意図の確認と文章の仕様書の仕上げを委託する組み合わせは、メインフレーム系の大規模資産で使われています。当社もお客様が導入済みの解析ツールの出力を入力として受け取ることができます。
Q. 生成された仕様書が正しいかは誰が確認するのですか？
方法によって変わります。汎用のAIツールでは自社のエンジニアが、専用製品では導入した部門が、委託では受託先の技術者がコードとの突き合わせを行います。ただし、業務上の意図が正しいかは、どの方法でもお客様側の業務担当者様にしか判断できません。確認事項に答える担当者を最初に決めておくことが、方法を問わず必要になります。
