convez.ai
SkillAutomaçãoAvançado
mongolyy

Gerador de Programas PLC Ladder/ST com IA

mongolyy/gen-ai-ladder-program-sample

IA semi-automática para gerar código PLC seguro a partir de especificações naturais

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill do Claude Code que semi-automatiza a geração de programas PLC em linguagem ladder e ST (Structured Text) a partir de especificações em linguagem natural. Inclui verificações estáticas de segurança, detecção de falhas críticas (parada de emergência, duplos comandos, interlocks) e suporte para exportação em GX Works3.

Instalação

$npx convez-ai mongolyy/gen-ai-ladder-program-sample

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Geração automática de programas ladder/ST a partir de descrições em linguagem natural
  • Verificação estática de segurança em programas PLC (parada de emergência, interlocks, duplos comandos)
  • Exportação de código estruturado para ambiente GX Works3
  • Documentação de máquinas de estado em código ST normalizado

Veredito

Solução robusta e bem pensada para automação industrial, com design inteligente que prioriza segurança (IA não aloca endereços físicos, checks estáticos obrigatórios) e rastreabilidade. Excelente para times que precisam gerar código PLC em escala, mas requer expertise em automação para aproveitar completamente.

README

A tradução para o português deste README ainda está na fila.

gen-ai-ladder-program

生成AIで PLC のラダー/ST(構造化テキスト)を半自動生成するための Claude Code スキル。

全体フロー

① 自然言語仕様            (入力)
② 構造化仕様の生成        ← スキル
③ デバイス/ラベル割付     ← スキル
④ ST 生成                 ← スキル(ST を正、ラダーは変換ビュー)
⑤ 静的チェック            ← スキル(scripts/static_check.py)
─────────────────────────────────
⑥ 人間レビュー            (観点をスキルが提示)
⑦ GX Works3 実装          (インポート用ファイルを出力)
⑧ シミュレーション
⑨ 実機確認

設計思想:

  • AI に物理アドレスを断定させない — デバイスマスタ(CSV)を単一の真実とし、ST はラベルで書く。
  • ST を正、ラダーは従 — 後段の検証・Git 差分管理を一本化。
  • 安全はゲート — 非常停止・インターロック欠落、二重コイル、未定義デバイスを静的チェックで検出。
  • 不明点は断定せず assumptions に記録 — 各工程末のゲートで人間に確認。

使い方

Claude Code で ladder-gen スキルを呼び出し、制御仕様(自然言語)を渡す。 各工程の成果物は out/<案件名>/ に出力される。

スキル本体: .claude/skills/ladder-gen/SKILL.md

静的チェッカー単体実行

python3 .claude/skills/ladder-gen/scripts/static_check.py \
  --st out/<案件名>/03_program.st \
  --devices out/<案件名>/02_device_master.csv \
  --spec out/<案件名>/01_structured_spec.yaml \
  --report out/<案件名>/04_static_check.txt

ERROR が 1 件でもあれば終了コード 1。--spec は任意だが安全/インターロック検査に必要。 (YAML 解析に pyyaml を使用。未導入でも簡易フォールバックで動作。)

構成

.claude/skills/ladder-gen/
  SKILL.md                          スキル本体(工程の実行手順)
  references/
    structured-spec-schema.md       工程② 構造化仕様スキーマ
    device-allocation.md            工程③ デバイス割付の原則
    st-generation-guide.md          工程④ ST コーディング規約
    static-check-rules.md           工程⑤/⑥ チェック項目とレビュー観点
  templates/
    structured-spec.template.yaml   構造化仕様テンプレート
    device-master.template.csv      デバイスマスタテンプレート
  scripts/
    static_check.py                 工程⑤ 静的チェッカー
    gen_state_machine.py            状態遷移 → CASE 状態機械生成
    ladder_view.py                  ST → ASCII ラダー図ビュー
    export_gxworks3.py              工程⑦ GX Works3 取り込み用ファイル生成
  tests/                            スクリプトの pytest テスト
  examples/
    motor-fwd-rev/                  モータ正逆運転制御の完成例
    conveyor-seq/                   状態遷移(シーケンス制御)の例

テスト

スクリプトの回帰テストは pytest で実行する(CI でも自動実行):

pip install pytest pyyaml
pytest

現状と今後

実装済み: 工程②〜⑦(構造化〜静的チェック〜GX Works3 連携)、人間レビュー観点(⑥)、 状態遷移→CASE 状態機械生成、ST→ラダー図ビュー。 今後の候補: シミュレーション結果の取り込み(⑧)、状態機械の出力動作(Moore)自動生成、 静的チェックの強化(スキャン依存・タイマ未呼び出し検出)。

Ver o original no GitHub

Bom para

Relacionados