fixed-wing-shape-detail-runbook - SKILL.md Agent Skill

name: "fixed_wing_shape_detail_runbook" description: "生成固定翼外形资产（翼型/机身剖面/网格预览/OpenVSP脚本）并支持外形候选搜索。当用户要产出可视化资产或做外形候选对比时调用。" stage: "class3_detailed" code_module: "aircraft_design/class3_detailed/geometry_detailed.py, aircraft_design/class3_detailed/geometry_modeling.py" dependencies: - "fixed_wing_shape_detail_spec"

固定翼外形详细设计（Runbook）

角色定位（统一入口）

“总体闭环计算与落盘”入口固定为 fixed_wing_overall_sizing_runbook（输出到 output/）。
本 Runbook 负责两类事情：
- 让总体入口在收敛后输出可复用外形资产（OpenVSP/OBJ/图表）
- 通过 scripts/shape_search.py 生成候选外形集合用于对比筛选（输出到 out/）

目标

从单一输入 JSON 出发，生成可复用外形资产与可视化
支持创成式外形搜索（候选集 + 每个候选的三视图预览）
支持 OpenVSP 脚本导出（若 OpenVSP/VSPAERO 可用则可进一步分析）

一键运行

1) 用总体入口生成外形资产（推荐）

python -m aircraft_design.run_sizing ./sizing_input.json --project-name "ShapeAssets"

产物（output/ShapeAssets_*/，收敛后才会进入扩展阶段输出资产）：

design_report_v2.md：总体报告（Class I）
design_data.json：输入快照与输出汇总
geometry_3d.html：三视图预览（离线可打开）
geometry_mesh.json：网格 JSON
geometry.obj：OBJ 资产（网格导出）
model.vspscript：OpenVSP 脚本
model.obj：OBJ 导出目标（脚本包含导出指令）
interactive_charts.html：交互图表
technical_roadmap_report.md：扩展阶段技术报告（含图表引用）

2) 创成式外形搜索（候选集）

python ./scripts/shape_search.py ./examples/fixed_wing_ga_single.json --n 32 --seed 1

产物（out/）：

shape_search_report.md：Top 候选表格（含 3D 链接）
shape_search_results.json：全部候选与可行集
shapes/shape_*.html：每个候选的三视图预览

GUI 关系说明

总体入口可选开启 GUI 做实时可视化；离线候选搜索不会推送到 GUI。
若希望 GUI 稳定显示 3D，请确保输入包含 geometry_shape（或提供 mesh 顶点/面片数据）。

输入片段示例（用于 GUI 兼容）

{
  "geometry_shape": {
    "fuselage": {
      "axis": {"length_m": 10.0},
      "profile": {"mode": "parametric", "max_radius_m": 1.2}
    },
    "wing": {
      "planform": {
        "s_ref_m2": 24.0,
        "aspect_ratio": 6.0,
        "taper_ratio": 0.5,
        "sweep_quarter_chord_deg": 15.0
      }
    }
  }
}

验证

python -m unittest discover -s tests