메뉴
MapTool地图工具规则，包含城市邻接查询、前线判断、距离计算等规范。Invoke when working with city adjacency, frontline detection, distance calculation, or map-related logic.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | maptool |
| description | MapTool地图工具规则，包含城市邻接查询、前线判断、距离计算等规范。Invoke when working with city adjacency, frontline detection, distance calculation, or map-related logic. |
MapTool 是 SystemTool/ 下的静态工具类，统一管理所有基于 WorldConfig.WorldNearIds 的城市邻接查询逻辑。
禁止在业务代码中直接访问 WorldConfig.WorldNearIds 进行邻接判断，必须使用 MapTool 提供的方法。
| 方法 | 返回值 | 说明 |
|---|---|---|
GetAdjacentCityIds(int cityId) | List<int> | 获取某城市的所有相邻城市ID（纯配置查询，无势力参数） |
GetAdjacentFriendlyCityIds(int cityId, int forceId) | List<int> | 获取某城市相邻的同势力城市 |
GetAdjacentEnemyCityIdsForCity(int cityId, int forceId) | List<int> | 获取某城市相邻的敌对势力城市（针对单个城市） |
GetAdjacentEnemyCityIds(int forceId) | List<int> | 获取某势力所有城市的相邻敌方城市并集（HashSet 去重） |
GetOwnCityIds(int forceId) | List<int> | 获取某势力所有己方城市ID |
IsAdjacentCity(int cityId1, int cityId2) | bool | 判断两个城市是否相邻 |
IsFrontlineCity(int cityId) | bool | 判断某城市是否为前线城市（存在邻接敌方城市） |
GetFrontlineCityIds(int forceId) | List<int> | 获取某势力所有前线城市ID |
GetRearCityIds(int forceId) | List<int> | 获取某势力所有后方城市ID（非前线） |
GetRandomAdjacentCityId(int cityId) | int | 随机获取一个相邻城市ID（无邻接时返回 0） |
CalculateCityDistance(int cityId1, int cityId2) | int | 计算两城市间距离 |
GetAdjacentEnemyCityIdsForCity 带 ForCity 后缀 = 针对特定城市+势力的查询GetAdjacentEnemyCityIds 无 ForCity 后缀 = 势力级别的全局查询（遍历所有己方城市，HashSet 去重）GetAdjacentCityIds 无势力参数 = 纯配置查询，直接返回 WorldConfig.WorldNearIdsIsFrontlineCity 内部调用 GetAdjacentEnemyCityIdsForCity，判断结果 Count > 0GetFrontlineCityIds / GetRearCityIds 内部调用 IsFrontlineCityGetOwnCityIds 委托给 GameManager.Instance.GetCitiesByForce(forceId)CalculateCityDistance 委托给 SysFormula.City.CalculateDistance(cfg1.X, cfg1.Y, cfg2.X, cfg2.Y)，使用 WorldConfig 中的 X/Y 坐标GetRandomAdjacentCityId 使用 SysRandom.Range，符合战略层随机数规范GetRandomAdjacentCityId 无邻接城市时返回 0（0 不是合法 cityId，调用方需注意）new List<int>()）或 falseIsFrontlineCity 的判定标准：只要存在一个非同势力的邻接城市就算前线。即 GetAdjacentEnemyCityIdsForCity(cityId, city.forceId).Count > 0。
所有邻接关系来自 WorldConfig.WorldNearIds（配置层数组），是地图拓扑的静态配置，非运行时动态计算。
MapTool，禁止直接访问 WorldConfig.GetConfig(cityId).WorldNearIdsMapTool.IsFrontlineCity / MapTool.GetFrontlineCityIds / MapTool.GetRearCityIdsMapTool.CalculateCityDistance，SaveCityData.CalculateDistanceTo 内部已委托给它WorldConfig.WorldNearIds 进行城市邻接判断，必须使用 MapTool 的方法AI策略系统规则，包含分层决策架构、HeroDispatcher、StrategicDecider等组件规范。Invoke when working on AI logic, hero dispatching, strategic decisions, or AI-related code.
战斗系统规则，包含Tick驱动架构、ChessAction队列、IRecoverable接口、BattleRandom规范。Invoke when working on combat system, ChessAction, Buff, Skill, or battle-related code.
代码地图，包含项目目录结构、文件用途说明、关键类位置索引。Invoke when navigating the codebase, locating files, or understanding project structure.
存档序列化规则，包含JsonUtility序列化规范、数据类目录规范、存档系统架构。Invoke when working on save data, serialization, SaveData classes, or data persistence.