mcpField
P
plc-skill

plc-skill

github.com/migo-ovo开发2543 次安装24 周前更新
代码仓库

关于 plc-skill

plc-skill 是面向 PLC 编程任务的技能,先判断任务范围,再区分通用问题与厂商特定问题。它强调按已识别平台路由参考资料,并明确标注依赖厂商、型号、软件或语言的细节。

主要功能

  1. 01区分通用与厂商专属 PLC 问题
  2. 02覆盖 ST、LD、FBD 和 SFC
  3. 03支持逻辑设计、调试与代码审查
  4. 04按已知平台路由参考资料
  5. 05谨慎处理安全相关问题

适用场景

  1. 01设计顺序控制、状态机与联锁
  2. 02排查 PLC 程序中的故障
  3. 03审查或重构 PLC 代码
  4. 04生成过程控制或运动控制模板

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/migo-ovo/plc-skill --skill plc-skill

安装后在 Claude Code 中输入/plc-skill确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
CONTRIBUTING.md
.gitattributes
.gitignore
SHOWCASE.md
INSTALL.md
AGENTS.md
README.zh-CN.md
LICENSE
.github/workflows/
verify.yml
bin/
install.js
docs/guides/
testing-and-evals.md
architecture.md
adding-new-vendors.md
evals/
debugging-cases.md
eval-matrix.md
README.md
evals.json
explanation-cases.md
generation-cases.md
incomplete-input-cases.md
output-behavior-cases.md
non-trigger-cases.md
review-cases.md
ladder-diagram-cases.md
sfc-cases.md
routing-cases.md
vendor-debugging-cases.md
vendor-generation-cases.md
examples/common/
debugging-example.md

详细介绍

PLC 技能

将其视为具有明确厂商路由的通用 PLC 技能,而不是模糊的全品牌百科。

分为两个层次:

  1. 通用 PLC 层
  2. 平台可识别时使用的厂商专属层

始终将这两个层次分开。

操作模型

首先判断请求是否确实属于 PLC/编程任务。

然后将其归类为以下一种:

  • 不涉及已确认厂商的通用 PLC 问题
  • 厂商专属 PLC 问题
  • 涉及多个厂商/厂商不明确的问题
  • 范围外的非 PLC 问题

如果已知厂商,首先使用匹配的厂商参考资料,了解环境、术语、程序组织、指令语义和工具行为。

如果厂商未知,首先根据通用 PLC 层作答,并明确标出哪些细节取决于厂商、型号、软件或语言。

如果用户混用了多个厂商生态系统或术语,应指出可能存在的不匹配,而不要悄然将它们合并。

核心范围

此技能涵盖:

  • PLC 逻辑设计
  • 顺序/状态机/步进控制
  • 报警、锁存、复位、联锁
  • 定时器、计数器、边沿触发行为
  • I/O 映射策略
  • 程序组织与模块化
  • 调试与故障排除
  • 代码审查与重构
  • 明确支持读取、编写和审查结构化文本(ST)、梯形图(LD)、功能块图(FBD)和顺序功能图(SFC)代码
  • IEC 61131-3 语言层面的推理
  • 面向过程控制、运动控制、配方和数据记录的高级模板
  • 平台已知时进行厂商专属路由

此技能默认不涵盖:

  • 通用电子或 PCB 工作
  • 脱离控制逻辑背景、纯粹只谈布线的安装答复
  • 与 PLC 程序无关的广泛工业网络内容
  • 缺乏已确认现场背景时对 SIL/PL/安全认证下结论
  • 假定某一厂商的术语或语法适用于所有厂商

阅读顺序

始终从以下内容开始:

  • references/common/scope-and-trigger-rules.md
  • references/common/task-router.md
  • references/common/knowledge-priority.md

然后按需加载:

  • 仅当请求中包含厂商、软件、CPU 系列、设备型号、存储器/标签或平台术语线索时,才加载 references/vendors/vendor-routing.md。
  • 仅当任务涉及生成、重构或模式选择时,才加载 templates/common/template-map.md。

然后只加载所需的最精简文件。

通用层职责

通用层用于:

  • IEC 61131-3 框架与语言层面的概念
  • 顺序、状态、报警、联锁、复位、所有权和扫描周期方面的推理
  • 工程结构与可维护性指导
  • 通用调试、审查和完整性处理
  • 处理 LD、FBD 和 SFC 代码,以及 ST 代码
  • 使用通用模板、检查清单和答复格式

厂商未知时,优先从 references/common/ 和 templates/common/ 中读取。

厂商层职责

厂商层用于:

  • 厂商软件环境与工程工作流
  • 厂商术语与型号系列线索
  • 厂商专属的指令、设备、存储器或标签约定
  • 该平台的项目组织规范
  • 调试行为与常见平台陷阱
  • 该生态系统的官方手册路由与证据优先级
当前支持深度

最深入的生产路径:

  • Mitsubishi FX3U + GX Works2 + Structured Project + ST

针对性次级模块:

  • Siemens
  • Rockwell / Allen-Bradley
  • Omron

基础路由/参考模块:

  • Beckhoff
  • Schneider
  • Codesys
  • Delta
  • Keyence
  • Panasonic

不要假定每条厂商路径都具有相同的深入程度、示例或评估覆盖范围。

证据优先级

按以下顺序使用证据:

  1. 随附的 PLC 通用工程规则参考资料
  2. 针对已识别平台的随附供应商参考资料
  3. 供应商官方手册/官方软件文档
  4. IEC 61131-3 和 PLCopen 资料
  5. 随附模板和示例
  6. 社区资料(作为低优先级补充)

如果答案取决于供应商特定行为,而供应商尚未确认,请说明这一点。

回复规则

始终:

  • 区分已确认的事实与假设
  • 说明实现细节何时取决于供应商/型号/软件
  • 优先提供模块化、便于审查的输出,而不是大段代码
  • 输入不完整时使用模板/清单
  • 对涉及安全的主题保持谨慎

评论

支持 Markdown