afsim-skill

name afsim-skill description AFSIM 场景代码生成、报错调试、文档解析。触发词：/afsim /afsim-auto /afsim-learn /afsim-debug。当前版本：v1.0.2。当用户提到 AFSIM、Warlock、platform_type、sensor、weapon、mover、route、AFSIM 场景/兵棋推演时使用本 Skill。 disable-model-invocation true version v1.0.2 version_date 2026-05-26T00:00:00.000Z AFSIM Skill — 核心入口 | v1.0.2 精简入口，详细工作流见 .cursor/commands/ 下的各子命令文件。 黄金法则 不要凭空自造 AFSIM 语法，要基于验证过的模板和官方 Demo 输出！ AI 可基于模板修正/组合输出，但新手不建议自造。报错 → errors-ref 匹配 → 教训激活 → 积累。 渐进披露 本 Skill 采用渐进披露策略节省上下文： 层级 文件 何时加载 0（始终） 本文件 默认 1（按需） refs/errors-ref.md 报错时快速匹配 2（命中后） memory/cold/lesson-index.md errors-ref 命中特定条目时 3（匹配后） memory/cold/lesson-root-causes.md lesson-index 匹配到教训 ID 时 4（查询时） refs/quick-ref.md 需要模板时 5（查询时） refs/demos-index.md 需要 Demo 时 6（查询时） refs/complete-ref.md 需要完整语法参考时 教训体系：索引 + 激活联动 Layer 1: errors-ref.md（快速索引，条件反射） 报错时 第一反应 去 refs/errors-ref.md 快速匹配。 格式： ## [E001] 报错关键字 → 根因 → 修正方案 → Demo路径 Layer 2: memory/cold/（深度教训，应激激活） 不主动加载 ，仅当 errors-ref 命中特定条目时触发： errors-ref 命中 [Exxx] → 查 memory/cold/lesson-index.md 找相关教训 ID 加载 memory/cold/lesson-root-causes.md 中对应教训段落 输出修正方案 + 教训提醒 联动流程 用户报错 → refs/errors-ref.md 匹配 → 命中 [Exxx] ↓ lesson-index.md 查教训 ID ↓ lesson-root-causes.md 加载教训段落 ↓ 输出修正方案 + 教训提醒 代码生成原则 基于模板输出 ：不凭空自造，优先在 refs/quick-ref.md / templates/ 找模板 不明确则交互 ：需求模糊时询问关键参数（平台类型、武器、传感器、仿真时长等） 自检后输出 ：检查块结构、基类型、参数格式、单位 成果存入 output 目录 ：不得直接输出，告知用户保存路径（见下方成果管理闭环） 成果管理闭环 所有生成的代码通过 临时 → 验证 → 成熟 三阶段闭环管理： 目录结构 output/ ├── staging/ # 临时成果区（初始输出位置） │ └── [生成的 .txt / .md 文件] └── verified/ # 成熟成果区（用户认可后归档） ├── scenario/ # 完整场景（可运行的 .txt 场景文件） ├── component/ # 组件模块（platform_type、processor 等可复用块） └── template/ # 模板片段（可直接复制到新场景的参数组合） 生命周期 生成代码 → 存入 output/staging/ → Warlock 验证 ↓ [用户认可] → 从 staging 移动到 verified/ 对应子目录 ↓ [后续生成] → 从 verified/ 中选取成熟案例作为参考 归档触发 以下任一条件满足时，将 output/staging/ 中的文件移动到 output/verified/ 对应子目录： 用户明确认可 ："确认"、"很好"、"这个可以" 通过 Warlock/Wizard 验证 ： Warlock successfully loaded 无报错 仿真运行成功 ：end_time 内正常终止，无崩溃 归档操作 # 用户认可后，AI 执行归档 mv output/staging/xxx.txt output/verified/scenario/ # 同时在 verified/scenario/README.md 记录元信息 参考成熟成果 生成新代码时，优先从 output/verified/ 中找同类案例作为参考（仅次于 templates/ 和官方 Demo）。 命令入口 命令 功能 /afsim 显示命令列表和快速参考 /afsim-auto 全自动代码生成 /afsim-auto step 半自动，逐模块确认 /afsim-learn 解析 MD/PDF 文档，融入 skill /afsim-debug 报错处理，联动教训体系 参考 快速参考： refs/quick-ref.md Demo 速查： refs/demos-index.md 报错索引： refs/errors-ref.md 完整语法： refs/complete-ref.md 教训索引： memory/cold/lesson-index.md 教训本体： memory/cold/lesson-root-causes.md 模板目录： templates/ 成果目录： output/staging/ （临时）/ output/verified/ （成熟） 已验证语法白名单 以下语法已通过官方 Demo 交叉验证，生成代码时应优先使用。⚠️ 标记的参数需进一步确认。 sensor 高级参数 块类型 参数 验证来源 备注 sensor receive_only sensor_demos.md ~42 纯接收模式 sensor transmit_only sensor_demos.md ~68 纯发射模式 sensor maximum_range sensor_demos.md ~3085 快速剔除范围 sensor minimum_range sensor_demos.md ~2083 最小探测距离 sensor frame_time engage.md ~54 刷新频率 sensor scan_mode sensor_demos.md ~1387 azimuth / azimuth_and_elevation sensor azimuth_scan_limits sensor_demos.md ~1388 方位扫描范围 sensor antenna_height sensor_demos.md ~1384 用于地形遮蔽 sensor antenna_tilt sensor_demos.md ~1385 波束下倾角 sensor location engage.md ~2912 NED 坐标系位置 sensor internal_link engage.md ~58 连接处理器 sensor integration_gain sensor_demos.md ~57 信号处理增益 sensor probability_of_false_alarm sensor_demos.md ~1840 虚警概率 sensor required_pd sensor_demos.md ~1841 所需发现概率 sensor one_m2_detect_range sensor_demos.md ~2086 1m² RCS 的探测距离 sensor hits_to_establish_track sensor_demos.md ~2658 建立航迹所需命中数 sensor reports_range sensor_demos.md ~62 报告距离 sensor reports_bearing sensor_demos.md ~63 报告方位 sensor reports_location engage.md ~55 报告位置 sensor ignore_same_side engage.md ~53 忽略同阵营 antenna_pattern 方向图类型 || 类型关键词 | 验证来源 | 备注 | |-----------|---------|------| | constant | sensor_demos.md ~31 | 常数增益 | | circular_pattern | sensor_demos.md ~1371 | 圆锥波束 | | rectangular_pattern | sensor_demos.md ~1495 | 矩形波束 | | constant_pattern | sensor_demos.md ~342 | 恒定方向图 | | sine_pattern | sensor_demos.md ~3067 | 正弦方向图 | | uniform_pattern | sensor_demos.md ~2617 | 均匀全向 | processor 状态机 参数 验证来源 备注 show_state_transitions engage.md ~71 调试输出 evaluation_interval engage.md ~73 多状态独立配置 next_state engage.md ~75 状态转换目标 comm 通信 || 参数 | 验证来源 | 备注 | |------|---------|------| | internal_link | engage.md ~27 | 内部链路 | | frequency | sensor_demos.md ~49 | 工作频率 | | maximum_range | comm.md ~110 | 通信距离 | | power | sensor_demos.md ~75 | 发射功率 | space_mover 轨道 || 参数 | 验证来源 | 备注 | |------|---------|------| | semi_major_axis | satellite_demos.md ~834 | 半长轴 km | | eccentricity | satellite_demos.md ~832 | 离心率 | | inclination | satellite_demos.md ~833 | 轨道倾角 | | raan | satellite_demos.md ~216 | 升交点赤经 | | anomaly | satellite_demos.md ~217 | 近地点幅角 | | revs_per_day | satellite_demos.md ~5611 | 每日转数 | 全局配置 || 参数 | 验证来源 | 备注 | |------|---------|------| | start_date | satellite_demos.md ~1042 | 仿真开始日期 | | start_time | satellite_demos.md ~1043 | 仿真开始时间 | | end_time | engage.md ~59 | 结束时间 | | random_seed | quick-ref.md | 随机种子 | | thread_count | engage.md ~13 | 并行线程数 | | realtime | script_demos.md ~61 | 实时仿真 | | event_output | script_demos.md ~327 | 事件输出 | | event_pipe | script_demos.md ~121 | 事件管道 | | dis_interface | script_demos.md ~62 | DIS 接口 | | include | engage.md ~15 | 包含外部文件 | | include_once | base_types.md ~315 | 仅包含一次 | | define_path_variable | satellite_demos.md ~184 | 路径变量 | | file_path | satellite_demos.md ~187 | 文件搜索路径 | 签名定义 类型 有无基类型 验证来源 备注 radar_signature 有（WSF_RADAR_SIGNATURE） engage.md ~18 常用 optical_signature 两种皆可 base_types.md ~17 Demo 中多无基类型 constant - base_types.md ~18 固定值 plt_file - base_types.md ~46978 频率依赖 RCS bistatic_signature - base_types.md ~47069 双基地雷达