feat: Adds AI skills to migrate from RunUO (#2366)
## Summary Adds comprehensive RunUO → ModernUO migration documentation and Claude AI skills to help shard owners and script authors convert RunUO 2.7 code to ModernUO. - **10 migration skills** (`dev-docs/claude-skills/migrate-from-runuo/`) — system-by-system conversion guides (foundation, serialization, timers, gumps, packets, property lists, commands/events, persistence, items/mobiles, systems/engines) - **12 reference docs** (`dev-docs/runuo-migration-docs/`) — deep-reference with before/after examples, API mapping tables, edge cases, and gotchas - **Updated existing skills** — `modernuo-timers`, `modernuo-serialization`, and `modernuo-threading` now document that `Serialize()` runs on background threads and timers are not thread-safe - **Updated `CLAUDE.md`** — added migration skill lookup table ### Key migration patterns covered - Manual `Serialize()`/`Deserialize()` → source-generated `[SerializableField]` - `Packet` class hierarchy → static `SpanWriter`/`SpanReader` methods - `Timer` subclasses → `TimerExecutionToken` fire-and-forget - `Gump` → `StaticGump<T>`/`DynamicGump` with builders - `EventSink.WorldSave` → `GenericPersistence` - `ObjectPropertyList` → `IPropertyList` with string hole rules - Universal changes: naming (`m_` → `_`), `[Constructable]` → `[Constructible]`, logging, spatial queries
This commit is contained in:
parent
31b22d4773
commit
4f9bc1d9f6
26 changed files with 4216 additions and 7 deletions
15
CLAUDE.md
15
CLAUDE.md
|
|
@ -43,6 +43,8 @@ Apply these when writing or reviewing `.cs` files under `Projects/`.
|
|||
| Configuration system | `dev-docs/configuration.md` |
|
||||
| Networking & packets | `dev-docs/networking-packets.md` |
|
||||
| Region system | `dev-docs/regions.md` |
|
||||
| RunUO migration (overview) | `dev-docs/runuo-migration-docs/00-overview.md` |
|
||||
| RunUO migration (all docs) | `dev-docs/runuo-migration-docs/` |
|
||||
|
||||
## Claude Skills (Opt-In)
|
||||
|
||||
|
|
@ -71,7 +73,20 @@ Then copy only the relevant skill files based on the task:
|
|||
| Era-conditional code | `modernuo-era-expansion` |
|
||||
| Code review / audit | `modernuo-code-audit` |
|
||||
| Any `.cs` file edit | `modernuo-code-audit` (always offer for code changes) |
|
||||
| **RunUO Migration** | |
|
||||
| Migrate any RunUO script | `migrate-from-runuo/migrate-foundation` (always), plus system-specific skills below |
|
||||
| Migrate Item/Mobile/Creature | `migrate-from-runuo/migrate-foundation`, `migrate-from-runuo/migrate-serialization`, `migrate-from-runuo/migrate-items-mobiles` |
|
||||
| Migrate serialization | `migrate-from-runuo/migrate-serialization` |
|
||||
| Migrate timers | `migrate-from-runuo/migrate-timers` |
|
||||
| Migrate gumps | `migrate-from-runuo/migrate-gumps` |
|
||||
| Migrate packets | `migrate-from-runuo/migrate-packets` |
|
||||
| Migrate property lists | `migrate-from-runuo/migrate-property-lists` |
|
||||
| Migrate events/commands | `migrate-from-runuo/migrate-commands-events` |
|
||||
| Migrate persistence (WorldSave) | `migrate-from-runuo/migrate-persistence` |
|
||||
| Migrate multi-file system | `migrate-from-runuo/migrate-systems` |
|
||||
|
||||
To enable a skill: `cp dev-docs/claude-skills/<name>.md .claude/skills/`
|
||||
|
||||
Migration skills reference the deep docs in `dev-docs/runuo-migration-docs/` and point to existing ModernUO skills for best practices.
|
||||
|
||||
The `modernuo-code-audit` skill auto-triggers on `.cs` file edits and flags convention violations (warnings only, asks before fixing).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue