多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

Automotive Skills Suite 10个常见误区与避坑清单:如何让xlsx契约长期保持一致

Automotive Skills Suite 10个常见误区与避坑清单:如何让xlsx契约长期保持一致 Automotive Skills Suite 10个常见误区与避坑清单如何让xlsx契约长期保持一致【免费下载链接】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-suiteAutomotive Skills Suite 是一套覆盖汽车工程的 152 个 Claude 技能76 个 builder 从 JSON 生成结构化 xlsx 交付物ISO 26262 功能安全、ISO/SAE 21434 网络安全、AIAG-VDA 质量、AUTOSAR 等76 个 reviewer 逐项复核下游技能把上游的 xlsx 当作契约读取——这条 xlsx 契约链是整套工具的核心资产也是最容易悄悄烂掉的地方。下面 10 个误区全部来自仓库里真实发生过的问题文末附一份可直接抄的避坑清单。一、先搞懂xlsx 契约的三层结构每个 builder 的输出都是一本多工作表的 xlsx它对下游的契约分三层层次内容断了会怎样工作表名NN_Name命名规范如05_TSR_Catalog下游找不到表整条读取链路失效列顺序 表头文字如第 5 列是Mechanism数据整体错位一列值悄悄串位数据起始行表头之下的第一行数据开头几行数据永远不会被读到整条链长这样摘自 README.mdItem Definition → Safety Plan → DIA ↓ HARA → FSC → TSC ↓ ↓ HW Lane SW Lane ↓ ↓ Safety Case链是护城河链越长一次契约漂移的波及面越大。二、10 个常见误区每个都对应一个真实事故 ⚠️误区 1只要工作簿能生成xlsx 契约就算成立表名对上 ≠ 列语义对上。最新一轮审计记录了 12 个 COL-SHIFTsw-arch-builder把03_System_Architecture表的第 5 列当 ASIL 读而它读的上游tsc-builder里第 5 列是RTOS / OSASIL 实际在第 6 列——工作簿照常生成数据却整体错位。怎么避改过列顺序后跑一次列级审计别只看能跑通。误区 2工作表重命名只是外观改动Excel 对工作表名有硬性 31 字符上限。openpyxl 不会截断只打印一条警告就把超长名写进文件——Excel 打开时会修复并自动改名下游所有按精确表名查找的代码全部落空。docs/sheet-name-length-audit.md 审计到 10 个技能里 19 个超长表名最严重的triggering-conditions-builder一张表 44 字符、超了 13 个。怎么避命名前先数字符数确保 ≤ 31。误区 3只改 builder下游回头再同步改一处表名、下游读者下周再改中间就是断裂窗口。仓库里cs-architecture-builder的读者期望的表名与cs-concept-builder实际输出的表名漂移了整整四周期间一个真实概念工作簿静默地读出零条 CSR过程见 docs/skill-polish-log/cs-architecture-builder.md。怎么避表名变更与所有下游读者放在同一个提交里。误区 4要时刻盯着 builder 和 reviewer 是否漂移其实它们是成对捆绑的reviewer 和它审查的 builder 一起发布、一起变动不会像builder 读另一个 builder那样漂移。审计脚本 scripts/chain_contract_audit.py 因此刻意只审 builder→builder 的读取。怎么避别浪费精力在成对审查上把防线放在跨技能交接处。误区 5读错了总会报错很好发现最危险的读错是无声的零行、零崩溃。cs-goals-builder曾把 TARA 的目标文本和资产读成串位hw-safety-reqs曾在上游 TSR ID 漂移时静默丢弃覆盖项——两份工作簿都看起来正常。怎么避把 reviewer 跑在 builder 的真实输出上并抽查一个只存在于输入里的字段仓库对追踪矩阵的修复正是这样验收的。误区 6表头文字无所谓列位置对就行表头文字同样是契约内容。按名称查找的读者去匹配CSR ID却找不到CSR_ID——审计里这类判定叫 NAME-MISS。怎么避把表头文字当稳定标识改动时保留旧名作别名。误区 7数据起始行差一行最多丢一行数据读者的数据循环比上游表头多低一行起步ROW-SKIP开头的数据行就永远读不到——工作簿看着满下游拿到的是少了一截的行。怎么避审计时确认读者起始行 上游表头行 1。误区 8子串匹配太松不如精确匹配恰恰相反审计文档明确说按子串扫描wb.sheetnames的读者是其他读者应当趋近的形状因为表名怎么改它都不容易断。真正的风险在另一头——子串打错时什么都匹配不到SCAN-MISS其下所有读取全部失效。怎么避优先子串扫描必须用精确表名时配一组别名回退。误区 9xlsx 契约开发时检查一次就够了契约漂移是持续发生的上游任何一次列顺序或表名调整都可能打断下游读者。仓库的解法是只读静态审计——scripts/chain_contract_audit.py 回答上游是否输出这张表scripts/column_contract.py 回答这张表在读者使用的位置上是否带着读者以为在读的那一列。最新一轮结果50 条表名断言45 MATCH / 4 ALIAS / 1 FALLBACK / 0 BREAK187 条列级断言其中 13 条列级 BREAK12 COL-SHIFT 1 SCAN-MISS。怎么避把重新生成审计放进每次变更的流程见 docs/chain-contract-audit.md。误区 10契约断了只能推倒重来仓库的实际修复手段全是渐进式的别名组一个首选名 遗留名的常量数组任一命中即接受#43 修复时引入的形状回退分支同一张表用elif/or表达兄弟分支能对上即判 FALLBACK 而非 BREAK配对别名登记docs/PAIRING_ALIASES.md 记录了两对特殊命名item-definition↔item-def、ppap-package↔ppap——改名需要重新打包并会让已安装副本失效所以登记别名才是正解。怎么避发现断裂先看审计判定ALIAS / FALLBACK / BREAK再选最小补丁。三、避坑清单7 条可以直接抄 ✅#动作防的是哪个误区1表名 ≤ 31 字符遵循NN_Name规范22改表名builder 下游读者 reviewer 同一提交33改列顺序后跑列级审计当前 128/187 为 COL-MATCH别做下一个 COL-SHIFT1、74表头文字当契约字段改动保留旧名别名65读者优先子串扫描精确表名必须配别名回退86reviewer 跑一次 builder 真实输出并抽查输入独有字段57每次变更后重新生成契约审计报告9四、xlsx 契约审计工具与报告去哪里查契约审计报告docs/chain-contract-audit.md表级 列级判定每条链一行审计脚本scripts/chain_contract_audit.py支持--check发现 BREAK 即退出码 1、scripts/column_contract.py表名长度审计docs/sheet-name-length-audit.md审计范围为何收窄到 builder→builderdocs/weekly/WEEK-2026-W34.md配对别名登记docs/PAIRING_ALIASES.md执行验证用的示例输入examples/traceability-matrix-builder/sample_input.json、examples/mbse-system-context-builder/sample_input.json全部 152 个技能skills/五、新手上手三步安装、触发、传链从 skills/ 挑一个.skill或从 Releases 拿完整包在 Claude Desktop 点Save skill安装用自然语言触发例如Build a HARA for a new ECU project技能会按自己的触发描述自动匹配把 builder 产出的 xlsx 交给链上下一个技能链较长时交付前重新生成一次审计。记住一句话就够了表名是门列序是座表头是安全带——三者任何一项松动xlsx 契约就已经断了。【免费下载链接】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),仅供参考
返回列表