为 Codex 和其他 AI Agent 提供面向燃气轮机与热力机械系统 MATLAB/Simulink 建模和验证的工程化工作流。
设计点 → 稳态闭合 → 动态初始化 → Simulink 实现 → 验证
本仓库包含两个开源 skill，将热力系统建模经验整理为可分阶段执行、可追溯、可审查的工作流。AI Agent 会先建立物理模型，再进入框图实现或控制器整定。
以下命令已经通过 skills CLI 对公开 GitHub 仓库完成验证：命令正确发现了两个已发布 skill，并且本次检查未执行安装。
npx skills add YYch89/thermal-machinery-ai-skills --list
npx skills add YYch89/thermal-machinery-ai-skills --skill gas-turbine-ai-modeling如需安装通用热力系统 skill，将最后的 skill 名改为 thermal-machinery-dynamic-modeling。该安装器也支持其他 Agent；适用时可使用它的 --agent 参数。
手动安装仍是可靠的兜底方式：克隆仓库，并将 skills/ 下所需的一个或两个文件夹复制到所使用 Agent 的 skills 目录。每个文件夹均可独立使用，并以 SKILL.md 作为入口。
git clone https://github.com/YYch89/thermal-machinery-ai-skills.git随后在 Agent 中调用，例如：
Use the gas-turbine-ai-modeling skill to build a staged design-point-to-dynamic MATLAB/Simulink workflow. Do not jump directly to Simulink: produce state tables, loop contracts, an initial-condition registry, and validation gates.
对于支持插件加载的 Codex 环境，仓库还提供了已通过本地规范校验的 .codex-plugin/plugin.json，并指向现有的两个 skill。
- 从设计点、稳态、转子/容腔/燃烧室动态到 MATLAB-Simulink 分阶段实现燃气轮机模型。
- 审查压气机和透平特性图、初始化残差、控制权限、单位和物理约束。
- 通过系统拓扑与工质流台账规划布雷顿、朗肯、制冷、热泵及混合热力系统。
- 审查或修复已有动态 Simulink 模型，不将“能运行”误认为“已验证”。
直接要求 AI “Build me a dynamic gas-turbine Simulink model”时，模型可能会立刻进入实现阶段。本仓库要求先按如下工程顺序推进：
需求 → 拓扑 → 设计点 → 稳态闭合 → 初始化 → 动态 → 控制 → 验证
这不是提示词集合，而是分阶段工程工作流。 预期输出不仅包括代码，还包括可审查的产物、假设、守恒关系、初始条件和仍未关闭的验证门槛。
公开示例 examples/synthetic-dual-shaft-gt-dynamic 使用合成数据展示这套流程：
| 输入 | Skill 工作流 | 输出 |
|---|---|---|
| 建立双轴燃气轮机发电机组动态模型。 | 设计点状态数据 → 部件接口约定 → 额定稳态闭合 → 初始条件残差检查 → 转子与容腔动态 → 验证门槛。 | 可运行的 MATLAB/Simulink 脚本和探索级、简化模型测试。 |
在示例根目录中，可在 MATLAB 运行：
runtests('tests')
run('scripts/build_gt_simulink_model.m')
run('scripts/run_simulink_closed_loop.m')
run('scripts/build_gt_component_native_model.m')
run('scripts/run_component_native_closed_loop.m')生成的 .slx 文件不会提交到仓库。模型边界、假设和预期检查项见示例 README。
适用于燃气轮机设计点、非设计工况匹配与特性图、转子/容腔/燃烧室动态、MATLAB/Simulink 分阶段实现、初始化、控制接入，以及模型调试或修复，尤其适合多轴燃气轮机。
适用于更广泛的热力机械系统，包括热机、混合热力系统、热泵、布雷顿/朗肯/制冷系统和需要明确系统拓扑、工质流台账、模型深度与验证方式的热流体对象。
对于集成系统，先使用通用 skill 建立全系统拓扑和工质流台账，再使用燃气轮机 skill 深入燃气轮机子系统。
-
双轴燃气轮机示例仅使用合成公开数据，属于探索级、简化模型，不是厂商模型或认证发动机模型。
-
该公开示例的运行级冒烟检查曾在 MATLAB/Simulink R2023a 完成验证：
R2023_PUBLIC_GT_CORE_CHECKS_PASSED R2023_PUBLIC_GT_RUNTTESTS_PASSED R2023_PUBLIC_GT_README_SCRIPTS_COMPLETED -
skill 要求在形成工程结论前提供有来源的方程、部件数据、明确假设、残差检查和领域审查。
-
仓库不包含专有特性图、私有标定数据、未公开项目模型或安全关键系统认证材料。
紧凑的 synthetic-heat-pump-ledger 示例则展示了通用热力机械工作流在非燃气轮机场景中的拓扑、节点台账和验证边界。
如使用本项目，请引用：
Wen, J. (2026). Thermal Machinery AI Skills (v0.1.1) [Software]. Zenodo. https://doi.org/10.5281/zenodo.20666571
python scripts/validate_release.py该命令只检查仓库结构、隐私和打包安全，不代表工程模型正确性。发布与外审材料见 docs/release-checklist.md 和 docs/external-review-prompts.md。