본문으로 건너뛰기
cccskills
무료GitHub에 공개

api-contract

Use when adding or changing REST endpoints or the OpenAPI contract — deriving endpoints from the Lean commands and views, writing documents/codebase/openapi.yaml first, then regenerating the backend controller interfaces and the frontend client.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(2)

  • SKILL.md2.6 KB
  • scripts/contract-check.mjs7.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

API 契約(Lean → openapi.yaml → 生成)

正本は documents/codebase/openapi.yaml。実装より先に契約を直し、両側を生成し直す。

手順

  1. cradle spec-query meta でコマンドの構成子・内部入力(observations。提供元の通知・契機)・外部能力の Port・画面の口を取る。spec-query print でペイロードと View の形を取る。
  2. 契約を書く: コマンド 1 構成子 = 1 エンドポイント(POST /api/…、成功は 204、x-cradle-kind: command)。観測(内部入力)は提供元から受ける口が要るときだけエンドポイントを持つ(x-cradle-kind: observation。worker だけが受けるものは作らない)。GET 以外の操作はすべて x-cradle-kind と x-cradle-model(<Root>.Runtime.Command.<構成子> か <Root>.Runtime.Observation.<構成子>)を宣言する。画面 1 つ = 1 GET。名義(actor)はリクエストに現れず、観測の受信口にも名義は無い。「今日」も受け取らない。観測は利用者の入力欄に出さない。
  3. 各操作の 422 に、その UseCase の validate / execute が返しうる DomainError を列挙する(Domain/Error.lean と UseCase の契約定理から)。403(立場)と 404(宛先なし)は分ける。
  4. 文字列には長さ上限、識別子には形式。入力検証は契約から生成させる。
  5. View の値は View 自身の語彙(日付は ISO 文字列)。契約の語彙 = 画面の語彙。
  6. 生成: backend は ./gradlew generateApi(Controller interface + Request/Response)、frontend は pnpm gen:api。写し漏れはコンパイルエラーで出る。
  7. このスキルの scripts/contract-check.mjs で確かめる: GET 以外の操作がすべて x-cradle-kind と x-cradle-model を宣言している(宣言の無い操作は除外せず NG)、x-cradle-model がモデルにある構成子を指す、コマンドと command の操作が 1 対 1、観測の操作は高々 1 つ、画面の口に GET がある(cradle.json の api.outletsWithoutEndpoint に挙げた口を除く)。

書かないもの

HS / MQ / UX の ID・経緯・存在しない操作の一覧・申し送り。契約書は「いまどうであるか」だけ。

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Use after a backend build succeeds or whenever authentication, authorization, actor/identity handling, external service calls (IdP, JWKS, DB, clock), logging, observability, configuration or error contracts are in play — delegates to the backend-design-reviewer agent for a design-quality review of the current branch.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

asuka1975/cradle52026년 10월 1일 업데이트

Use when it is time to make the backend follow the Lean model — regenerate Kotlin from Lean, implement the generated interfaces (UseCase, QueryService, Repository, Entity), wire every generated contract test, make the build green, then run the design and SQL reviews. Backend comes after the human confirmed the screens.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

asuka1975/cradle52026년 10월 1일 업데이트

cradle

무료

Use when you need the current position in the Lean spec-driven pipeline, or any deterministic check of a Cradle project — status, golden regression, Lean layer walls, regeneration impact, unslop lint, ddd cleanup. Runs the scripts under scripts/ and reports their output verbatim.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

asuka1975/cradle52026년 10월 1일 업데이트

Use to start a new product on Cradle or to add the Cradle skeleton to an existing repository — writes cradle.json, the project-facts instruction (.apm/instructions/project.instructions.md), documents/{ddd,ai-notes,infra-design,codebase} templates, CI, and a compiling Lean executable-spec scaffold with a minimal example domain, mockup and CLI.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

asuka1975/cradle52026년 10월 1일 업데이트

Use when the product owner asks where the project stands, what to do next, or which phase of the Lean spec-driven pipeline is current — runs cradle status and proposes exactly one next step.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

asuka1975/cradle52026년 10월 1일 업데이트

ddd

무료

Use to run or continue domain exploration with the product owner as domain expert — event storming interviews, hotspots (HS), ubiquitous language, UX review of the domain, checking or resolving open MQ/UX items, or a status summary of documents/ddd. Also use when the user starts explaining their business, purpose or workflow. Never edit documents/ddd directly; go through this skill.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

asuka1975/cradle52026년 10월 1일 업데이트

asuka1975의 스킬 모두 보기

이 스킬의 문제 신고