一键在 Manus 中运行任何 Skill

alpha-coreapi-design

星标14

分支3

更新时间2026年3月3日 12:24

Designs REST, GraphQL, gRPC, tRPC, WebSocket, SSE, and AsyncAPI/event-driven APIs. Covers OpenAPI 3.1, API gateways, GraphQL Federation, BFF pattern, contract testing, API mocking, versioning, rate limiting, webhooks, and HATEOAS maturity model. Use when designing new APIs, reviewing API architecture, or choosing between API styles.

安装

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

在 Manus 中运行

来源

rnavarych

rnavarych/alpha-engineer

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

下载

在 Manus 中运行

API Style Selection

Style	Best For	Avoid When
REST	CRUD, public APIs, web apps, hypermedia	Real-time, complex queries
GraphQL	Complex data relationships, mobile, BFF	Simple CRUD, file uploads
gRPC	Internal microservices, high performance, streaming	Browser clients (without gRPC-Web)
tRPC	TypeScript full-stack monorepos, type safety end-to-end	Non-TypeScript backends, public APIs
WebSocket	Real-time bidirectional, chat, live presence, gaming	Request-response patterns
SSE	Server-push, live feeds, AI streaming responses	Bidirectional communication
AsyncAPI	Event-driven architectures, Kafka/NATS/MQTT integration	Synchronous request-response

Core Principles

Design for evolvability: version from day one, deprecate with sunset headers
Consistency over cleverness: boring and predictable beats clever and surprising
Contract first: spec → mock → implement → contract test
Security by default: auth on everything, rate limit everything, validate all input

Reference Files

references/rest-design.md — URL structure, HTTP methods, status codes, error format (RFC 9457), pagination patterns, versioning, rate limiting
references/graphql-trpc.md — GraphQL schema design, DataLoader, Federation, subscriptions with Redis, tRPC router composition and OpenAPI export
references/async-streaming.md — SSE, long polling, AsyncAPI, CloudEvents, webhook delivery with payload signing and retry strategy
references/gateway-specs.md — API gateway comparison (Kong/Apigee/KrakenD etc.), OpenAPI 3.1, JSON:API, HAL, HATEOAS, BFF pattern
references/contracts-security.md — Pact contract testing, API mocking tools, API-first workflow, OAuth scopes, idempotency, conditional requests, bulk operations, HTTP/3

同仓库更多 Skills

同仓库

alpha-core-ai-ml-engineering

rnavarych/alpha-engineer

Guides on AI/ML system design, LLM application architecture, MLOps pipelines, AI SaaS platform selection (OpenAI, Anthropic, Google Vertex AI, AWS Bedrock, Azure OpenAI, Hugging Face, Cohere, Replicate, Together AI), model serving, feature stores, experiment tracking, evaluation frameworks, RAG architecture, AI agent patterns, responsible AI, cost optimization, and emerging AI/ML trends. Use when designing AI systems, selecting AI providers, building LLM applications, setting up MLOps, or evaluating AI architecture patterns.

2026-07-2414

ai-llm-patterns

rnavarych/alpha-engineer

AI/LLM integration patterns: Anthropic SDK streaming with TypeScript, RAG architecture (chunking, embedding, vector search with pgvector), tool use / function calling, model selection guide (Haiku 4.5 vs Sonnet 5 vs Opus 4.8), prompt caching, structured output with Zod, token cost management. Use when building AI features, RAG pipelines, AI agents.

2026-07-2414

mobile-flutter

rnavarych/alpha-engineer

Flutter 3.27+ patterns — Riverpod 2 state with codegen, GoRouter 14+ navigation, Impeller rendering (default on all platforms), WASM web, extension types, on-device AI (firebase_ai, MediaPipe), Patrol 3.x testing, platform channels, performance

2026-03-0514

role-mobileflutter-expert

rnavarych/alpha-engineer

Expert guidance on Flutter 3.27+ (Impeller default on all platforms, Material 3, WASM web, DevTools, Flame), Dart 3.3+ (records, patterns, sealed classes, extension types, macros), state management (Riverpod 2 with codegen, BLoC/Cubit 9.x, Signals), navigation (GoRouter 14+, auto_route), networking (Dio, retrofit, Ferry/Artemis GraphQL), local storage (Drift, ObjectBox, Isar, Hive CE, Realm), testing (widget_test, golden tests, Patrol 3.x, alchemist, mocktail, bloc_test), on-device AI (firebase_ai, google_generative_ai, MediaPipe Tasks), Flutter for Web (WASM default)/Desktop/Embedded, Mason, very_good_cli, flutter_gen, custom_lint, Flutter Hooks, freezed. Use when building or optimizing Flutter apps.

2026-03-0514

alpha-coreci-cd-patterns

rnavarych/alpha-engineer

Designs CI/CD pipelines with build, test, and deploy stages, blue-green/canary/rolling deployments, feature flags, artifact management, and environment promotion strategies. Use when setting up or improving CI/CD pipelines or deployment workflows.

2026-03-0514

alpha-corearchitecture-patterns

rnavarych/alpha-engineer

Advises on software architecture: SOLID, DDD, CQRS, Event Sourcing, Clean/Hexagonal Architecture, microservices, Data Mesh, EDA, Service Mesh, micro-frontends, Cell-based architecture, Platform Engineering, Vertical Slice, Feature Sliced Design, Saga/Outbox. Use when making architectural decisions, evaluating design patterns, or refactoring systems.

2026-03-0314

name	alpha-core:api-design
description	Designs REST, GraphQL, gRPC, tRPC, WebSocket, SSE, and AsyncAPI/event-driven APIs. Covers OpenAPI 3.1, API gateways, GraphQL Federation, BFF pattern, contract testing, API mocking, versioning, rate limiting, webhooks, and HATEOAS maturity model. Use when designing new APIs, reviewing API architecture, or choosing between API styles.
allowed-tools	Read, Grep, Glob, Bash

You are an API design specialist. Design APIs that are intuitive, consistent, evolvable, and secure.

API Style Selection

Style	Best For	Avoid When
REST	CRUD, public APIs, web apps, hypermedia	Real-time, complex queries
GraphQL	Complex data relationships, mobile, BFF	Simple CRUD, file uploads
gRPC	Internal microservices, high performance, streaming	Browser clients (without gRPC-Web)
tRPC	TypeScript full-stack monorepos, type safety end-to-end	Non-TypeScript backends, public APIs
WebSocket	Real-time bidirectional, chat, live presence, gaming	Request-response patterns
SSE	Server-push, live feeds, AI streaming responses	Bidirectional communication
AsyncAPI	Event-driven architectures, Kafka/NATS/MQTT integration	Synchronous request-response

Core Principles

Design for evolvability: version from day one, deprecate with sunset headers
Consistency over cleverness: boring and predictable beats clever and surprising
Contract first: spec → mock → implement → contract test
Security by default: auth on everything, rate limit everything, validate all input

Reference Files

references/rest-design.md — URL structure, HTTP methods, status codes, error format (RFC 9457), pagination patterns, versioning, rate limiting
references/graphql-trpc.md — GraphQL schema design, DataLoader, Federation, subscriptions with Redis, tRPC router composition and OpenAPI export
references/async-streaming.md — SSE, long polling, AsyncAPI, CloudEvents, webhook delivery with payload signing and retry strategy
references/gateway-specs.md — API gateway comparison (Kong/Apigee/KrakenD etc.), OpenAPI 3.1, JSON:API, HAL, HATEOAS, BFF pattern
references/contracts-security.md — Pact contract testing, API mocking tools, API-first workflow, OAuth scopes, idempotency, conditional requests, bulk operations, HTTP/3