openapi-workflow
Use when making changes to the OpenAPI contract. Workflow for updating spec and regenerating clients.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
메뉴
Use when making changes to the OpenAPI contract. Workflow for updating spec and regenerating clients.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
Batch, validate, and consolidate open Dependabot pull requests for memory-service. Use when asked to inspect the Dependabot queue, verify dependency PRs efficiently, reproduce dependency-update CI failures, combine compatible dependency PRs, or create a validated consolidated dependency PR.
Implement or review Memory Service backend operational logging. Use for REST or gRPC boundaries, provider errors, error wrapping, background workers and task attempts, indexers and maintenance jobs, SSE or gRPC streams, request correlation, and changes under internal/operationevent.
Prepare Memory Service changes for pull request submission. Use whenever Codex is asked to create, open, submit, publish, or ready a pull request, or to perform final PR preflight. Require `task generate` before the final PR commit so generated sources and repository-wide formatting are included.
Use when writing or debugging tests for memory-service. Covers Cucumber BDD patterns and failure reporting.
Use when you need build, test, or dev commands for memory-service across Go, Java, frontend, or Python modules.
Use when writing or editing enhancement documents in docs/enhancements/. Provides format, conventions, and numbering guidance.
SOC 직업 분류 기준
| name | openapi-workflow |
| description | Use when making changes to the OpenAPI contract. Workflow for updating spec and regenerating clients. |
Edit the spec: Agent API changes use contracts/openapi/openapi.yml; Admin API changes use contracts/openapi/openapi-admin.yml.
Regenerate Go bindings:
# Agent API + client
go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen --config=internal/generated/api/cfg.yaml contracts/openapi/openapi.yml
go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen --config=internal/generated/apiclient/cfg.yaml contracts/openapi/openapi.yml
# Admin API
go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen --config=internal/generated/admin/cfg.yaml contracts/openapi/openapi-admin.yml
Regenerate Java client:
./java/mvnw -f java/pom.xml -pl quarkus/memory-service-rest-quarkus clean compile -am
Regenerate TypeScript client:
cd frontends/chat-frontend && npm run generate
Verify:
./java/mvnw -f java/pom.xml compile
cd frontends/chat-frontend && npm run lint && npm run build