关于 plc-skill
plc-skill 是面向 PLC 编程任务的技能,先判断任务范围,再区分通用问题与厂商特定问题。它强调按已识别平台路由参考资料,并明确标注依赖厂商、型号、软件或语言的细节。
主要功能
- 01区分通用与厂商专属 PLC 问题
- 02覆盖 ST、LD、FBD 和 SFC
- 03支持逻辑设计、调试与代码审查
- 04按已知平台路由参考资料
- 05谨慎处理安全相关问题
适用场景
- 01设计顺序控制、状态机与联锁
- 02排查 PLC 程序中的故障
- 03审查或重构 PLC 代码
- 04生成过程控制或运动控制模板
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ migo-ovo/ plc-skill --skill plc-skill安装后在 Claude Code 中输入/plc-skill确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdCONTRIBUTING.md.gitattributes.gitignoreSHOWCASE.mdINSTALL.mdAGENTS.mdREADME.zh-CN.mdLICENSE.github/workflows/verify.ymlbin/install.jsdocs/guides/testing-and-evals.mdarchitecture.mdadding-new-vendors.mdevals/debugging-cases.mdeval-matrix.mdREADME.mdevals.jsonexplanation-cases.mdgeneration-cases.mdincomplete-input-cases.mdoutput-behavior-cases.mdnon-trigger-cases.mdreview-cases.mdladder-diagram-cases.mdsfc-cases.mdrouting-cases.mdvendor-debugging-cases.mdvendor-generation-cases.mdexamples/common/debugging-example.md详细介绍
PLC 技能
将其视为具有明确厂商路由的通用 PLC 技能,而不是模糊的全品牌百科。
分为两个层次:
- 通用 PLC 层
- 平台可识别时使用的厂商专属层
始终将这两个层次分开。
操作模型
首先判断请求是否确实属于 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.mdreferences/common/task-router.mdreferences/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
不要假定每条厂商路径都具有相同的深入程度、示例或评估覆盖范围。
证据优先级
按以下顺序使用证据:
- 随附的 PLC 通用工程规则参考资料
- 针对已识别平台的随附供应商参考资料
- 供应商官方手册/官方软件文档
- IEC 61131-3 和 PLCopen 资料
- 随附模板和示例
- 社区资料(作为低优先级补充)
如果答案取决于供应商特定行为,而供应商尚未确认,请说明这一点。
回复规则
始终:
- 区分已确认的事实与假设
- 说明实现细节何时取决于供应商/型号/软件
- 优先提供模块化、便于审查的输出,而不是大段代码
- 输入不完整时使用模板/清单
- 对涉及安全的主题保持谨慎
评论
支持 Markdown