本文へ移動
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(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

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月12日 更新

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月12日 更新

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月12日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

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

astro

無料

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

日本語の概要は準備中です。原文の説明を表示しています。

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

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

日本語の概要は準備中です。原文の説明を表示しています。

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

lgzarturo のスキルをすべて見る

このスキルの問題を報告する