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

api-change

Change the TURNPool API types safely - edit types and markers, regenerate, update webhooks, tests and docs. Use whenever a field is added, removed or re-marked in api/v1alpha1.

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

Hazmi35/turnfleet스타 2(GitHub 2 + cccskills 0)

실행 점수 미검증

설치 방법 보기

포함된 파일(1)

  • SKILL.md2.5 KB

SKILL.md(원문)

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

Changing the TURNPool API

Work in this order. Each step catches a different class of mistake.

  1. Edit api/v1alpha1/turnpool_types.go.
    • Every field is explicitly +optional or +required. No floats. Ratios are portsInUse/portsTotal integers that consumers divide.
    • Lists get +listType=map + +listMapKey=<key> (or +listType=atomic with a one-line reason). Avoid maps.
    • Status fields are +optional and derived from the spec, never cached from it. Conditions stay the first status field, set with meta.SetStatusCondition.
    • New enum values: extend the Go type, the +kubebuilder:validation:Enum marker, and every switch over it (the exhaustive linter fails the build otherwise). Add the doc comment on the new value, and the AGENTS.md glossary line for it when the value names a domain concept, in the same edit.
  2. Decide mutability. Anything that would invalidate live allocations is immutable: relay port range, addressing mode and its per-node split, realm. Adding it to the immutability check in internal/webhook/v1alpha1/turnpool_webhook.go is part of the change, with the reason in the validation message.
  3. Regenerate (make generate manifests api-docs). Never hand-edit zz_generated.deepcopy.go, config/crd/bases/*, config/rbac/role.yaml or docs/api.md.
  4. Update the webhooks: defaulting for anything with a sensible default, validating for the rules the CRD schema cannot express (mode-specific config, listener port uniqueness, ports outside the relay range, overlap between relays sharing an address).
  5. Update tests:
    • internal/webhook/v1alpha1/turnpool_webhook_test.go for defaulting and each rejection (envtest, table-driven).
    • internal/relay golden files if the rendered coturn config changes; a new field that reaches the data plane always changes the goldens.
    • test/e2e/ if the field is observable from outside.
  6. Update docs: docs/api.md is generated. docs/architecture.md and docs/capacity-model.md are not. A new addressing mode also needs an ADR (add-addressing-mode).
  7. Prove it: make ci. If the change touches the data plane, make test-e2e.

Report which files changed and which command proved the change.

리뷰

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

댓글

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

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

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

0 / 1,000자

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

같은 저장소의 스킬

Add a new addressing mode to Turnfleet - implement Planner and Renderer, golden tests, an e2e case and an ADR. Use when a new way of assigning relay addresses or port ranges is needed.

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

Hazmi35/turnfleet22026년 10월 25일 업데이트

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/spec asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

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

Hazmi35/turnfleet22026년 10월 25일 업데이트

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

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

Hazmi35/turnfleet22026년 10월 25일 업데이트

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

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

Hazmi35/turnfleet22026년 10월 25일 업데이트

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

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

Hazmi35/turnfleet22026년 10월 25일 업데이트

e2e-debug

무료

Debug a failing relay end to end - inspect the kind cluster, relay logs and rendered coturn config, and run turnfleet-probe by hand. Use when a relay never forms, a probe fails, or an e2e case breaks.

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

Hazmi35/turnfleet22026년 10월 25일 업데이트

Hazmi35의 스킬 모두 보기

이 스킬의 문제 신고