菜单
Add a new enemy type end-to-end with config registration, behavior/weapon mapping, spawning integration, loot pool support, and gameplay balancing checks. Use when adding any new enemy key, variant tier, or boss enemy.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | add-enemy |
| description | Add a new enemy type end-to-end with config registration, behavior/weapon mapping, spawning integration, loot pool support, and gameplay balancing checks. Use when adding any new enemy key, variant tier, or boss enemy. |
Use this skill when adding a new enemy key (for example forestWraith), a tiered variant (forestWraithVeteran / forestWraithElite), or a boss enemy.
This project's enemy source of truth is:
game/config/enemyConfigs.ts for enemy config objects and EnemyType.fromConfig(...) exports.game/enemies/EnemiesRegistry.ts for registry entries and weapon/behavior mapping.game/managers/EnemyManager.ts for tier substitution maps and runtime spawn/size logic.In game/config/enemyConfigs.ts:
<enemyName>Config with baseline combat and movement fields:
maxHealth, moveSpeed, attackRange, attackDamage, detectionRangeattackCooldown, windUpTime, colorstunBuildupPerHit, knockbackResist, knockback, goldDrop, optional drop chances).lunge, projectile, heavySmash, pillarFlame, warCry, dodge, hitboxPoints.Enemy<PascalName> = EnemyType.fromConfig(<enemyName>Config).In game/enemies/EnemiesRegistry.ts:
Enemy<PascalName> from enemyConfigs.Enemies object (for example forestWraith: EnemyForestWraith).weaponAndBehavior mapping for the same key:
weaponId that exists in EnemyWeapons.resolveWeapon(...) pathbehaviorId supported by weapon attack handling (slashOnly, slashAndLeap, comboAndCharge, chargeRelease, rangedOnly, etc.).Without this step, GameConfig.enemy.types auto-population and attack handler creation will be incomplete.
If the enemy uses a new weaponId:
game/weapons/EnemyWeaponsRegistry.ts (or reuse an existing player weapon from WeaponsRegistry).resolveWeapon(...) can return a valid weapon object for that id.If using special attacks (charge-release/lunge/ranged):
Update level and tier routing so the enemy can actually appear:
game/config/GameConfig.ts: add key to level enemyTypes arrays and/or bossSpawn.game/managers/EnemyManager.ts:
TIER2_MAP / TIER3_MAP if adding veteran/elite chainIf the enemy should drop weapons:
weaponDropChance and weaponDropPoolId in enemy config.weaponDropPoolId entry to game/config/lootConfig.ts LOOT_POOLS.If the enemy should drop non-weapon resources:
whetstoneDropChance / pageDropChance in enemy config.Verify in playtest:
enemyConfigs and present in Enemies registry.weaponAndBehavior mapping exists and resolves to a valid weapon.enemyTypes or bossSpawn.weaponId that resolveWeapon cannot return.EnemyManager.Add a new stackable inventory consumable with type count shape, drag drop behavior, hover tooltip, and icon support. Use when adding items like mushroom herb potion gold page or enchantScroll.
Add an enterable room scenario inside a scene tile by reusing the Ogre's Den pattern (cave entrance obstacle, target sub-level, return flow, and optional quest hookup). Use when creating new enterable dens, caves, ruins, interiors, or boss rooms from overworld scene tiles.
Add a new status effect end-to-end with shared status state, apply/decay rules, enemy infliction hooks, player delivery paths (weapon/projectile/skill), UI feedback, and config balancing checks. Use when implementing effects similar to stun (poison, burn, slow, bleed, freeze, weaken, etc.).
Add a new weapon item end-to-end with inventory/chest movement, equip logic, rarity effects, hover tooltip, and icon support. Use when adding a new weapon key or weapon-class item.