War3Lib/Xlimon 物编 Skill

按需读取：

• references/workflow.md
• references/xlimon-workflow.md
• references/snippets.md
• references/templates-unit.md
• references/templates-unit-xlimon.md
• references/templates-ability.md
• references/templates-passive.md
• references/templates-spellbook.md
• scripts/check_obj_ids.py
• scripts/check_xlimon_obj_ids.py

仓库分流（先判断再执行）

• 在 War3Lib 中：使用 references/workflow.md、references/templates-unit.md 与 scripts/check_obj_ids.py；落点为 UnitTestMap/table、Jass/**/*.w3* 或 db。
• 在 Xlimon 中：使用 references/xlimon-workflow.md、references/templates-unit-xlimon.md 与 scripts/check_xlimon_obj_ids.py；日常改动只落到 OriginMap/table，除非用户明确要求修改或诊断 UnitTestMap/table。
• 其余模板和 snippets 两边共用。不要用一边的默认路径或 Order 清单覆盖另一边。

执行流程

1. 先确认当前仓库，再从对应模板选择最接近的类型并定位目标对象文件。
2. 先分配 ID，再基于模板最小改动。新增前必须执行：
   • War3Lib：python3 .codex/skills/xlimon-objeditor-map/scripts/check_obj_ids.py --id <ID>
   • Xlimon：python3 .codex/skills/xlimon-objeditor-map/scripts/check_xlimon_obj_ids.py --id <ID>
3. 若是主动技能，优先使用“通魔”模板（通常 _parent = "ANcl"），并确保 Order / DataF 不与既有技能冲突。
4. War3Lib 从 db/list/List_Order.ini、Xlimon 从 Other/List_Order.ini 查可用命令字；把已使用项按现有习惯标记 //。
5. 需要隐藏图标时，允许使用按钮位点 bug（见 snippets）。
6. 生成时优先写紧凑格式：值后追加行尾注释 -- 注释，便于查阅。
7. 输出前再次运行检查脚本，确认无冲突后再提交修改。

路径约定

• 单测地图物编：UnitTestMap/table/
• 库内对象文件：Jass/**/*.w3a、Jass/**/*.w3u、Jass/**/*.w3i（以及同类 .w3*）
• 常用命令字清单：db/list/List_Order.ini
• 原生数据库参照：db/（项目内相对路径）
• Xlimon 主地图物编：D:/War3/Maps/Xlimon/OriginMap/table/
• Xlimon 单测地图物编：D:/War3/Maps/Xlimon/UnitTestMap/table/（默认只读，不随日常物编改动同步写入）
• Xlimon 命令字清单：D:/War3/Maps/Xlimon/Other/List_Order.ini

强约束

• 把 4 位对象 ID 视为大小写不敏感唯一键：[A01a] 与 [A01A] 视为冲突。
• 典型坑：[AFBK] 与原生技能 [Afbk] 大小写不敏感冲突；新增或重命名任何 4 位 ID 前必须运行对应仓库的检查脚本。
• 同时检查两类冲突：
  • 项目对象文件冲突（UnitTestMap/table + Jass/**/*.w3*）
  • 与项目 db 冲突（对应 ini 文件）
• 主动技能避免重复 Order，否则可能出现按键/命令冲突。
• 修改 db/list/List_Order.ini 时保留现有格式，不改动无关条目。
• Xlimon 对象的 _parent 必须能从原生模板链解析，禁止把项目自定义对象作为父对象；若出现 w3x2lni ... frontend_merge.lua:155: assertion failed!，优先检查最近新增对象的 _parent。

生成行为

• 默认先做“最小变更”：只新增/修改必要段落。
• 保持原有字段顺序与风格，不擅自大规模重排。
• 若检测环境缺少某路径，显式说明并继续处理可落地部分。