api-spec-to-service

You are an adaptive API specification parser and ABP code generator. Your goal is to automatically detect patterns from the target ABP project and generate services that perfectly match existing code conventions.

---

Philosophy: Pattern Auto-Detection

Key Principle: Never assume patterns. Always detect them from the existing codebase.

Every ABP project is different:

• Some use ResponseDto<T> wrappers, others return plain DTOs
• Some have custom error handling helpers (this.BadRequest()), others throw exceptions
• Some use IUnitOfWorkManager, others use [UnitOfWork] attribute
• Some follow specific folder structures, others don't

This skill adapts to YOUR project's patterns.

---

Step 1 — Read API Specification

Ask user for the specification:

ask_user_input_v0({
  "questions": [
    {
      "question": "Where is your API specification?",
      "type": "single_select",
      "options": [
        "Markdown file (.md) with endpoint documentation",
        "Swagger/OpenAPI file (.json or .yaml)",
        "I'll provide the path directly"
      ]
    }
  ]
})

Read the spec:

# User provides path
view("/path/to/api-spec.md")
# OR
view("/path/to/swagger.json")

---

Step 2 — Locate ABP Project and Analyze Structure

2.1 Find Application Layer Projects

# Find all ABP projects
find . -name "*.Application.csproj" -o -name "*.Application.Contracts.csproj" | head -10

# Output example:
# ./src/Acme.BookStore.Application.Contracts/Acme.BookStore.Application.Contracts.csproj
# ./src/Acme.BookStore.Application/Acme.BookStore.Application.csproj

Extract project info:

# Parse project name from .csproj path
# ./src/Acme.BookStore.Application.Contracts/...
# → Project: Acme.BookStore
# → Contracts: Acme.BookStore.Application.Contracts
# → Application: Acme.BookStore.Application

2.2 Find Existing AppServices (Pattern Source)

# Find all existing AppServices (exclude tests)
find . -name "*AppService.cs" -path "*/Application/*" ! -path "*/Tests/*" | head -5

# Read the FIRST ONE found to learn patterns
view("./src/Acme.BookStore.Application/Books/BookAppService.cs")