Files
wind_power_cal/.agents/skills/edge-protocol-research/SKILL.md
T
2026-07-14 15:43:18 +08:00

2.1 KiB

name, description
name description
edge-protocol-research edge_collector 协议调研与适配评估规范。用于调研 FANUC、西门子 CNC、PLC、传感器、第三方 SDK 或参考仓实现时,按当前协议模板、驱动代码、参考实现、官方资料和验证计划输出适配差异、点位补充和实现建议。

edge_collector 协议调研

适用场景

  • 新增协议驱动。
  • 完善 FANUC/西门子 CNC 点位。
  • 参考外部仓采集程序。
  • 判断第三方 SDK 架构和库是否可用。
  • 协议模板是否合理、是否缺常用点位。

调研顺序

  1. 读取当前协议模板和用户可见描述。
  2. 读取当前驱动实现和文档。
  3. 对比参考仓或历史实现。
  4. 拿不准的协议语义联网查官方资料或 SDK 文档。
  5. 输出差异、风险、实施建议和验证计划。

当前项目路径

优先查看:

  • configurator/config/templates/
  • configurator/config/protocols/
  • collector/src/driver/
  • collector/docs/protocols/
  • third_party/
  • collector/CMakeLists.txt

对比重点

  • 连接参数是否够用。
  • 点位名称、类型、单位、默认采集周期是否合理。
  • 模板点位和驱动读取逻辑是否一致。
  • 是否保留现有 PointData::UpdateValue 行为。
  • 用户可见协议介绍是否隐藏内部技术细节。
  • 第三方库是否按架构分层放置。
  • ARM64/ARM32/x64 构建模式是否明确。

联网规则

遇到以下情况必须联网查证:

  • 协议函数含义不确定。
  • SDK 架构、库名、系统依赖不确定。
  • 西门子/FANUC 指标语义不确定。
  • 第三方资料可能过期。

优先官方文档、SDK 手册、厂商资料;社区资料只能作为补充。

输出格式

## 当前现状

## 参考实现差异

## 点位/参数建议

## 驱动实现建议

## 构建与第三方库影响

## 用户文档影响

## 验证计划

## 风险与待确认

禁止事项

  • 不凭猜测写协议语义。
  • 不提交未知来源二进制库。
  • 不把参考仓问题照搬进当前工程。
  • 不在用户可见协议介绍中写 helper、SDK 路径、库文件细节。