跳到正文
cccskills
免费在 GitHub 公开

openapi

Use this skill to maintain FlexPrice’s OpenAPI specification and generated SDK or MCP tooling. It explains the generation and validation sequence, where custom code belongs, and when an API-only update may not require regenerating every client.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Swagger + Speakeasy SDK/MCP pipeline (make swagger, sdk-all), api/custom merge. Trigger: openapi, swagger, sdk-all, MCP.

flexprice/flexprice星标 6,876(GitHub 6,876 + cccskills 0)

实测评分 未实测

查看安装方法

适用场景

  • Updating the OpenAPI spec after route changes
  • Generating SDKs and MCP tooling
  • Validating an OpenAPI change
  • Keeping custom code through regeneration

包含的文件(1)

  • SKILL.md1.4 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

openapi — OpenAPI & SDKs

Source of truth

  • Handlers: Swagger comments in internal/api/**.
  • Generated specs: docs/swagger/ (run generation — do not hand-edit JSON as primary source).

Standard sequence

After route or Swagger annotation changes:

make swagger
make sdk-all

make sdk-all (per AGENTS.md) validates, generates SDKs/MCP, merges api/custom/**.

OpenAPI-only validation:

make speakeasy-validate

Custom vs generated

  • Do not put long-lived custom logic only in generated trees under api/go, api/typescript, api/python, api/mcp.
  • Put custom code in api/custom/<lang>/ and rely on make merge-custom (often part of sdk-all).

MCP tooling

Filtered spec and allowed tags live under .speakeasy/mcp/ — changing exposed tools requires config update + regenerate flow documented in AGENTS.md.

When to skip full sdk-all

Small internal-only HTTP tweak with no exported contract change: make swagger alone may suffice; coordinate with reviewers if public SDK repos are consumers.

Related

  • Tests after API change: expand handler tests or api/tests if behavior is user-facing SDK contract.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

apitest

免费

Run local HTTP API checks with a staged workflow: confirm the environment, gather credentials interactively, probe endpoints with curl, and record status codes and response excerpts. For large suites, it can divide independent endpoint groups among workers and merge their results.

中文简介正在准备中。当前显示英语简介。

  • Smoke-checking a local API
  • Testing authenticated endpoints with curl
  • Organizing checks across many endpoints
flexprice/flexprice68762026年10月29日 更新

arch

免费

Navigate FlexPrice’s codebase using its architecture maps, dependency graphs, hotspot notes, and flow documents. Trace a feature across layers and async systems, assess likely change impact, and identify documentation that should be updated after structural edits.

中文简介正在准备中。当前显示英语简介。

  • Getting oriented in the FlexPrice codebase
  • Tracing a feature across code layers
  • Assessing impact before a refactor
flexprice/flexprice68762026年10月29日 更新

compose

免费

Use this skill to set up or manage FlexPrice’s local Docker environment. It provides commands to start and stop services, launch Kafka UI, and follow application logs while troubleshooting.

中文简介正在准备中。当前显示英语简介。

  • Setting up the local development environment
  • Starting or stopping FlexPrice services
  • Opening Kafka UI during development
flexprice/flexprice68762026年10月29日 更新

Use this skill to check whether repository AGENTS.md context files have fallen behind code changes. It compares tracked file ownership with Git revisions, prepares focused update bundles for affected layers, and advances sync markers after the context is updated.

中文简介正在准备中。当前显示英语简介。

  • Checking whether AGENTS.md files are stale
  • Refreshing context after code changes
  • Updating one layer’s context file
flexprice/flexprice68762026年10月29日 更新

devenv

免费

Plan a local development setup by mapping which services run in Docker Compose and which use hosted endpoints such as RDS or managed Kafka. The skill guides environment configuration, service checks, migrations, and choosing an application mode.

中文简介正在准备中。当前显示英语简介。

  • Preparing a hybrid local and hosted development setup
  • Starting an API, consumer, or Temporal worker locally
  • Checking environment settings before migrations
flexprice/flexprice68762026年10月29日 更新

gh

免费

Use the GitHub CLI to review pull requests and issues, inspect CI check results and failed logs, and prepare a pull request with a summary and test plan. The skill also outlines the repository review steps before creation.

中文简介正在准备中。当前显示英语简介。

  • Reviewing a pull request or issue from the CLI
  • Finding the cause of a failed CI check
  • Preparing and creating a pull request
flexprice/flexprice68762026年10月29日 更新

查看 flexprice 的全部技能

报告此技能的问题