Agent Skills
返回列表
工程计算脚本审查

工程计算脚本审查

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ddcb4786/engineering-script-audit。

技能介绍

解决什么问题

工程计算脚本的问题常不在语法,而在公式抄录错误、适用条件漏判、数值求解不稳、非法输入导致崩溃。这个技能面向水利、土木、水力学等工程计算脚本,处理公式审查、规范校验、计算结果异常排查和数值代码 Debug,尤其是 SL、GB、DL 等规范下的公式一致性检查。

技能如何工作

它按工程审查思路分阶段推进:

  • 公式对照规范验证:先提取核心公式,标注代码位置、变量含义和公式来源;优先使用用户提供的规范原文或可检索条文,项目内 formula_reference.md、计算书草稿等中间文档只能作为低置信度线索。最终结论区分 PASS、WARN、FAIL,并标注置信度。
  • 适用范围校验:检查 δ/H、P1/H、H0/Hd、Fr 等参数是否落在规范有效范围内,查表是否发生不可靠外推,分类判别在边界附近是否连续。
  • 数值稳健性检查:审查迭代求解器,优先用二分法在物理合理区间定位,再考虑牛顿法精化;同时检查初值、收敛准则、最大迭代、除零、负数开方和对数奇异。
  • 防御守卫与结果校核:要求高风险运算返回带物理含义的清晰错误,而不是直接抛出 Python 堆栈;再结合量纲、守恒、单调性和退化工况验证结果是否可信。

适用边界

该技能更适合对已有工程计算脚本做审查、复核和排错,不等同于自动出具完整设计书。若缺少规范原文,部分结论只能作为待确认项,不应直接当作最终缺陷。

使用场景

  • 审查溢洪道堰流脚本中的挑距、流量系数公式是否按 SL253-2018 规范实现。
  • 排查明渠临界水深迭代不收敛、牛顿法选错根等数值求解问题。
  • 检查 P1/H 查表参数是否超出定义域,避免流量系数外推。
  • 为负数开方、零除、对数奇异等运算添加防御守卫,避免非法输入崩溃。

适合人员

  • 需要复核水利计算脚本是否符合 SL、GB 或 DL 规范的水利工程师。
  • 正在排查水力学脚本迭代不收敛或结果异常的研发工程师。
  • 需要审查查表公式适用范围和参数边界的水工设计人员。
  • 负责给工程计算代码补防御性校验并输出审查结论的后端开发者。