generate-sdk

星标9

分支2

更新时间2026年5月27日 06:51

Regenerate the frontend TypeScript API client from the OpenAPI spec using openapi-ts. Verifies API server is running, runs the code generator against openapi-ts.config.ts, and lints the output into sdk/client/. Use when user says 'regenerate SDK', 'update API client', 'sync frontend types', 'generate TypeScript client', 'API changed, update frontend', or 'openapi-ts'. Do NOT use for scaffolding frontend pages or composables (use scaffold-frontend-page, scaffold-composable), backend API endpoint creation (use scaffold-api-endpoint), or manual SDK file edits (sdk/client/ is fully generated).

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

bbvch-ai

bbvch-ai/aihub-core

打开 GitHub 仓库查看创作者相关仓库

下载

Frontend API SDK Generation

Regenerate the TypeScript API client from the live OpenAPI specification.

Step 1: Verify API Server Is Running

curl -s -o /dev/null -w "%{http_code}" http://localhost:8000/api/v1/active/docs

200: Proceed to Step 2
Any other code or connection refused: Stop and display this message:
API server not running at http://localhost:8000. Start it with:
- make run-dev in packages/api/, OR
- docker compose -f infra/docker-compose.dev.yml up aihub-api -d

Step 2: Generate the SDK

Run from packages/web/:

cd packages/web && pnpm generate-sdk

This uses the config at packages/web/openapi-ts.config.ts to fetch the OpenAPI spec from http://localhost:8000/api/v1/active/openapi.json and regenerate TypeScript files into packages/web/sdk/client/ (types.gen.ts, sdk.gen.ts, schemas.gen.ts, client.gen.ts, transformers.gen.ts).

Step 3: Lint Generated Code

cd packages/web && pnpm lint --fix

This auto-fixes formatting issues in the generated TypeScript files.

Step 4: Verify and Report

Confirm generated files exist and are non-empty:

ls -la packages/web/sdk/client/types.gen.ts packages/web/sdk/client/sdk.gen.ts

Check for TypeScript compilation errors in the generated output:

cd packages/web && pnpm nuxi typecheck 2>&1 | head -30

Report what changed:

git diff --stat -- packages/web/sdk/client/

Summarize: new endpoints added, modified request/response types, removed endpoints, number of files changed.

Examples

/generate-sdk — Full regeneration workflow (verify, generate, lint, report)

Troubleshooting

API not running: Start it with docker compose -f infra/docker-compose.dev.yml up aihub-api -d or make run-dev in packages/api/
pnpm not found: Run corepack enable or install pnpm globally
Generation produces no changes: The API spec may not have changed. Verify your API changes are deployed to the running server.
Lint errors after generation: Some generated code may have issues the linter cannot auto-fix. Review the lint output and fix manually if needed.

When to Run

Run this skill after any of these changes:

Adding new API endpoints (new routes in FastAPI)
Modifying DTOs or Pydantic response/request models
Changing route paths or HTTP methods
Updating query parameters or path parameters

同仓库更多 Skills

同仓库

scaffold-agent

bbvch-ai/aihub-core

Generate a new AI agent with all boilerplate (agent class, events, config with form duality, memory, LLM streaming, i18n, BDD tests, entry point). Includes pattern catalog, execution model reference, and implementation checklist. Use when user says "create new agent", "scaffold an agent", "generate agent boilerplate", "add AI agent", "new workflow agent", or "build an agent for X". Do NOT use for debugging agents (use /debug-agent), event infrastructure (use /nats-events), or process orchestration (use /scaffold-process).

2026-08-039

docker-dev

bbvch-ai/aihub-core

Manage the Docker Compose development stack and understand the Jinja2 template-based compose generation system. Covers start/stop/health/logs/restart/status/ports for the dev stack, the template-to-generate-to-commit workflow, and documentation lookup via Context7 MCP. Use when user says 'start docker', 'stop containers', 'check service health', 'show logs', 'restart service', 'docker status', 'which ports are used', 'is the API running', 'regenerate compose', or 'how does docker compose generation work'. Pass action as argument. Do NOT use for reviewing Docker Compose changes (use deployment-reviewer agent) or debugging Dagster pipelines (use /debug-pipeline).

2026-07-029

write-issue

bbvch-ai/aihub-core

Author a new, convention-conformant GitHub issue for bbvch-ai/aihub-core — title format, the In scope / Out of scope / Accepted when body structure, area:* and version labels, sibling and blocked-by cross-references — then create it and add it to the AI-Scrum board (org project 37) with Item Type, Priority, and Status set. Use when user says 'write an issue', 'create a GitHub issue', 'open an issue for X', 'file a bug', 'draft an epic', or 'add a story to the board'. Do NOT use for planning an existing issue's implementation (use plan-issue), breaking an issue into sub-issues (use splice-issue), or creating a PR (use create-pr).

2026-06-259

setup-bot-connection

bbvch-ai/aihub-core

End-to-end guide for setting up a new bot connection in swiss_ai_hub.bot. Covers Azure App Registration, Bot Channels Registration, Teams/Slack channel config, PathEntity creation in bot_paths collection, and DevTunnel for local dev. Use when user says "set up a bot", "connect bot to Teams", "connect bot to Slack", "configure bot channel", "create bot connection", "DevTunnel setup", "bot local development", or "Azure bot registration". Do NOT use for bot handler code scaffolding (use scaffold-bot-handler), bot architecture questions (use bot-framework), or agent debugging (use debug-agent).

2026-06-159

likec4-dsl

bbvch-ai/aihub-core

Use when working with `.c4`/`.likec4` files or LikeC4 CLI/config questions where exact DSL/CLI syntax is required, especially for strict command/snippet-first answers, validate/export flags, predicates `*`/`_`/`**`, deployment snippets, dynamic views, or relationship extension matching.

2026-06-099

audit-frontend

bbvch-ai/aihub-core

Run a comprehensive frontend code audit of the Nuxt 3 admin interface. Checks Pinia-Colada query/mutation patterns, TypeScript strictness, component architecture, SDK freshness, i18n coverage, and Tailwind usage. Use when user says 'audit the frontend', 'check frontend code quality', 'find unused components', 'composable health check', 'pinia-colada audit', 'typescript errors', or 'frontend code review'. Do NOT use for backend API audits (use scaffold-api-endpoint) or bot UI issues (use debug-bot). Reports issues with file locations and severity levels.

2026-05-279

name	generate-sdk
description	Regenerate the frontend TypeScript API client from the OpenAPI spec using openapi-ts. Verifies API server is running, runs the code generator against openapi-ts.config.ts, and lints the output into sdk/client/. Use when user says 'regenerate SDK', 'update API client', 'sync frontend types', 'generate TypeScript client', 'API changed, update frontend', or 'openapi-ts'. Do NOT use for scaffolding frontend pages or composables (use scaffold-frontend-page, scaffold-composable), backend API endpoint creation (use scaffold-api-endpoint), or manual SDK file edits (sdk/client/ is fully generated).
allowed-tools	Bash, Read, Grep, Glob, mcp__context7__resolve-library-id, mcp__context7__query-docs

Frontend API SDK Generation

Regenerate the TypeScript API client from the live OpenAPI specification.

Step 1: Verify API Server Is Running

curl -s -o /dev/null -w "%{http_code}" http://localhost:8000/api/v1/active/docs

200: Proceed to Step 2
Any other code or connection refused: Stop and display this message:
API server not running at http://localhost:8000. Start it with:
- make run-dev in packages/api/, OR
- docker compose -f infra/docker-compose.dev.yml up aihub-api -d

Step 2: Generate the SDK

Run from packages/web/:

cd packages/web && pnpm generate-sdk

Step 3: Lint Generated Code

cd packages/web && pnpm lint --fix

This auto-fixes formatting issues in the generated TypeScript files.

Step 4: Verify and Report

Confirm generated files exist and are non-empty:

ls -la packages/web/sdk/client/types.gen.ts packages/web/sdk/client/sdk.gen.ts

Check for TypeScript compilation errors in the generated output:

cd packages/web && pnpm nuxi typecheck 2>&1 | head -30

Report what changed:

git diff --stat -- packages/web/sdk/client/

Summarize: new endpoints added, modified request/response types, removed endpoints, number of files changed.

Examples

/generate-sdk — Full regeneration workflow (verify, generate, lint, report)

Troubleshooting

API not running: Start it with docker compose -f infra/docker-compose.dev.yml up aihub-api -d or make run-dev in packages/api/
pnpm not found: Run corepack enable or install pnpm globally
Generation produces no changes: The API spec may not have changed. Verify your API changes are deployed to the running server.
Lint errors after generation: Some generated code may have issues the linter cannot auto-fix. Review the lint output and fix manually if needed.

When to Run

Run this skill after any of these changes:

Adding new API endpoints (new routes in FastAPI)
Modifying DTOs or Pydantic response/request models
Changing route paths or HTTP methods
Updating query parameters or path parameters