车载诊断自动化清单:Automotive Skills Suite 如何构建UDS服务目录、DTC目录与ODX数据库
【免费下载链接】automotive-skills-suite100+ installable Claude skills covering Engineering areas such as, ISO 26262 functional safety, ISO/SAE 21434 cybersecurity, ISO 21448 SOTIF, AIAG-VDA quality (APQP/PPAP/FMEA), Automotive SPICE, and continuous improvement tools — every builder paired with a confirmation reviewer.项目地址: https://gitcode.com/gh_mirrors/au/automotive-skills-suite
在 Automotive Skills Suite(车载工程技能套件)中,诊断工程师最常用的三类自动化交付物是UDS 服务目录、DTC 故障码目录和ODX 诊断数据库——这三类 xlsx 工作簿过去往往需要逐行手填、跨表核对,而该套件用 152 个可安装的 Claude 技能,把"JSON 输入 → 标准化 Excel 输出 → 自动审查"整条链路变成了对话式操作。🛠️
为什么诊断文档总在做"手工搬运"?
一个 ECU 上线前,诊断相关文档通常包括:服务清单、DID/RID 目录、会话与安全访问、NRC 矩阵、DTC 定义、快照数据、OBD 映射……每一项都要按标准逐条核对,稍有遗漏就会在客户审核(audit)中被打回。
Automotive Skills Suite 的思路是:每个 builder 技能负责"生成结构化 xlsx",配对的 reviewer 技能负责"跑确认检查清单"。上游改一处,下游所有依赖它的文档自动对齐——官方称之为"链式合同(chain contract)",审计思路可参考 docs/chain-contract-audit.md。
快速上手:3 步安装诊断技能
- 获取仓库:
git clone https://gitcode.com/gh_mirrors/au/automotive-skills-suite(仓库为只读镜像,请勿改动内容) - 安装技能:从
skills/目录选取.skill文件,在 Claude Desktop / Cowork 中点击 "Save skill" 安装 - 用自然语言触发:技能会在 frontmatter 中声明触发描述,直接说"Build a UDS services catalog for the BCM"即可命中
uds-services-builder
三个核心技能文件一览:
| 技能 | 对应标准 | 产出 |
|---|---|---|
| skills/uds-services-builder.skill | ISO 14229-1 | 13 标签页 UDS 服务目录 |
| skills/dtc-catalog-builder.skill | ISO 14229-1 / SAE J2012 | 12 标签页 DTC 目录 |
| skills/odx-builder.skill | ISO 22901-1 | 13 标签页 ODX 编制工作簿 |
构建 UDS 服务目录:13 个标签页一次成型
uds-services-builder从一份 JSON(ECU 身份、会话定义、服务清单、DID/RID 目录、安全访问、NRC、P2/P2*/S3 时序、Flash 布局)生成13 个标签页的审计级工作簿:
- 服务清单:覆盖 0x10–0x86 全部诊断服务及子功能
- 会话与安全:默认 / 编程 / 扩展会话,SecurityAccess 等级与 seed/key 算法引用
- DID / RID 目录:读写数据标识符、例程 ID 及会话/安全限制
- NRC 矩阵 + 时序参数:负响应码含义、P2/P2*/S3 毫秒级取值
- 记忆编程布局:Flash 起始地址、擦除块大小
官方示例演示了完整的输入输出形态:输入一个车身控制 ECU 的诊断规格桩,输出含32 个 DID、9 个 RID、4 级安全访问的BCM-uds-catalog.xlsx,详见 examples/uds-services-builder/README.md。
💡 小技巧:技能间有明确分工——协议无关的服务目录用 UDS builder;要 ODX 导出的话转
odx-builder;要 Vector CANdela 数据库用cdd-builder;只管理 DTC 库存用dtc-catalog-builder。
构建 DTC 目录:从故障码清单到 OBD 映射
dtc-catalog-builder按 ISO 14229-1 与 SAE J2012 生成 12 个标签页的目录,工作流分三步:
- 收集 DTC 清单——Pxxxx / Bxxxx / Cxxxx / Uxxxx 编码、故障类型、严重度、MIL 触发与 limp-home 行为
- 组装 JSON 输入——含快照数据绑定、扩展数据、去抖(debounce)目录与自愈(healing)规则
- 审查迭代——重点检查 DTC 唯一性、状态掩码位、快照 DID 完整性、OBD 就绪监控对齐
其中Debounce Catalog(计数器式 / 定时器式算法及参数)与Healing Logic(每个 DTC 的清除条件)往往是审核关注点;OBD Mapping标签页则把每个排放相关 DTC 映射到 OBD-II 就绪监控器。
构建 ODX 数据库:分层结构与变体继承
odx-builder按 ISO 22901-1 生成 ODX 编制工作簿,核心是理解四层结构:
- ODX-D(Data):请求/响应服务定义、参数语义
- ODX-C(Communication):总线参数、物理通道、时序
- ODX-V(Vehicle):整车网络拓扑、ECU 映射
- ODX-FD(Flash Data):刷写编程、内存布局
工作簿还包括Base Variant / Derived Variants标签页描述 ECU 变体层级与属性继承(Inherit-From 关系),以及PDU Library处理 PDU 定义与复用(multiplexing)——这让"一个基础变体 + 多个派生变体"的量产诊断数据交换结构得以标准化维护。
审查员技能:30+ 项检查 + 可视化仪表盘
每个 builder 都有配对 reviewer。以 skills/uds-services-checklist-reviewer.skill 为例,它对 13 标签页的 UDS 目录执行30+ 项符合性检查:
- 服务清单完整性(0x10–0x86 支持情况)
- DID / RID 唯一性与地址范围
- 安全访问配置完整性、会话依赖规则
- P2 / P2* / S3 取值范围合法性
输出是一份审查清单 xlsx,含 KPI 瓦片、合规度饼图与 findings 表格,评级分为 FC / LC / PC / NO / NA 五档——审查员只报告差距,不修改源文件,保证交付物不可变、审计轨迹清晰。
诊断技能全家桶:5 对技能如何分工
| 技能对 | 适用场景 |
|---|---|
| uds-services-builder + reviewer | ISO 14229-1 协议级服务目录 |
| dtc-catalog-builder + reviewer | DTC 定义、快照、去抖、OBD 映射 |
| cdd-builder + reviewer | Vector CANdela 诊断数据库 |
| odx-builder + reviewer | ISO 22901-1 ODX 数据交换 |
| dem-config-builder + reviewer | AUTOSAR DEM 运行时配置(NvM、OBD 冻结帧) |
典型链路:UDS 服务目录 → DTC 目录 → ODX 数据库 → DEM 配置,前者输出即后者输入,构成稳定的文件格式合同。
常见疑问:诊断文档该从哪一份开始?
Q:新项目第一份文档是什么?从 UDS 服务目录开始,它定义了服务、DID/RID 与安全框架,后续 DTC 与 ODX 都以此为锚。
Q:xlsx 输出能直接交给客户吗?能。所有 builder 输出采用统一的 NAVY/Calibri 样式与 ASIL 色码,reviewer 仪表盘可作为审核证据。
Q:技能输出格式会变吗?不会。下游技能以上游 xlsx 为固定契约消费,详见 README.md 中 "The chain" 一节的链路图。
✅ 一句话总结:把 ECU 诊断规格丢给 Claude,UDS 目录、DTC 目录与 ODX 数据库在几分钟内成型,审查员再帮你把 30 多项合规风险逐一清零。
【免费下载链接】automotive-skills-suite100+ installable Claude skills covering Engineering areas such as, ISO 26262 functional safety, ISO/SAE 21434 cybersecurity, ISO 21448 SOTIF, AIAG-VDA quality (APQP/PPAP/FMEA), Automotive SPICE, and continuous improvement tools — every builder paired with a confirmation reviewer.项目地址: https://gitcode.com/gh_mirrors/au/automotive-skills-suite
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考