AgentSkillsCN

Add Entity Field Skill

在现有实体/模型中新增字段,并同步更新相关服务与端点

SKILL.md
--- frontmatter
description: Add a new field to an existing entity/model with related service and endpoint updates

Add Entity Field Skill

Add a new field to an existing entity/model in the NovaTune project.

Steps

  1. Identify the entity file

    • Location: src/NovaTuneApp/NovaTuneApp.ApiService/Models/
    • File naming: {EntityName}.cs
  2. Add the property to the entity class

    csharp
    public required string NewFieldName { get; set; }
    // Or for optional fields:
    public string? OptionalFieldName { get; set; }
    
  3. Update related services

    • Check src/NovaTuneApp/NovaTuneApp.ApiService/Services/ for services that use this entity
    • Update DTOs if they exist
    • Update any mapping logic
  4. Update endpoints

    • Check src/NovaTuneApp/NovaTuneApp.ApiService/Endpoints/ for affected endpoints
    • Update request/response models if needed
  5. Update RavenDB indexes if applicable

    • Location: src/NovaTuneApp/NovaTuneApp.ApiService/Infrastructure/RavenDb/
    • Add field to index if it will be queried
  6. Add tests

    • Unit tests: src/unit_tests/
    • Integration tests: src/NovaTuneApp/NovaTuneApp.Tests/

Code Style

  • Use required for mandatory fields
  • Use nullable reference types (?) for optional fields
  • PascalCase for property names
  • Add XML documentation comments for public APIs