一键在 Manus 中运行任何 Skill

api-client

星标4

分支2

更新时间2026年5月2日 18:40

Triggers when the agent modifies backend API routes, Pydantic models, or request/response types; when frontend TypeScript shows type errors against api-client/; or when openapi.json or schema.d.ts need regeneration. Covers the openapi-typescript generation workflow.

安装

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

在 Manus 中运行

来源

SecuringTheRealm

SecuringTheRealm/str-agentic-adventures

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

下载

在 Manus 中运行

API Client Workflow

Key Facts

Tool: openapi-typescript (NOT openapi-generator, NOT Java)
Output: frontend/src/api-client/schema.d.ts (committed to git)
Schema source: frontend/openapi.json (committed to git)
No running backend needed — uses the committed openapi.json
Frontend uses openapi-fetch SDK client via frontend/src/services/api.ts

Generate

./scripts/generate-client.sh

When to Regenerate

After ANY backend API schema change (models, endpoints, request/response types)
After adding/removing/modifying route decorators
After changing Pydantic model fields

After Regeneration

Commit both openapi.json and schema.d.ts together (commit-and-verify pattern)
Run cd frontend && bun run build to verify TypeScript compiles
Run cd frontend && bun test:run to verify tests pass

Usage Rules

All API calls go through frontend/src/services/api.ts — never import from api-client/ directly
The api.ts service wraps openapi-fetch with typed helpers

同仓库更多 Skills

同仓库

adr-workflow

SecuringTheRealm/str-agentic-adventures

Triggers when the agent makes technology selections, architectural pattern choices, or security/deployment strategy decisions. Covers ADR creation and conventions.

2026-05-024

agent-framework

SecuringTheRealm/str-agentic-adventures

Triggers when the agent creates or modifies AI agents, registers tools, or changes fallback logic. Covers Microsoft Agent Framework SDK patterns, singleton client, and thread management.

2026-05-024

release

SecuringTheRealm/str-agentic-adventures

Releases a new version by determining bump type from conventional commits, running lint and test checks, tagging, pushing, and creating a GitHub release. Use when ready to cut a release from main.

2026-05-024

database

SecuringTheRealm/str-agentic-adventures

SQLAlchemy ORM patterns, Alembic migrations, database session management

2026-03-254

name	api-client
description	Triggers when the agent modifies backend API routes, Pydantic models, or request/response types; when frontend TypeScript shows type errors against api-client/; or when openapi.json or schema.d.ts need regeneration. Covers the openapi-typescript generation workflow.

API Client Workflow

Key Facts

Tool: openapi-typescript (NOT openapi-generator, NOT Java)
Output: frontend/src/api-client/schema.d.ts (committed to git)
Schema source: frontend/openapi.json (committed to git)
No running backend needed — uses the committed openapi.json
Frontend uses openapi-fetch SDK client via frontend/src/services/api.ts

Generate

./scripts/generate-client.sh

When to Regenerate

After ANY backend API schema change (models, endpoints, request/response types)
After adding/removing/modifying route decorators
After changing Pydantic model fields

After Regeneration

Commit both openapi.json and schema.d.ts together (commit-and-verify pattern)
Run cd frontend && bun run build to verify TypeScript compiles
Run cd frontend && bun test:run to verify tests pass

Usage Rules

All API calls go through frontend/src/services/api.ts — never import from api-client/ directly
The api.ts service wraps openapi-fetch with typed helpers