test/agent-skills/README.md

Agent Skills for Perfect World Unity C++ to C# Conversion

This folder contains comprehensive skills and guidelines for AI agents working on the Perfect World Unity C++ to C# conversion project.

Skills Index

Core Conversion Skills

1. Naming Conventions - Maintain C++ naming exactly (CGfxMoveBase, m_bOneOfCluser, etc.)
2. Type Mappings - C++ to C# type conversions (DWORD→uint, A3DVECTOR3→Vector3, etc.)
3. Code Patterns - Common C++ patterns and their C# equivalents

Architecture & Understanding

4. Architecture Understanding - System structure, flow, and relationships
5. Skill GFX System Deep Dive - Detailed GFX system architecture

Quality & Validation

6. Testing & Validation - How to verify conversions are correct
7. Common Pitfalls - Mistakes to avoid during conversion
8. Best Practices - Recommended approaches and patterns

Reference

9. C++ Source Reference - Key C++ files and their locations
10. Unity C# Reference - Key Unity C# files and their locations
11. GFX to Particle System - GFX→ParticleSystem conversion, why scale is not needed
12. Prefer UniTask Over Task - Use UniTask for all Unity async operations

Quick Start

When starting a conversion task:

1. Read Naming Conventions - CRITICAL - Never change C++ names unnecessarily
2. Check Type Mappings for type conversions
3. Review Common Pitfalls before coding
4. Use Testing & Validation to verify your work
5. For async code: Use UniTask Over Task - Prefer UniTask for Unity async operations

Priority Rules

1. Preserve C++ naming - If C++ has CGfxMoveBase, use CGfxMoveBase (not IGfxMovement)
2. Match C++ behavior exactly - Don't "improve" logic unless explicitly requested
3. Maintain field names - Even typos like m_bOneOfCluser must be preserved
4. Verify against C++ source - Always check the actual C++ implementation

Project Context

• Source: perfect-world-source/ - Original C++ codebase
• Target: perfect-world-unity/Assets/ - Unity C# project
• Main Plan: SKILL_GFX_CONVERSION_PLAN.md - Overall conversion strategy
• Quick Guide: SKILL_GFX_QUICK_START.md - Fast implementation guide