AI に仕様書を描かせる — Excel の一覧を図にし、できた図を AI に検証させる

最終更新: 2026-09-23 / カテゴリ: 制御設計・PLC

Excel の I/O 一覧を AI に JSON へ変換させれば、図は書き写さずに作れます。 一覧はあるのに図はこれから、という設計者と、できた図を AI に検証させたい人に向けて書いています。

1. AI には図を描かせず、データを書かせる

AI に頼むのは絵ではなく、エディタが読む JSON です。 生成 AI に図を画像として描かせると、線はずれ、文字は潰れ、信号の数は勝手に変わります。 直してと頼むと、別のところが崩れがちです。

4 つのエディタが読み書きする JSON のデータ構造は公開しています。 形式が分かっていれば、AI は絵を描かずにデータを書けば済みます。 描画はエディタの仕事。線はずれず、直しても別のところは崩れません。

同じ理由で、検証も画像ではなくデータを読ませます。 どの信号がどの信号のきっかけか、どの判断にどの出口があるかは、データに書いてあります。 画像から読ませると、矢印がどの変わり目から出ているかを取り違えるでしょう。

2. Excel の I/O 一覧は、書き写さずに JSON にして取り込む

すでにある一覧を、書き写さずに図にできます。

手順は、仕様を読ませて表を貼り、JSON を取り込むだけ

  1. AI に JSON データ構造の仕様 のページを読ませる(URL を読めない AI には、このページの本文を貼ります)。
  2. Excel の表をそのまま貼る(コピーして貼ると、タブ区切りのテキストになります)。
  3. 「この仕様の kind: "timingchart" の JSON にして」と頼む。
  4. 返ってきた JSON をコピーし、エディタの「ファイル → 取り込み… → JSON を貼り付ける」に貼って読み込む。

頼み方の例:波形は決めさせず、行と方向だけ作らせる

https://fa-spec.com/json-format の仕様に従って、
下の I/O 一覧から kind: "timingchart" の JSON を作ってください。

- steps は 16
- BOOL は values を true/false、数値は文字列、未設定は null
- role は、PLC が出す信号を "M"、サーボが出す信号を "S"
- 波形はまだ決めないので、全部 false で置いてください

変数名	型	コメント	方向
bStartReq	BOOL	位置決め起動要求	M
bBusy	BOOL	動作中	S
bInPos	BOOL	位置決め完了	S
nTargetPos	DINT	目標位置	M

波形は全部 false で置かせ、行と方向だけを用意させます。 どの信号がいつ変わるかは設計の判断そのもので、AI に決めさせるところではありません。

メモリマップも同じ。番号は空にさせ、エディタで割り付ける

デバイスコメントの一覧や機械設計からもらった I/O リストも、kind: "addressmap" で取り込めます。 このときは address を空のままにさせます。

番号の割り付けは、AI に任せません。 デバイスの範囲・型・ビットの詰め方を全部見ながら数える作業で、AI は間違えやすいからです。 空のまま読み込み、エディタの「アドレス割付…」(Ctrl+R)で一括で割り付けます。 重複と範囲外の検出も自動です。

座標(x / y)も書かせなくて構いません。 構成図とフローチャートは、座標の無いデータを読み込むと自動で並べます。

分担:数えるのはエディタ、いつ何を変えるかは設計者

数える作業はエディタに、決める作業は設計者に残します。

任せる相手作業
AI名前・型・コメント・方向の振り分け、文章の仕様からの書き起こし、見落としの指摘
エディタ番号の連番、ビットの位置、デバイスの残り、Step 数と波形の長さの一致、配置と線の経路
設計者いつ何を変えるか(波形・順序・待ち時間)、指摘を採るかどうかの判断
設計者・AI・エディタの 3 つのレーンに分かれたフローチャート。設計者の Excel の I/O 一覧を AI が JSON に変換し、エディタが読み込んで描く。設計者が波形と順序を描き、エディタが出した AI 検証用テキストを AI が読んで抜けと矛盾を指摘する。設計者が指摘を採るなら AI が指摘の箇所だけ直し、エディタが読み込み直す。採らなければ仕様書へ進む。
指摘を採らなければ仕様書へ。採るなら AI が指摘の箇所だけ直し、エディタで読み込み直す。

3. できた図は、レビューの前に AI 検証用テキストで見させる

レビューの前に、一度 AI に通しておきましょう。 どのエディタでも、「出力 → 書き出し…(Ctrl+E)」の中に「AI 検証用テキスト…」があります。 図の内容に「何を見てほしいか」を添えたテキストが出るので、そのまま AI に貼ります。

タイミングチャート:順序の矛盾と、きっかけの無い変化が見つかる

最後の項目は、きっかけの矢印を引いていないチャートでは見つかりません。 検証用テキストには矢印の一覧も入ります。「矢印の無い変化を挙げて」と一言添えると、根拠の無い変化を名指しで返してくるでしょう。 そこは多くの場合、仕様が決まっていないところです。

フローチャート:抜け出せないループと、行き先の無い分岐が見つかる

メモリマップ:名前のゆれと、型と格納先の食い違いが見つかる

重複と範囲外は、エディタが自分で見つけて検証用テキストに添えます。 名前のゆれ、型と格納先、増設の空きは AI の担当です。

4. 直しは、JSON をコピーして「指摘の箇所だけ」と頼む

指摘に納得したら、直すのも AI に頼み、JSON のまま往復させます。 「出力 → 書き出し…」で「JSON」を選んで「クリップボードにコピー」。 「この構造のまま、指摘の箇所だけ直して」と頼みます。 返ってきた JSON を「ファイル → 取り込み… → JSON を貼り付ける」に貼るだけで、ファイルは作りません。

直す箇所は指定して頼みます。「作り直して」と頼むと、関係のないところまで変わることがあります。

JSON を読み込むと、それまでの編集は Ctrl+Z でさかのぼれません。 今の内容を「名前を付けて保存…」してから読み込みます。

5. 向いているのは、改造・客先仕様書の読み込み・レビュー前・引き継ぎ

すでに一覧や文章の仕様があって、図がまだ無い場面で効きます。

場面すること
既存機の改造前回のデバイスコメントを JSON にして、変わるところだけ描き足す
客先仕様書の読み込み文章の仕様を JSON にさせて図にし、「これで合っていますか」と客先に確かめる
レビューの前AI 検証用テキストを先に通し、指摘されそうなところを直しておく
引き継ぎ図と JSON を一緒に渡す。受け取った側も AI に読ませられる

6. 貼る前に社内の決まりを確かめ、指摘を採るかは設計者が決める

使うもの

上の分担の図は、Flowchart Editor のレーン(担当の列)で描き、SVG に書き出したものです。

インストールも登録も要りません。入力したデータは端末の中だけに保存され、サーバーへは送られません。

関連する記事

yk.builds