跳到正文
cccskills
免费在 GitHub 公开

cc-api-contract

Run the API contract workflow for request/response shape changes, compatibility constraints, contract tests, documentation, and review.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(1)

  • SKILL.md1.8 KB

SKILL.md(原文)

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

API Contract Workflow

API contract request: $ARGUMENTS

Step 1 — Task Card validation (task-coach)

Invoke task-coach with the request above.

The Task Card must classify the task as feature or refactor with high risk unless the human provides a narrower validated risk. It must include:

  • affected endpoint, command, or public interface
  • request and response examples
  • backward compatibility and versioning impact
  • consumers that must remain compatible
  • contract tests and documentation acceptance criteria

STOP here. Show the Task Card and wait for human confirmation.


Step 2 — Technical Plan (architect)

Invoke architect with the approved Task Card.

architect must define the API contract, compatibility strategy, validation rules, docs/OpenAPI impact, and migration path for consumers.

STOP here. Show the Technical Plan and wait for explicit human approval.


Step 3 — Implementation (implementer)

Invoke implementer with the approved plan.

implementer must apply the minimal diff, preserve compatible behavior unless a breaking change was explicitly approved, and update only the files named in the plan.


Step 4 — Contract tests (tester)

Invoke tester.

tester must add or update contract tests covering request shape, response shape, status/error behavior, and backward compatibility constraints.


Step 5 — Review (reviewer)

Invoke reviewer.

reviewer must block on missing contract tests, undocumented breaking changes, or docs/OpenAPI drift.


Completion

Report the final Task Card, Technical Plan, implementation summary, test report, review report, docs updated, compatibility impact, and residual risks.

评价

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

评论

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

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

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

0 / 1000 字

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

同一仓库的技能

Use when adding monitoring, metrics, logging, or tracing to Spring AI or LLM integration code. Covers token tracking, latency measurement, cost estimation, and prompt/response logging. Use when user mentions AI monitoring, token costs, or LLM observability.

中文简介正在准备中。当前显示原文说明。

lgzarturo/springboot-course32026年10月17日 更新

android

免费

Provides expert knowledge for building modern native Android apps using Kotlin, Jetpack Compose, Material Design 3, MVI architecture, Hilt dependency injection, and Media3/ExoPlayer.

中文简介正在准备中。当前显示原文说明。

lgzarturo/springboot-course32026年10月17日 更新

Design, implement, review, and audit Android Jetpack Compose UI/UX for phone interfaces. Use when a request concerns concrete Compose layout, components, interaction, accessibility, or visual behavior. Do not activate for framework or dependency presence alone; non-UI Android work is excluded.

中文简介正在准备中。当前显示原文说明。

lgzarturo/springboot-course32026年10月17日 更新

Provides expert knowledge for designing, implementing, and managing REST API versioning strategies with deprecation workflows.

中文简介正在准备中。当前显示原文说明。

lgzarturo/springboot-course32026年10月17日 更新

astro

免费

Provides expert knowledge for building Astro 5+ sites with Islands Architecture, Content Collections, TypeScript, and performance-first rendering strategies.

中文简介正在准备中。当前显示原文说明。

lgzarturo/springboot-course32026年10月17日 更新

Audits token storage mechanisms to prevent XSS-based JWT theft.

中文简介正在准备中。当前显示原文说明。

lgzarturo/springboot-course32026年10月17日 更新

查看 lgzarturo 的全部技能

报告此技能的问题