version: "1.0.0"

모델 리스트 업데이트 스킬

개요

Caret의 지원 모델 리스트를 자동 생성하고 관련 문서를 업데이트하는 스킬입니다.

사용 시점

• 새로운 API 프로바이더나 모델이 src/shared/api.ts에 추가되었을 때
• README나 문서에서 프로바이더/모델 개수를 업데이트해야 할 때
• 지원 모델 리스트 문서를 재생성해야 할 때

스크립트 위치

careti-scripts/build/generate-support-model-list.js

실행 명령

node careti-scripts/build/generate-support-model-list.js

생성 파일

스크립트 실행 시 다음 파일들이 자동 생성됩니다:

• careti-docs/development/support-model-list.mdx (한국어)
• careti-docs/development/support-model-list.en.mdx (영어)

데이터 소스

• API 정의 파일: src/shared/api.ts
• 파싱 대상:
• ApiProvider 타입에서 프로바이더 목록 추출
• *Models 객체들에서 모델 정보 추출 (maxTokens, contextWindow, supportsImages, inputPrice, outputPrice)

워크플로우

1. 스크립트 실행

node careti-scripts/build/generate-support-model-list.js

2. 출력 확인

📊 추출된 데이터:
   🔹 프로바이더: 44개 (ApiProvider 타입)
   🔹 총 모델: 349개
   🔹 유니크 모델: 266개
   🔹 모델 섹션: 31개 (실제 프로바이더)

3. README 파일 업데이트

다음 파일들의 프로바이더/모델 개수를 업데이트해야 합니다:

메인 저장소:

• README.md
• careti-docs/readme-i18n/README.ko.md
• careti-docs/readme-i18n/README.ja.md
• careti-docs/readme-i18n/README.zh-cn.md
• careti-docs/readme-i18n/README.fr.md
• careti-docs/readme-i18n/README.de.md
• careti-docs/readme-i18n/README.ru.md

docs.careti.ai:

• docs.careti.ai/README.md
• docs.careti.ai/README.ko.md
• docs.careti.ai/docs-*/getting-started/what-is-careti.mdx (7개 언어)

업데이트 텍스트 패턴

스크립트 출력의 모델 섹션 수와 유니크 모델 수를 사용:

• 영어: {N} providers, {M} models
• 한국어: {N}개 프로바이더, {M}개 모델
• 일본어: {N}プロバイダー、{M}モデル
• 중국어: {N}个提供商，{M}个模型
• 프랑스어: {N} fournisseurs, {M} modèles
• 독일어: {N} Anbieter, {M} Modelle
• 러시아어: {N} провайдеров, {M} моделей

현재 통계 (2026-01)

• 프로바이더 (모델 섹션): 31개
• 유니크 모델: 266개
• 총 모델 정의: 349개

문제 해결

프로바이더 개수가 맞지 않을 때

extractModelData() 함수의 파싱 로직 확인:

• api.ts의 *Models 객체가 } as const 또는 } as const satisfies Record<...>로 끝나는지 확인
• 누락된 프로바이더가 있으면 해당 객체의 끝 패턴 수정

스크립트가 실행되지 않을 때

# 직접 실행
node careti-scripts/build/generate-support-model-list.js

참고 사항

• 스크립트는 api.ts를 파싱하여 데이터를 추출하므로, api.ts의 형식이 변경되면 스크립트도 수정 필요
• 생성된 문서는 자동 생성이므로 직접 수정하지 말 것
• 가격 정보를 추가할 때는 inputPrice, outputPrice를 모델 객체의 다른 속성들보다 앞에 배치 (중첩 객체 파싱 이슈 방지)

미러링 정책

.agents/와 .users/는 1:1 미러링 구조입니다.

• 이 파일 수정 시 .agents/skills/update-model-list/SKILL.md도 동일하게 업데이트
• .agents/는 영어(토큰 효율), .users/는 사용자/팀 언어(상세 설명)
• 참조: assets/agents_template/AGENTS.md의 Key Principles