# Afsim Skill

> AFSIM 场景代码生成、报错调试、文档解析。触发词：/afsim /afsim-auto /afsim-learn /afsim-debug。当前版本：v1.0.2。当用户提到 AFSIM、Warlock、platform_type、sensor、weapon、mover、route、AFSIM 场景/兵棋推演时使用本 Skill。

- Skill: `qingzhoupro/afsim-skill` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add qingzhoupro/afsim-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qingzhoupro/afsim-skill/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: qingzhoupro (https://skillmd.com/u/qingzhoupro)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qingzhoupro/afsim-skill

---


# 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 命中特定条目时触发：

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

### 联动流程

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

## 代码生成原则

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

## 成果管理闭环

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

### 目录结构

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

### 生命周期

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

### 归档触发

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

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

### 归档操作

```text
# 用户认可后，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 | 双基地雷达 |