前言¶
水利、土木方向的工程计算越来越多落在 Python 脚本里：查表、分段公式、迭代求根、多工况批算都在代码里实现。常见风险不在语法，而在公式抄错、适用条件越界、数值不收敛，以及 sqrt 负数、asin 越域、除零等运行时隐患。单靠人工翻规范对照每一行，成本高且容易漏项。
下面介绍 SkillHub 上的社区 Skill「工程计算脚本审查」。它把审查拆成固定五阶段流程，面向「审查 / 校验 / debug 工程计算 Python 脚本」或「核对结果是否符合行业规范」这类任务，由 Agent 按 SKILL 约定逐步执行，而不是泛泛地「帮你看一下代码」。
这是什么¶
「工程计算脚本审查」是 SkillHub 坐标 @user_ddcb4786/engineering-script-audit 下的 Agent Skill（版本 1.0.0，分类 dev-programming，来源 community，发布者 user_ddcb4786）。页面标注 requires_api_key=false，不依赖额外 API Key。
官方页面：https://www.skillhub.cn/skills/user_ddcb4786/engineering-script-audit
API 入口：https://api.skillhub.cn/user_ddcb4786/engineering-script-audit
SkillHub 展示数据（以页面与抓取资料为准）：评分 100000，下载 1164 次。
核心功能：五阶段审查流程¶
简介中给出的能力可概括为五条，对应一次完整审查的主线：
-
对照规范原文验证公式实现
将脚本中的公式、系数、查表逻辑与所引规范条文对照，检查是否实现一致、有无漏项或符号/量纲错误。 -
公式适用范围校验
检查输入参数是否落在公式或查表的有效范围内。资料中举的例子包括 δ/H 分类、P1/H 边界等——即分段公式是否用对了区间、查表键是否越界。 -
数值方法收敛性与稳定性分析
针对迭代、求根、联立求解等数值过程，评估是否可能不收敛、步长或初值是否合理、是否存在病态条件。 -
防护性审查
识别高风险运算：sqrt负数、asin/acos越域、除零、数组越界等；并建议添加带物理含义的验证守卫（而不仅是静默try/except）。 -
多工况交叉验证
在多个工况或边界条件下交叉核对结果，并纳入物理约束（资料中示例为 Fr=1 等临界或一致性检查）。
适用表述（来自官方简介）：用户要求审查、校验、debug 工程计算 Python 脚本，或验证计算结果是否符合行业规范时使用。
安装与启用¶
Skill 基于通用 SKILL.md 格式。安装方式以 SkillHub 官方说明为准。
方式一：让 Agent 按文档安装¶
将下列意图发给当前使用的 AI（Cursor、Claude Code 等均可按同一提示操作）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_ddcb4786/engineering-script-audit`。
Agent 会按 SkillHub 安装与优先源配置 检查 CLI、选择正确的 skills 目录并完成安装。
方式二：本机 skillhub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，官方推荐完整安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。官方文档给出的常用路径示例：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式（将 <skills 目录> 换成上表对应路径）：
skillhub install user_ddcb4786/engineering-script-audit --dir <skills 目录>
文档说明：装到正确目录后，部分环境仍需重启或刷新 Agent 才能识别新 Skill；具体以你所用客户端为准。
典型用法¶
官方页面未附带独立示例仓库，可复现的用法是：在已启用该 Skill 的会话中，明确发起审查任务并附上脚本与规范依据。
示例提示（可按项目改写）：
请用工程计算脚本审查 Skill，审查我这份渗流/水力计算的 Python 脚本：
1. 对照 SL xxx 规范条文检查公式与查表；
2. 检查 δ/H、P1/H 等参数是否落在公式适用范围内；
3. 看迭代求根是否稳定；
4. 标出 sqrt、除零等风险并建议物理含义明确的守卫；
5. 对多工况做交叉验证，含 Fr=1 等物理约束。
脚本路径：./calc/runoff.py
规范：请以我消息里粘贴的条文为准。
先做环境准备（安装 Skill 到正确目录），再在对话中说明脚本位置、规范名称或条文摘录、关心的工况与输出量。Agent 应按 Skill 内五阶段流程组织结论，而不是只做静态 lint。
适用场景与注意¶
适合谁
- 编写或维护水利、土木相关 Python 计算脚本的工程师；
- 需要把实现与行业规范对齐、或排查「结果看起来不对」的数值问题时；
- 希望在交付前系统过一遍适用条件与数值/防护风险，而非单次 ad-hoc 问答。
限制与注意
- 审查质量依赖你提供的规范条文、参数含义与工况说明；Skill 不能替代持证工程师的签审责任。
- 社区来源（
community），使用前建议在 SkillHub 页面确认版本仍为 v1.0.0 及更新说明。 - 分类为
dev-programming，面向开发侧审查流程，不等同于商业软件的全量认证测试。 - 安装统计中「安装 0」与「下载 1164」并存，可能表示用户多通过 CLI/提示词安装而未回传安装计数；以你本机
skills目录是否出现该 Skill 为准。
结尾¶
「工程计算脚本审查」把水利与土木 Python 脚本的核对工作收成五阶段：规范对照、适用范围、数值稳定性、防护性运算、多工况交叉验证。若你经常在 Cursor 或 Claude Code 里写工程算例，可按 SkillHub 文档安装 @user_ddcb4786/engineering-script-audit，在审查类任务中显式调用。
官方地址：https://www.skillhub.cn/skills/user_ddcb4786/engineering-script-audit
