Afsim Skill

AFSIM Skill — 核心入口 | v1.0.2

精简入口，详细工作流见 .cursor/commands/ 下的各子命令文件。

黄金法则

不要凭空自造 AFSIM 语法，要基于验证过的模板和官方 Demo 输出！

AI 可基于模板修正/组合输出，但新手不建议自造。报错 → errors-ref 匹配 → 教训激活 → 积累。

渐进披露

本 Skill 采用渐进披露策略节省上下文：

教训体系：索引 + 激活联动

Layer 1: errors-ref.md（快速索引，条件反射）

报错时第一反应去 refs/errors-ref.md 快速匹配。 格式：## [E001] 报错关键字 → 根因 → 修正方案 → Demo路径

Layer 2: memory/cold/（深度教训，应激激活）

不主动加载，仅当 errors-ref 命中特定条目时触发：

1. errors-ref 命中 [Exxx] → 查 memory/cold/lesson-index.md 找相关教训 ID
2. 加载 memory/cold/lesson-root-causes.md 中对应教训段落
3. 输出修正方案 + 教训提醒

联动流程

Copy code
用户报错 → refs/errors-ref.md 匹配 → 命中 [Exxx]
                                          ↓
                              lesson-index.md 查教训 ID
                                          ↓
                              lesson-root-causes.md 加载教训段落
                                          ↓
                              输出修正方案 + 教训提醒

代码生成原则

1. 基于模板输出：不凭空自造，优先在 refs/quick-ref.md / templates/ 找模板
2. 不明确则交互：需求模糊时询问关键参数（平台类型、武器、传感器、仿真时长等）
3. 自检后输出：检查块结构、基类型、参数格式、单位
4. 成果存入 output 目录：不得直接输出，告知用户保存路径（见下方成果管理闭环）

成果管理闭环

所有生成的代码通过 临时 → 验证 → 成熟 三阶段闭环管理：

目录结构

Copy code
output/
├── staging/           # 临时成果区（初始输出位置）
│   └── [生成的 .txt / .md 文件]
└── verified/         # 成熟成果区（用户认可后归档）
    ├── scenario/     # 完整场景（可运行的 .txt 场景文件）
    ├── component/   # 组件模块（platform_type、processor 等可复用块）
    └── template/    # 模板片段（可直接复制到新场景的参数组合）

生命周期

Copy code
生成代码 → 存入 output/staging/ → Warlock 验证
    ↓
[用户认可] → 从 staging 移动到 verified/ 对应子目录
    ↓
[后续生成] → 从 verified/ 中选取成熟案例作为参考

归档触发

以下任一条件满足时，将 output/staging/ 中的文件移动到 output/verified/ 对应子目录：

1. 用户明确认可："确认"、"很好"、"这个可以"
2. 通过 Warlock/Wizard 验证：Warlock successfully loaded 无报错
3. 仿真运行成功：end_time 内正常终止，无崩溃

归档操作

textCopy code
# 用户认可后，AI 执行归档
mv output/staging/xxx.txt output/verified/scenario/

# 同时在 verified/scenario/README.md 记录元信息

参考成熟成果

生成新代码时，优先从 output/verified/ 中找同类案例作为参考（仅次于 templates/ 和官方 Demo）。

命令入口

参考

• 快速参考：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 高级参数

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 状态机

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 | 文件搜索路径 |

签名定义