사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/sztadii/agent-skills --skill kineti-fe-types-sync시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Sync backend types in a Kineti frontend
Scope
Generate current backend contracts, adapt frontend consumers/mocks and verify in the selected task checkout. Leave changes uncommitted for review in Changes; do not push, publish PRs/packages/compare links, deploy or change schedules. Editing this skill does not invoke it.
Workflow
Resolve inputs
Read remotes, repository/nested instructions, package.json, generator configuration and CI. Use existing generators/scripts, never replacements. Check open PRs and remote branches for overlap; report it and continue unless a concrete conflict exists. Preserve others' work; absent PRs do not mean absent work.
Fetch frontend/backend default branches and record SHAs. Use a current frontend base, preserving user work/history; report blockers instead of resetting, discarding or silently stashing. Verify these kineti1 mappings against current config:
| Frontend | Backend inputs | Generation |
|---|---|---|
| drones-frontend | drones-backend/docs/openapi.json, drones-backend/docs/ws_models.json, gdk-backend/docs/openapi.json | pnpm run generate-api-types; OpenAPI and WebSocket generators |
| gdk-frontend | gdk-backend/docs/openapi.json | pnpm run generate-api-types; openapi-ts.config.ts |
For other frontends, derive repositories, schema/output paths and commands from config; ask for missing mappings. Do not guess or edit BE code.
Generate
- Prepare isolated backend copies pinned to recorded SHAs using clone or
fetch/pull --ff-only. Preserve user backend checkouts and expected sibling paths. On collision, use an isolated layout with a frontend symlink to the task checkout; verify resolution/output lands there. Do not move frontend changes into a temporary clone or rewrite shared generator paths.
- Set
AWS_PROFILE=kinetion every authentication/install command and retry.
Run AWS_PROFILE=kineti pnpm run preinstall, then AWS_PROFILE=kineti pnpm install --frozen-lockfile in the frontend checkout. Use project pnpm/registry/hooks, not inherited shell setup or global credential changes. Keep secrets private; diagnose auth with AWS_PROFILE=kineti aws sts get-caller-identity.
- Run complete existing generation; inspect outputs and formatting side effects.
Keep generated contracts unedited. Change dependencies/locks only when demonstrably necessary and in scope.
Adapt and verify
Run full typecheck, executing later stages separately if blocked by earlier ones. Before adapting code, mocks and tests, compare changed contracts with schemas and backend implementation: nullability, required fields, enums, shapes and runtime semantics. Update visible-text translations through existing tools. Do not hide incompatibility with any, unjustified casts, weaker types, disabled checks or removed assertions. Fix related failures and rerun affected checks.
After installation, generation and adaptations are complete, run independent checks in parallel. Serialize prerequisites and checks that share mutable resources; collect every result before fixing failures.
Ready requires full typecheck and the complete non-watch CI unit suite. Run other lint/format/translation/build checks only if PR CI requires them; behavior changes alone do not justify extra suites. Discover project commands: drones-frontend uses test-ci, gdk-frontend test:ci. Include uncommitted changes in check scope; use NX_SKIP_NX_CACHE=true NX_NO_CLOUD=true for Nx verification.
Never run local/remote E2E or browser suites, including Playwright/Cypress, even if repository instructions mention them. Inspect aggregate scripts/Nx targets; select non-E2E targets. Report E2E as intentionally unrun, not passed or blocking. Do not disable or modify CI.
Inspect the final diff and reproducible generation from pinned inputs. Remove accidental churn, preserving user work. Install/generator failures are blockers, not evidence of breaking BE contracts. Report unresolved upstream/external issues as incomplete with evidence.
Result
Reply briefly in Polish: no changes / ready locally in Changes / blocked or needs a decision. Include frontend/backend SHAs, generated/adapted areas, similar PRs, generation/typecheck/other results and failed/unrun checks. For remaining TS errors, give file, message and contract change. Types alone cannot prove runtime compatibility. End at the local reviewable result.

