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 を取り込むだけ
- AI に JSON データ構造の仕様 のページを読ませる(URL を読めない AI には、このページの本文を貼ります)。
- Excel の表をそのまま貼る(コピーして貼ると、タブ区切りのテキストになります)。
- 「この仕様の
kind: "timingchart"の JSON にして」と頼む。 - 返ってきた 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 数と波形の長さの一致、配置と線の経路 |
| 設計者 | いつ何を変えるか(波形・順序・待ち時間)、指摘を採るかどうかの判断 |
3. できた図は、レビューの前に AI 検証用テキストで見させる
レビューの前に、一度 AI に通しておきましょう。 どのエディタでも、「出力 → 書き出し…(Ctrl+E)」の中に「AI 検証用テキスト…」があります。 図の内容に「何を見てほしいか」を添えたテキストが出るので、そのまま AI に貼ります。
タイミングチャート:順序の矛盾と、きっかけの無い変化が見つかる
- 要求と応答の順序の矛盾 — 応答を確かめる前に要求を落としている
- インターロックの抜け — 異常中でも起動要求が通る
- 取りこぼし — 1 Step しか出ない信号を、相手が拾えない
- きっかけの無い変化 — 何をきっかけに変わったのか説明できない箇所
最後の項目は、きっかけの矢印を引いていないチャートでは見つかりません。 検証用テキストには矢印の一覧も入ります。「矢印の無い変化を挙げて」と一言添えると、根拠の無い変化を名指しで返してくるでしょう。 そこは多くの場合、仕様が決まっていないところです。
フローチャート:抜け出せないループと、行き先の無い分岐が見つかる
- 抜け出せないループ — 抜ける条件がどこにもない
- たどり着けない処理 — 分岐の組み合わせ上、通ることがない
- 行き先の無い分岐 — YES / NO の片方がどこにもつながっていない
メモリマップ:名前のゆれと、型と格納先の食い違いが見つかる
- 名前のゆれ —
bStartとStartBitが混ざっている - 型と格納先の食い違い — DINT を 1 ワードに入れている
- 増設の余地 — 増設用の空きが連続して取れているか
重複と範囲外は、エディタが自分で見つけて検証用テキストに添えます。 名前のゆれ、型と格納先、増設の空きは AI の担当です。
4. 直しは、JSON をコピーして「指摘の箇所だけ」と頼む
指摘に納得したら、直すのも AI に頼み、JSON のまま往復させます。 「出力 → 書き出し…」で「JSON」を選んで「クリップボードにコピー」。 「この構造のまま、指摘の箇所だけ直して」と頼みます。 返ってきた JSON を「ファイル → 取り込み… → JSON を貼り付ける」に貼るだけで、ファイルは作りません。
直す箇所は指定して頼みます。「作り直して」と頼むと、関係のないところまで変わることがあります。
JSON を読み込むと、それまでの編集は Ctrl+Z でさかのぼれません。 今の内容を「名前を付けて保存…」してから読み込みます。
5. 向いているのは、改造・客先仕様書の読み込み・レビュー前・引き継ぎ
すでに一覧や文章の仕様があって、図がまだ無い場面で効きます。
| 場面 | すること |
|---|---|
| 既存機の改造 | 前回のデバイスコメントを JSON にして、変わるところだけ描き足す |
| 客先仕様書の読み込み | 文章の仕様を JSON にさせて図にし、「これで合っていますか」と客先に確かめる |
| レビューの前 | AI 検証用テキストを先に通し、指摘されそうなところを直しておく |
| 引き継ぎ | 図と JSON を一緒に渡す。受け取った側も AI に読ませられる |
6. 貼る前に社内の決まりを確かめ、指摘を採るかは設計者が決める
- 客先の情報を AI に貼る前に、社内の決まりを確かめます。 機器の型式、IP アドレス、製品名が入ったままになりがちです。 エディタはデータを端末の中だけで扱いますが、AI に貼った時点でその外へ出ます。
- AI の指摘を採るかどうかは、設計者の判断です。 「インターロックが足りない」と言われても、上位の安全回路で担保していることがあります。
-
JSON が読み込めないときは、まず貼った範囲を確かめます。
AI の返事の説明文や、JSON を囲む
```まで一緒に貼ると読み込めません。 貼るのは、最初の{から最後の}までです。 それでも読めないときは、図の中身の配列が入っているかを見ます。 タイミングチャートならrows、フローチャートならnodes。構成図ならdevices、メモリマップならvariablesです。
使うもの
上の分担の図は、Flowchart Editor のレーン(担当の列)で描き、SVG に書き出したものです。
- JSON データ構造の仕様 — AI に読ませる仕様書
- Timing Chart Editor — 信号の順序ときっかけ
- Memory Map Editor — 変数と番号の割り付け
- Flowchart Editor — 状態と遷移条件
- System Diagram Editor — 機器と通信のつながり
インストールも登録も要りません。入力したデータは端末の中だけに保存され、サーバーへは送られません。
関連する記事
- タイミングチャートの書き方 — 人とコード、人と人の共通インターフェース
- PLC 制御フローチャートの書き方 — 状態と遷移条件を決めてからラダーを書く
- PLC メモリマップの作り方 — 構成図のまとまりを区画にし、書き込む側を 1 つに決める
- システム構成図の書き方 — 担当者の推測をなくし、後工程の土台を決める
yk.builds