AGENT SKILL
12-game-ability
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 44
- 参考文档commands/dashboard-flow-abort.md627 B
- 参考文档commands/dashboard-flow-auto.md681 B
- 参考文档commands/dashboard-git-branches.md254 B
- 参考文档commands/dashboard-git-init.md641 B
- 参考文档commands/dashboard-git-stash-pop.md643 B
- 参考文档commands/dashboard-list-models.md1.2 KB
- 参考文档commands/dashboard-list-models.md.AGENTS.md341 B
- 参考文档commands/dashboard-peer-list.md212 B
- 参考文档commands/dashboard-peer-scan.md278 B
- 参考文档commands/dashboard-pin-list.md149 B
- 参考文档commands/dashboard-proposal-archive.md258 B
- 参考文档commands/dashboard-proposal-attach.md548 B
- 参考文档commands/dashboard-proposal-detach.md498 B
- 参考文档commands/dashboard-server-config.md156 B
- 参考文档commands/dashboard-server-health.md200 B
- 参考文档commands/dashboard-server-tunnel-off.md557 B
- 参考文档commands/dashboard-server-tunnel-on.md549 B
- 参考文档commands/dashboard-server-tunnel-status.md213 B
- 参考文档commands/dashboard-session-abort-all.md681 B
- 参考文档commands/dashboard-session-abort.md500 B
- 参考文档commands/dashboard-session-diff.md599 B
- 参考文档commands/dashboard-session-fork.md481 B
- 参考文档commands/dashboard-session-hide.md467 B
- 参考文档commands/dashboard-session-info.md456 B
- 参考文档commands/dashboard-session-kill.md541 B
- 参考文档commands/dashboard-session-list-active.md279 B
- 参考文档commands/dashboard-session-list-here.md281 B
- 参考文档commands/dashboard-session-list.md231 B
- 参考文档commands/dashboard-session-model.md570 B
- 参考文档commands/dashboard-session-rename.md495 B
- 参考文档commands/dashboard-session-resume.md461 B
- 参考文档commands/dashboard-session-spawn.md904 B
- 参考文档commands/dashboard-session-tell.md537 B
- 参考文档commands/dashboard-session-thinking.md513 B
- 参考文档commands/dashboard-session-unhide.md465 B
- 参考文档commands/README.md1.6 KB
- 参考文档references/api-reference.agent.md7.5 KB
- 参考文档references/api-reference.md23.1 KB
- 参考文档references/recipes.md7.9 KB
- 参考文档references/slash-commands.md4.3 KB
- 脚本scripts/dashboard-api.sh4.5 KB
- 脚本scripts/dashboard-bus.ts9.4 KB
- 脚本scripts/local-proof.ts1.5 KB
- 脚本scripts/spawn-command.ts1.6 KB
03 SKILL.md 正文
12-game-ability
Status: ACTIVE AppliesTo: v10
GamePackage Ability addon.
devian/21-domain-game에서 생성된 UNIT_STAT_TYPE, ITEM_*, UNIT_* 타입 위에 얹히는 Unity 수동 C# 계층을 정의한다.
1. Scope
AbilityBase—Dictionary<UNIT_STAT_TYPE, int>기반 정규화 stat 저장소AbilityBattleBase/AbilityBattleSkill/AbilityBattleStatus/AbilityBattleProjectile—SkillTable.xlsxgenerated row wrapperAbilityAffect—SkillTable.xlsx -> AFFECTgenerated row wrapperAbilityItemBase/AbilityItemEquip/AbilityItemCard/AbilityItemMaterial/AbilityItemHero— outgame item runtime 모델AbilityUnitBase/AbilityUnitHero/AbilityUnitMonster— unit runtime 모델- Generated enum/table 정의 자체는 devian/21-domain-game가 정본이다
2. Code Location
UPM (정본)
framework-cs/upm/com.devian.foundation/Samples~/GamePackage/Runtime/Ability/
Packages (sync)
framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/GamePackage/Runtime/Ability/
Assets/Samples (import)
framework-cs/apps/UnityExample/Assets/Samples/Devian Foundation/{foundationVersion}/GamePackage/Runtime/Ability/
3. Files
| 파일 | 역할 |
|---|---|
AbilityBase.cs |
stat dictionary, indexer, AddStat, SetStat, ClearStat, Clone 공통 베이스 + aggregate property (AtkPhysical, AtkMagical, DefPhysical, DefMagical, MaxHP) |
AbilityBattleBase.cs |
battle wrapper 공통 abstract 베이스 |
AbilityBattleSkill.cs |
SKILL 참조 wrapper (SkillId, NameId, AffectList) |
AbilityBattleStatus.cs |
STATUS 참조 wrapper (StatusId, NameId, AffectList) |
AbilityBattleProjectile.cs |
PROJECTILE 참조 wrapper (ProjectileId, NameId, AffectList) |
AbilityAffect.cs |
AFFECT 참조 wrapper (AffectId, NameId) |
AbilityItemBase.cs |
item 공통 abstract 베이스 (Amount, ItemLevel, AddAmount, level stat replace helper) |
AbilityItemEquip.cs |
ITEM_EQUIP 참조 + ItemUid + owner/unit slot 상태 |
AbilityEquipSlotPolicy.cs |
EQUIP_SLOT 기반 장비-슬롯 허용/양손 규칙 helper |
AbilityItemCard.cs |
ITEM_CARD 참조 + ITEM_AMOUNT/ITEM_LEVEL 기반 상태 관리 |
AbilityItemMaterial.cs |
ITEM_MATERIAL 참조 + ITEM_AMOUNT/ITEM_LEVEL 기반 상태 관리 |
AbilityItemHero.cs |
ITEM_HERO 참조 + ITEM_AMOUNT/ITEM_LEVEL 기반 상태 관리 + outgame equip slot 소유 |
AbilityUnitBase.cs |
unit 공통 abstract 베이스 (UnitId) |
AbilityUnitHero.cs |
UNIT_HERO 초기화 + preview용 projected equip snapshot |
AbilityUnitMonster.cs |
UNIT_MONSTER 초기화 + 기본 stat 세팅 |
4. Generated Dependencies
Consumed Generated Types
Devian.Domain.Game.UNIT_STAT_TYPEDevian.Domain.Game.SKILLDevian.Domain.Game.STATUSDevian.Domain.Game.PROJECTILEDevian.Domain.Game.AFFECTDevian.Domain.Game.ITEM_EQUIPDevian.Domain.Game.ITEM_CARDDevian.Domain.Game.ITEM_MATERIALDevian.Domain.Game.ITEM_HERODevian.Domain.Game.UNIT_HERODevian.Domain.Game.UNIT_MONSTER
Assembly
Devian.Samples.GamePackage asmdef는 다음을 참조한다:
Devian.CoreDevian.Samples.CommonPackageDevian.Samples.SoundPackage
수동 addon 클래스 namespace는 Devian이고, generated 타입 namespace는 Devian.Domain.Game를 유지한다.
5. Behavioral Rules
AbilityBase는(UNIT_STAT_TYPE, int)정규화 저장소를 단일 SSOT로 사용한다.AbilityBase.AtkPhysical,AtkMagical,DefPhysical,DefMagical는(AFFECT_*_ADD + ITEM_*) * (100 + AFFECT_*_PER) / 100 + UNIT_*규칙을 따른다. 구현은 정수 결과를 유지한다.AbilityBase.MaxHP는(AFFECT_HP_ADD + ITEM_HP) * (100 + AFFECT_HP_PER) / 100 + UNIT_HP규칙을 따른다. 구현은 정수 결과를 유지한다.AbilityBattleSkill,AbilityBattleStatus,AbilityBattleProjectile,AbilityAffect는SkillTable.xlsxgenerated row를 참조하는 얇은 wrapper다. 별도 factory나 level table 규약은 두지 않는다.AbilityItemEquip은itemUid를 인스턴스 pk로 사용하고, 장착 상태는OwnerUnitId+OwnerSlotType으로 관리한다.- 장착 슬롯 enum 정본은
EQUIP_SLOT_TYPE이며NONE=0을 포함한다. AbilityItemCard.Amount,AbilityItemMaterial.Amount,AbilityItemHero.Amount는AbilityItemBase.Amount를 상속하며,UNIT_STAT_TYPE.ITEM_AMOUNT의 얇은 래퍼다.AbilityItemCard.Init(),AbilityItemHero.Init(),AbilityItemEquip.Init()는 baseITEM_*row와 대응ITEM_*_LEVELrow를 함께 받아서 초기 stat을 세팅한다.AbilityItemBase는 level row 교체용 helper를 가진다. level up 시 현재 level row stat을 제거하고 다음 level row stat을 적용한다.AbilityItemCard,AbilityItemHero,AbilityItemEquip는 internal_LevelUp()을 제공한다. 현재 row 기준으로 다음ITEM_*_LEVELrow를 찾아 runtime stat을 재적용한다.AbilityItemCard는 internalResolveLevelUpCost()로 현재ITEM_CARD_LEVEL.levelup_count를 level-up 비용으로 해석한다. 비용 정본은 현재 level row다.AbilityItemCard는 internalResolveLevelUpCurrencyCost()로 현재ITEM_CARD_LEVEL.levelup_currency+levelup_price를 level-up 재화 비용으로 해석한다. 비용 정본은 현재 level row다.AbilityItemHero는 internalResolveLevelUpCost()로 현재ITEM_HERO_LEVEL.levelup_count를 level-up 비용으로 해석한다. 비용 정본은 현재 level row다.AbilityItemHero는 internalResolveLevelUpCurrencyCost()로 현재ITEM_HERO_LEVEL.levelup_currency+levelup_price를 level-up 재화 비용으로 해석한다. 비용 정본은 현재 level row다.AbilityItemEquip는 internalResolveLevelUpMaterialCost()로 현재ITEM_EQUIP_LEVEL.levelup_material+levelup_count를 level-up 재료 비용으로 해석한다. 비용 정본은 현재 level row다.AbilityItemEquip는 internalResolveLevelUpCurrencyCost()로 현재ITEM_EQUIP_LEVEL.levelup_currency+levelup_price를 level-up 재화 비용으로 해석한다. 비용 정본은 현재 level row다.AbilityItemHero는 outgame hero 저장 모델이다. 기본 생성 레벨은1이다.Equips와 internal_SetEquip(equip, slot)/_RemoveEquip(slot)로 loadout metadata만 보유한다.AbilityItemHero/AbilityUnitHero의 장착 슬롯 key는Dictionary<EQUIP_SLOT_TYPE, AbilityItemEquip>다.- 장착 허용 규칙 정본은
ITEM_EQUIP.equip_type+EQUIP_SLOT.allowed_slots/two_handed+AbilityEquipSlotPolicy다. two_handed=true장비를HAND_MAIN에 장착하면 현재HAND_SUB장비를 자동 해제한다.HAND_MAIN에 양손 장비가 있는 상태에서HAND_SUB장착 시도는 실패한다.AbilityItemHero는ITEM_HERO.unit_id를 참조할 수 있으며, item hero와 unit hero를 명시 필드로 연결한다.AbilityUnitHero는UNIT_HERO기반 계산 모델이다. internal_Equip(equip, slot)/_Unequip(slot)에서 장착된AbilityItemEquipstat을 unit stat에 합산/제거한다.UNIT_STAT_TYPE.ITEM_LEVEL,UNIT_STAT_TYPE.ITEM_AMOUNT같은 item 메타 stat은 unit aggregate에 섞지 않는다.- preview/ingame projection의 equip 계산 규칙 정본은 15-game-ability-factory다.
AbilityUnitBase는UnitLevel,CurHP프로퍼티를 제공한다.CurHP는 stat dictionary가 아니라 runtime field(mCurHP)이며 clone 시 같이 복사된다.MaxHP는AbilityBaseaggregate property를 사용한다.AbilityUnitHero.Init()/AbilityUnitMonster.Init()는 baseUNIT_*row와 대응UNIT_*_LEVELrow를 함께 받아서UNIT_STAT_TYPE.UNIT_LEVEL,UNIT_STAT_TYPE.UNIT_HP를 초기화하고CurHP = MaxHP로 시작한다.- clone 동작은 generated table 참조는 유지하고 stat 값만 복사한다.
6. Hard Rules
- 수동 addon 코드는
Runtime/Ability/에만 둔다. Runtime/Generated/,Editor/Generated/는 빌더 관리 영역이다. 수동 수정 금지.UNIT_STAT_TYPE,ITEM_*,UNIT_*는 generated 타입이다. 수동 재정의 금지.- 정본 수정 위치는 항상
framework-cs/upm/com.devian.foundation/Samples~/GamePackage/다. - 장착/해제 규칙을 바꾸면 Inventory 계열 스킬 문서도 함께 갱신한다.
7. Related
- devian/21-domain-game/12-game-ability — Ability feature 모델/TS 관점
- devian/21-domain-game/13-game-stat-type —
UNIT_STAT_TYPE정의 - 15-game-ability-factory — ability 생성 / projection / preview 규약
- 16-equip-slot-policy — equip slot rule / two-handed policy
- devian-unity/50-mobile-package/22-inventory-system/03-ssot — Inventory 상태/Apply 규약
- devian-unity/50-mobile-package/22-inventory-system/11-inventory-storage — Ability 저장/장착 위임