施耐德机器专家编程规范
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/user_a389bc07--schneider-machine-expert-programming.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a389bc07/schneider-machine-expert-programming。Schneider Electric EcoStruxure Machine Expert 施耐德机器专家 编程规范与实操指南(V2.6.1 官方 Agentic AI 基线)。当用户需要在 Machine Expert 中编写、修改或审查 PLC 程序(以 ST 结构化文本为主)时使用,确保优先采用施耐德专用库与正确命名规范而非通用库,并通过官方 stdio MCP Server 实际连接 Logic Builder、创建工程与 POU、写入实现、编译保存。
触发场景包括编写或审查机器专家程序、查找正确的施耐德库或功能块、将通用代码改写为施耐德正确写法、配置 WorkBuddy 与 ESME 的 Agentic AI MCP 连接、判断 MCP 工具为何消失或工具数不对、按阶段门控新建 TM241 工程,以及启动或打开本机 Machine Expert 软件。
阅读全文 (展开查看完整说明)
概述
机器专家编程 Skill(EcoStruxure Machine Expert V2.6.1)
版本基线:EcoStruxure Machine Expert V2.6.1 / Logic Builder 2.6.1.0 / CODESYS 3.5 SP21 Patch 6 HF1。
v2.0.0 于 2026-11-09 按官方 Agentic AI 规范与本机实测重写:接入方式由「HTTP + 动态端口」整体切换为官方 stdio Server,并补齐 license、阶段门控、官方技能、真实工具 schema 与 agent 红线。
本目录是另存的可发布副本,不覆盖
~/.workbuddy/skills/下已安装的旧版。
0. 先读这个:三层架构与前置条件
官方把 AI 能力分成三层,互相依赖,光装技能而 MCP 不通等于没装:
| 层 | 作用 | WorkBuddy 落地 |
|---|---|---|
| MCP | 给模型提供实际操作工程的工具 | 在 ~/.workbuddy/mcp.json 注册官方 com.schneider-electric.esme.mcp/logic-builder-stdio(stdio,非 HTTP) |
| Agent Files | 全会话基线(边界、规则、提问方式) | WorkBuddy 不扫描 *.agent.md;已转写为 esme-mcp-baseline 技能,本 skill 的「红线」章节等价 |
| Skill Files | 特定任务的按需专业知识 | ~/.workbuddy/skills/ 原生支持;官方 7 个技能 + 本 skill |
动手前的四个前置条件(缺一不可,详见 references/mcp-connection.md):
- Agentic AI license file 已放入
C:Program Files (x86)Common FilesSchneider Electric SharedLicenseFiles并重启过 Logic Builder;无 license 时tools/list永远只有 2 个工具。 mcp.json用官方 stdio 配置(dotnet+SE.IA.Motion.RemoteInterfaces.StdioServer.dll),disabled: false。- 官方 7 个技能 +
esme-mcp-baseline已装进~/.workbuddy/skills/。 - Logic Builder 正在运行;WorkBuddy 会话已信任/重载该 MCP Server。
自检命令与判定标准见
references/mcp-connection.md。工具名一律 snake_case,网页表格里的 PascalCase 不是调用名。
1. 何时使用
- 用户要求编写、改写、审查 Machine Expert 中的 PLC 程序(ST 为主)。
- 用户提到「机器专家」「施耐德 PLC」「TM 系列 / M241 / Logic 控制器」。
- 需要把通用 PLC 逻辑改成施耐德正确实现,或确认某个库/功能块的真实名称。
- 涉及 Modbus / Modbus TCP / 串口自由口 →
SEN(PLCCommunication),见references/plc-communication.md。 - 涉及 SNTP / NTP / RTC 校时 →
TIMS(TimeSync),见references/timesync.md。 - TM241 + 高速计数 / 编码器 → M241 HSC,见
references/hsc.md。 - TM241 + PTO / PWM 单轴定位 →
SEC_PTOPWM,见references/ptopwm.md。 - 需要连 MCP、新建工程、建 POU、写代码、编译、保存、下载。
- MCP 工具「不见了」或工具数不对 → 先判阶段门控,见
references/mcp-tools-and-phases.md。 - 用户只要求打开/启动本机软件 →
references/launch-machine-expert.md。
2. 不可违反的红线(官方 agent 基线)
来源 C:ProgramDataEcoStruxure Machine ExpertV2.6Agent Resourcesagentsmachine-expert-agent.agent.md,完整版见 references/official-agent-rules.md。任何技能都不得删掉这些红线,除非用户明确批准。
- 禁止直接读写磁盘上的
.project等工程文件,一律走 MCP 工具;直接改文件会绕过 runtime 状态、可能静默损坏工程。计划、笔记、脚本等非工程文件例外。 - 只能写 ST。SFC / LD / FBD / IL(官方
translation-refactoring技能另列 CFC)读出来的是「自动翻译 ST」的只读视图,引用时必须标注来源性质;用户要求修改时说明工具不支持并停下。要把图形语言翻译成 ST,加载translation-refactoring:它要求绝不修改源对象、只新建_ST副本,且强制 TDD(stubs → Test Cases → 实现)。 - 未经用户明确批准,不得改变可观测 I/O 行为、PLC 周期语义、调用顺序、边沿检测、定时器行为或保持型数据。
- 不得做超出选定目标范围的架构级重命名或跨对象重构。
- 不得假设 method / getter / setter 的局部变量跨调用保持值;持久状态放 FB 实例数据(
VAR_INST是例外)。 - 动手前必须扫描并加载所有描述匹配的技能(
iec-naming-conventions、etest-authoring、automation-project-exploration等),漏加载算错误;生效时说明用了哪个技能。 - 涉及行为 / I/O / 多对象的变更,先输出 Assumptions / Plan / Impact on I/O / Validation / Proceed? 契约并停下等确认,不得直接实现。
- 优先级:用户明确指令 > 已加载的匹配技能 > 本基线。
3. 核心编程原则
- 先查库,再写码。 先用
find_library_element(nameFilter="...", tryAddLibraryIfMissing=false)/read_libraries_in_project确认当前工程里真实存在的库名、功能块、类型与is_library_loaded,绝不凭记忆臆造标识符。 - 优先施耐德应用库,而非通用 CODESYS 库。 通信
SEN、校时TIMS、HSCHSCMain_M241/HSCSimple_M241、PTOSEC_PTOPWM;缺库用load_or_unload_library加载。 - PTO 铁律(TM241):所有 PTO/PWM 功能块、类型、枚举一律来自
SEC_PTOPWM,用完整限定名SEC_PTOPWM.MC_xxxx_PTO;不封装自定义运动 FB;PTO_0…PTO_3由硬件配置自动生成(AXIS_REF_PTO),程序中不重复声明;任何运动/停止命令前必须先SEC_PTOPWM.MC_Power_PTO持续使能,且使能只此一处。 - 命名一律以官方
iec-naming-conventions技能为准(x表 BOOL、c_+ 类型前缀表常量、FB_/FC_/PRG_表 POU、prefix_BaseName结构)。本 skill 的references/coding-standards.md已按官方规范校正,只补充工程结构与声明区;不要再用bXxx/MAX_SPEED/ 无前缀 POU 那套旧建议。标准工程自带的SR_Main/PLC_PRG名称属例外,不改名。 - 写完即编译验证,但要知道编译的边界:编译只覆盖从 Task 调用链可达的代码;用
find_dependencies核实可达性,否则「0 错误」不构成验证证据。 - 注释统一用英文 ASCII:MCP 读回中文注释会乱码,禁止「读回 → 原样写回」。
4. 标准工作流(严格顺序)
细节与真实参数 schema 见 references/mcp-workflow.md。
| 步 | 动作 | 关键工具(snake_case) |
|---|---|---|
| 0 | 加载匹配技能 + 澄清范围(控制器型号、约束、风格);规划调用前先看当前可见工具推断相位 | — |
| 1 | 自检连接与 license;发现并连接 Logic Builder 实例 | find_logic_builder_instances → connect_to_logic_builder(processId=...) |
| 2 | 重新 tools/list 判相位;缺工具先判断是不是相位没到,别当故障 | tools/list |
| 3 | 核实事实:定位应用、查库与签名、搜索既有模式,优先复用已有 FB/DUT | list_controllers_and_applications、set_active_application、find_library_element、read_project_element、find_in_code |
| 4 | 审批门:输出 5 段契约后停下等确认(涉及行为/I/O/多对象时必需) | — |
| 5 | 实现:只读写请求对象;声明与实现分开;状态机用 CASE OF;显式初始化 FB 输入与状态 | create_pou(pouName, pouType)、write_declaration_and_implementation(codeObjectName, declaration, implementation) |
| 6 | 验证与迭代:编译、find_dependencies 查 Task 链、跑范围内测试 | compile_app、find_dependencies、run_specific_test |
| 7 | 保存(可选登录下载) | save_project、login_and_download |
相位变化后必须刷新工具清单:
create_project/open_project会触发listChanged,之前的工具名可能还没出现。简单任务只给最终结论;非简单任务附简短报告(变更对象、行为差异、验证证据、遗留风险/假设)。
4.1 匹配官方技能时的路由边界(官方 skills 对比审查后补充)
上表的「实现」只适用于局部、边界明确的 ST 编码。任务命中下列官方技能时,该技能流程优先,不要直接跳到写码:
| 任务 | 必须加载 | 覆盖本流程的约束 |
|---|---|---|
| 架构级改造(模板生成 / 剥离 / 库迁移 / 重构 / 加模块) | automation-project-exploration | 只出计划、不执行;按 architecture.md 规则 ID 出有序步骤与验证清单,等用户反馈 |
| 图形语言 → ST 翻译重构 | translation-refactoring + etest-authoring | 绝不改源对象(只建 _ST 副本);强制 TDD(stubs → Test Cases → 实现);先审批门 |
| ETEST 单测 | etest-authoring | 多数工具要 ProjectWithCode 相位;Test Set 表头须与 STRUCT 字段同名同序;跑测试前禁止手动 login_and_download 或配置 task / library(工具自动处理) |
| 硬件拓扑 / 设备增删改 | hardware-topology-configuration | find_possible_device_trees 必须先于 add_devices;多控制器须先请用户确认目标;改后重读子树 |
| 多核并行化 | plc-parallelizability-analysis | 只出并行化计划,等用户指令再实施 |
| 架构文档 / arc42 | automation-architecture-analysis | 按 arc42 元模型出文档,用 find_dependencies 取证;MCP 不可用时标注「未由 MCP 验证」 |
与红线第 6 条一致:动手前先扫描并加载所有描述匹配的技能,漏加载算错误。
5. 工具与阶段门控速查
- 官方帮助表 71 个工具,但不是任何时候都全部可见。Composition:
Free License 53+Professional License 14(全是 ETEST)+Machine Code Analysis add-on 4(code_smells/find_dependencies/most_complex_code/most_used_code)。 - 系统相位
Unconnected(0) → Connected(1) → EmptyProject(2) → NonEmptyProject(3) → ProjectWithCode(4);另有独立部署/授权轴。 - 本机实测工具数:2(无 license)→ 13(已连接未开工程)→ 50(建工程瞬间)→ 67(工程已打开的新会话)。
- 所以「工具数不是 71」通常不是故障:先查 license、再查工程有没有打开、最后查附加授权。
- 完整清单、门控实现与排错见
references/mcp-tools-and-phases.md。
6. 参考资料(按需加载,避免占满上下文)
| 文件 | 何时读 |
|---|---|
references/mcp-connection.md | 接线前置:官方 stdio 配置、license、自检、组件核查、旧 HTTP 方案为何废弃 |
references/mcp-workflow.md | 动手前必读:真实工具名、参数 schema、调用顺序、编译缓存/中文乱码等踩坑 |
references/mcp-tools-and-phases.md | 工具消失/数量不对、71 工具分组与授权、阶段门控判定 |
references/official-agent-rules.md | 需要完整官方 agent 红线、审批门契约、DoD、输出格式时 |
references/v261-project-facts.md | 新建 TM241CEC24T 工程、核对 create_project schema 与设备库版本 |
references/libraries.md | 判断某任务域该用哪个施耐德库 |
references/plc-communication.md | Modbus / 串口自由口(SEN,6 个 FB、ADDM 地址格式) |
references/timesync.md | SNTP / RTC 校时(TIMS)、SysTimeRtcGet 的 VAR_IN_OUT 与无符号秒 |
references/hsc.md | TM241 高速计数 / 编码器(HSCMain_M241 / HSCSimple_M241 + EXPERT*) |
references/ptopwm.md | TM241 PTO/PWM(SEC_PTOPWM 铁律、引脚、枚举、实例名规则) |
references/pto_sr_main_example.md | 可直接套用的 SR_Main(使能→回原点→复位→相对定位→停止) |
references/coding-standards.md | 工程结构、变量声明区、官方命名规范摘要(iec-naming-conventions 校正版)、创建顺序与落地工具 |
references/st-patterns.md | ST 常用语法、时序、状态机、边沿检测模式 |
references/full-project-example.md | 端到端范例(v1.x 历史工程,设备版本以 V2.6.1 实测为准) |
references/launch-machine-expert.md | 启动本机软件(环境变量重复致 MAF mini 崩溃、explorer.exe 启动) |
references/skillhub-publish.md | 重新打包发布到 SkillHub 时的格式与白名单约束 |
7. 常见坑(一句话版)
| 现象 | 处理 |
|---|---|
tools/list 只有 2 个 | Agentic AI license 未生效;放 .lic 后重启 Logic Builder |
只有 13 个工具、没有 create_pou | 相位停在 Connected,先 create_project / open_project 再刷新 tools/list |
HTTP localhost:21003/mcp 401 / 端口每次变 | 那条路已废弃,走官方 stdio;21001/21002 是 MafMini 内嵌 API(需 JWT) |
create_project 报参数错 | 必填是 type / directory / name / fileType,不是 projectPath |
| 设备版本对不上 | 用 find_repository_device(nameFilter="TM241CEC24T") 现场查(本机现为 5.5.14.29) |
标准工程 create_pou(SR_Main) 报重名 | 标准工程自带主程序,属预期,直接 write_... 覆盖写入 |
改写已有 POU 后 compile_app 说「已是最新」 | 编译缓存;新建临时 POU 装待测代码再编译,验证后删除 |
MCP 读回中文注释变 ADDM銆? | 读取侧编码问题;禁止原样写回,只改 ASCII 行或用干净 UTF-8 模板整体覆盖 |
| MAST 任务调用列表改不了 | MCP 不支持;把子 POU 调用加到主程序 SR_Main 末尾等价 |
帮助弹 cannot listen on port 8000 | 与 MCP 无关,8000 落在 Windows/Hyper-V 保留段 7951–8050 |
| 技能装了没效果 | 三层互相依赖,先跑自检脚本确认 MCP 连通 |
8. 版本历史(Changelog)
v2.0.1 (2026-11-09) — 发布文档与显示名修正
displayName去掉「(PTO/PWM/HSC …)」括号后缀,统一为施耐德机器专家编程规范;V2.6.1 信息仍保留在 description 与 tags。references/skillhub-publish.md按 2026-11-09 实测修正:服务端白名单新增拒绝.png/_icon.png(400)、--dry-run不检查白名单、登录凭据位置、网页发布/审核入口 URL、发布记录与检查清单;发布包不再含二进制图标(备份在工作空间根)。- 其余规则正文、ST 示例与 MCP 工具说明与 v2.0.0 完全一致。
v2.0.0 (2026-11-09) — 按 V2.6.1 官方 Agentic AI 规则重写
- 接入方式整体替换:废弃 v1.x 的「HTTP + 动态端口 + 端口探测脚本」,改为官方
Agentic AI > Copy to Clipboard > MCP Config (JSON)的 stdio 配置(dotnet+StdioServer.dll)。references/mcp-connection.md全文重写,保留旧方案作为排错说明。 - 补齐官方三层架构与前置条件:MCP / Agent Files / Skill Files 在 WorkBuddy 的落地方式;Agentic AI license file 与重启要求;官方 7 技能 +
esme-mcp-baseline基线。 - 新增官方 agent 红线(8 条)、审批门 5 段契约、编译可达性、DoD 与输出格式 →
references/official-agent-rules.md。 - 新增 71 工具分组 + 授权 + 阶段门控(2 / 13 / 50 / 67 实测)与 snake_case 命名规则 →
references/mcp-tools-and-phases.md。 - 新增 V2.6.1 实测事实:
create_project真实 schema、find_repository_device、设备5.5.14.29、标准工程自带SR_Main、编译 0 错 1 警 →references/v261-project-facts.md。 references/mcp-workflow.md全文重写为真实 snake_case 工具名与参数 schema,保留并修订 v1.x 的 5 个实测踩坑。references/libraries.md修正运动控制库表述,明确 TM241 内置 PTO 用SEC_PTOPWM、SoftMotion 用SM3_Basic,二者不可混用。references/full-project-example.md修正设备查询工具名与版本,并标注为 v1.x 历史范例。- 新增
references/skillhub-publish.md(发布 frontmatter /.st白名单 / 包大小约束)。 - frontmatter 更新为
displayName带 V2.6.1 标识、version 2.0.0,tags 增加 Agentic AI / MCP / stdio / 阶段门控 / SEC_PTOPWM / TM241CEC24T。 - 同日与官方 7 个 skills 逐条对比后的校正:
coding-standards.md命名规范按官方iec-naming-conventions重写(原b表 BOOL、全大写常量、无前缀 POU 等与官方冲突);补 CFC 只读视图、官方技能路由边界(架构改造只出计划、翻译重构强制 TDD、ETEST 禁手动 login、硬件先查候选树)、find_repository_device嵌套结构与ModuleId、枚举参数整数索引、ETEST 的ProjectWithCode相位要求;create_udt修正为create_dut。
v1.2.0 (2026-09-21)
- 新增
references/launch-machine-expert.md(大小写重复环境变量导致 MAF mini 崩溃、须用explorer.exe启动)。 - description 补充「启动/打开本机软件」触发场景。
v1.1.0 (2026-08-03)
- 新增
references/mcp-connection.md(当时的 HTTP 动态端口方案,v2.0.0 起废弃)与references/full-project-example.md。 - 补充
SysTimeRtcGet直接读 PLC 时钟、无参 MCP 工具须传{}、PTO 实例确认要点。