TheDeclineOfWarriors/docs/tasks/items/TASK-0010.md

id, title, summary, priority, area, owner, created, updated, execution_time, depends_on, canonical_docs, related_files

id	title	summary	priority	area	owner	created	updated	execution_time	depends_on	canonical_docs	related_files
TASK-0010	Реализовать абстрактную систему скиллов и книг для оружия	Построить общую модель скиллов и книг, которые вставляются в оружие и добавляют или модифицируют активные способности.	Highest	abilities	unassigned	2026-03-30	2026-03-30	1d	TASK-0008 TASK-0009	docs/tasks/Index.md	Assets/Features/VoxelWorld/Scenes/VoxelWorldTestScene.unity

TASK-0010 - Реализовать абстрактную систему скиллов и книг для оружия

Status

Статус задачи ведется в docs/tasks/Index.md и является каноническим там.

Допустимые значения статуса:

• BackLog
• ToDo
• InProgress
• Review
• Done

Why

Пользователь хочет абстрактные скиллы, которые вставляются в оружие через книги. Это ключевая ось билдов и расширяемости класса/оружия.

Expected Outcome

Есть единая skill system с runtime execution contract, socket/book model и правилами подключения скилла к оружию и его активации в бою.

Current Context

Боевой core, inventory и weapon abstraction должны существовать раньше. Эта задача создает общий слой до конкретных классовых MVP-умений.

Source Of Truth

• docs/tasks/items/TASK-0008.md
• docs/tasks/items/TASK-0009.md
• runtime skill/book implementation

Read First

• docs/tasks/items/TASK-0008.md
• docs/tasks/items/TASK-0009.md

Scope In

• skill contract и lifecycle выполнения
• skill book как item и источник встраиваемой способности
• weapon sockets / attach rules
• сетевое выполнение и базовые cooldown/resource hooks

Scope Out

• широкий набор контента навыков
• визуальные эффекты и polish для каждого умения

Constraints

• скилл должен быть reusable как для игрока, так и для врага
• книга не должна обходить server validation при установке в оружие

If You Find Drift

• если навыки игрока и врага начнут жить в разных несовместимых системах, это drift

Suggested Approach

1. Выделить общий runtime contract навыка.
2. Связать skill books с item/inventory и weapon sockets.
3. Подготовить базу для классовых MVP-умений и enemy reuse.

Acceptance Criteria

• книгу можно хранить как item и вставлять в подходящее оружие
• оружие получает активную способность через книгу по единым правилам
• одна и та же skill system пригодна для врагов и игроков

Verification

• ручная проверка установки книги в оружие и активации способности
• вычитка контрактов player/enemy reuse

Risks / Open Questions

• нужно определить, есть ли в MVP ограничения по типам оружия для конкретных книг

Human Decisions Needed

• none currently

Decision Log

• 2026-03-30 - книги навыков зафиксированы как часть item/equipment flow, а не как отдельный menu-only unlock.

Handoff Notes

Конкретные классовые MVP-навыки должны реализовываться поверх этой системы, без обходных исключений.