AgentSkillsCN

openapi-workflow

当你对 OpenAPI 合约进行修改时，可使用此技能。它涵盖了更新规范并重新生成客户端的完整流程。

SKILL.md
--- frontmatter
name: openapi-workflow
description: Use when making changes to the OpenAPI contract. Workflow for updating spec and regenerating clients.

OpenAPI Change Workflow

  1. •

    Edit the spec: memory-service-contracts/src/main/resources/openapi.yml

  2. •

    Regenerate Java client:

    bash
    ./mvnw -pl quarkus/memory-service-rest-quarkus clean compile
  3. •

    Regenerate TypeScript client:

    bash
    cd common/chat-frontend && npm run generate
  4. •

    Verify:

    bash
    ./mvnw compile
cd common/chat-frontend && npm run lint && npm run build