# AI に JSON を作らせる頼み方の例（spec-platform/v1）

FA Spec Tools（https://fa-spec.com）の 4 つのエディタが読む JSON を、ChatGPT・Claude・Gemini などに作らせるための短い頼み方です。
`{ }` の所を自分の内容に置き換えて貼ります。
返ってきた JSON は、エディタの「ファイル → 取り込み… → JSON を貼り付ける」で図になります。

- 仕様の正：https://fa-spec.com/json-format
- JSON Schema：https://fa-spec.com/spec/v1/common.schema.json と、kind ごとの `<kind>.schema.json`
- 毎回の前置きを省くなら、https://fa-spec.com/spec/v1/ai/instructions.md を Claude の Project や GPTs の指示に貼ります。

AI に任せるのは、名前・型・コメント・方向の振り分けと、文章からの書き起こしまでです。
番号の割り付け、波形（いつ何を変えるか）、座標は任せません。
番号と座標はエディタが決め、波形は設計者が描きます。

## 1. システム構成図（kind: "systemdiagram"）

```text
https://fa-spec.com/json-format の仕様に従って、下の説明から kind: "systemdiagram" の JSON を作ってください。
- devices の kind は plc / hmi / pc / servo / inverter / robot / io / unit / sensor / net / other から選ぶ（io はリモート I/O、unit は CPU やリモート I/O に連結する I/O ユニットで、controller に連結先の devices[].id を書く）
- links の kind には、ネットワークの名前（EtherNet/IP、CC-Link IE など）をそのまま書く
- x / y は書かない
- 説明に無い型式・IP アドレスは作らず、空にする
- JSON のあとに、決めつけた所と確かめたい所を箇条書きで

{機器の一覧と、どれがどれとつながるかの説明}
```

## 2. メモリマップ（kind: "addressmap"）

```text
https://fa-spec.com/json-format の仕様に従って、下の I/O 一覧から kind: "addressmap" の JSON を作ってください。
- v は 3。相手の機器ごとに devices を作り、blocks（「指令」「状態」など。deviceId で機器に、parentId で親のブロックに結ぶ）に分ける
- variables の deviceId・blockId（いちばん内側のブロック）をそろえる。PLC が複数あるときは PLC ごとに 1 つずつ作る
- role は、PLC が出す信号を "M"、相手の機器が出す信号を "S"、PLC の中だけで使うものを "I"
- type は BOOL / INT / DINT / WORD / REAL など IEC 61131-3 の型名
- address は空にする（割り付けはエディタで行います）。plc は書かない
- 一覧に無い変数は足さない
- JSON のあとに、方向や型を推測した行を箇条書きで

{変数名・型・コメント・相手の機器が分かる表（Excel から貼り付け）}
```

## 3. タイミングチャート（kind: "timingchart"）

```text
https://fa-spec.com/json-format の仕様に従って、下の信号一覧から kind: "timingchart" の JSON を作ってください。
- steps は 16
- meta の master は PLC、slave は相手の機器の名前
- rows の role は、master が出す信号を "M"、slave が出す信号を "S"
- values の長さは steps と同じ。BOOL は true / false、数値は文字列、未設定は null
- 波形はまだ決めないので、BOOL は全部 false、数値は全部 null で置く
- triggers は空の配列にする

{信号名・型・コメント・方向の表}
```

## 4. フローチャート（kind: "flowchart"）

```text
https://fa-spec.com/json-format の仕様に従って、下の動作の説明から kind: "flowchart" の JSON を作ってください。
- nodes の type は start / end / process / decision / switch / fork / join / wait / io / sub / note から選ぶ（同時に動かす所は fork で分け、枝の終わりを 1 つの join につなぐ）
- 1 つの process には 1 つの工程（何を ON / OFF するか）を書く。text の改行は \n
- decision から出る edges の port は "yes" と "no"。条件がそろうまで待つ所は、no を自分自身に戻す
- switch から出る edges の port は値（cases）の順に "c0"・"c1"…、fork から出る edges の port は枝の順に "c0"・"c1"…
- それ以外の edges の port は "out"
- x / y は書かない
- 説明に無い条件や時間は作らず、JSON のあとに確かめたい所として挙げる

{動作の説明（箇条書きでよい）}
```

## 返ってきた JSON を確かめる

Node.js があれば、https://fa-spec.com/spec/v1/validate.mjs で形を確かめられます。

```text
node validate.mjs 図.json
```

エラーと注意は日本語で出ます。
出力をそのまま AI に貼って「エラーと注意を直して」と頼めば通じます。
