Agent Skills
返回列表
合同字段字典·设备级联扩展

合同字段字典·设备级联扩展

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_6e9e5478/fielddict-device-cascade。

技能介绍

要解决什么问题

《合同字段字典与选项库设计》类工作簿在第五表「填报模板示例」里靠数据验证做下拉:选设备名称后,规格型号应只出现该设备在 _cascade 里维护的清单。若只在第二表 OPT-072(设备主数据库) 加一行,而未同步 _cascade、命名区域和第五表的 VLOOKUP/INDIRECT 链,表面有设备名,级联仍失效或指向旧区域。

本技能覆盖从架构核对到落地验证的完整路径:理解 _cascade(A 显示名、B 短键、E 列起各短键一列规格)、DevListGen/DevListPile 与第五表 C9/E9/C10、C17/E17/C18 公式关系,以及第二表级联选项集 OPT-0xx 与 OPT-072 的配套扩展。

技能如何工作

  • 首选自动化:运行 scripts/extend_device_cascade.py,参数包括 --name、--key、--cat(通用|桩基)、--specs(| 分隔)、可选 --brand、--demo;脚本负责备份、块末追加 _cascade 行与规格列、建命名区域、扩展下拉与 VLOOKUP 范围、第二表追加设备与选项集。
  • 手动路径:备份后在对应类别块末尾追加行与新列,扩命名区域与 DevListGen/DevListPile,扩第五表 E 列 VLOOKUP 的 $B$ 上界,再在第二表维护 OPT-072 与新级联选项集。
  • 自检:扩展或怀疑下拉错位时,用 audit_consistency.py 做全表引用闭环审计(ERROR/WARN/OK),按字段字典→选项集→_opts 列头修复第五表 DataValidation。

边界与易错点

绝不在 _cascade 块中间插行,否则会连带移位所有短键命名区域与 VLOOKUP 范围。短键须纯字母数字且与命名区域名一致,区域行数须等于规格条数。保存建议用 openpyxl;合并单元格导致 OPT-072 无法按预期写入时,脚本会告警并改为末尾追加。扩展后应验证:选设备名 → E 得短键 → INDIRECT 解析出规格清单(技能内称 CASCADE WORKS)。

使用场景

  • 在设备主数据库 OPT-072 登记新机型后,需让第五表填报模板里规格型号随设备名自动收窄下拉。
  • 用户反馈「选了设备名但规格型号仍是全表选项」,需在 _cascade 与命名区域上补全该设备的二级联动。
  • 给桩基及基坑类设备走 DevListPile 链路时,要追加短键列并在 C17/C18 一带恢复级联公式闭环。
  • 历次修改后出现第五表下拉列头与 OPT 编码不一致,需用审计脚本定位 ERROR 再按字段字典重设 DataValidation。

适合人员

  • 维护《合同字段字典与选项库设计》工作簿的实施顾问,常被要求「新增设备并让填报模板级联生效」。
  • 用 openpyxl 批量改选项集与 _cascade 的后端或数据同事,需要避免中间插行弄乱命名区域。
  • 合同填报模板的 Excel 模板负责人,负责核对第五表约 27 处数据验证与级联 INDIRECT 是否仍闭环。
  • 排障时怀疑 _opts 列头与第二表 OPT 编码脱钩的质控人员,需要 ERROR 级审计报告对症修复。