xxwzkdwz/astra-cost-preview-skill

Task Cost Preview · 공사 전 견적

사용자가 만들고 싶은 것을 설명 → Astra가 작업 범위와 작업량 평가 → 동시에 표준 및 Fast 요금 견적 제공 → 사용자가 선택한 후에야 작업 시작. 핵심은 사전 견적이며, 사후 정산, 자동 실행 또는 장황한 비용 설명이 아닙니다.

이 Skill을 사용하여 견적을 요청할 때 기본적으로 견적만 제공합니다. 사용자가 "게임 하나 만들어줘, 먼저 견적만 내봐"라고 말해도 먼저 견적을 제공하고 선택을 기다려야 합니다. "견적 후 바로 해"라고 명확히 말한 경우에만 원래 승인 범위 내에서 계속 진행합니다. 견적 자체에도 소량의 모델 사용량이 소모되며, 비용이 발생하지 않음을 보장하지 않습니다.

"Astra에게 물어봐"는 실제 실행 중인 Astra가 사용 가능한 정보를 바탕으로 평가하라는 의미이며, 모델 내부에 견적 인터페이스가 존재한다는 의미는 아닙니다. 현재 모델이 Astra가 아니거나 신원을 알 수 없는 경우, 이미 Astra에게 물어본 척 하지 않습니다. 명확히 "Astra 요율로 추정"이라고 표시할 수 있습니다. 이 Skill은 자체적으로 모델을 전환하거나, 어시스턴트를 생성하거나, 추가 유료 모델 요청을 시작하지 않습니다.

기준 확정

• 우선 현재 도구가 명확히 제공하는 모델, 결제 채널, 속도 등급 및 작업 범위를 사용합니다. 사용자가 "너는 Astra야"라고 말하거나 모델 문체로 신원을 추측하지 않습니다. 누락 시 '알 수 없음'으로 표시하거나, 명확히 명명된 시나리오 추정을 나열합니다.
• API 금액, Codex 결제 credits, 구독 포함 한도, 공급업체 내부 컴퓨팅 비용을 구분합니다. API 등가 금액은 사용자 실제 결제 금액이 아닙니다. credits는 잔여 백분율이 아닙니다. 공급업체 내부 비용은 공개 판매 가격으로 역산할 수 없습니다.
• 현재 적용 가능한 공식 요율을 조회하고, URL, 확인 날짜, 모델, 채널 및 과금 단위를 기록합니다. 이번 라운드에서 이미 확인된 정보를 재사용하며, 매 견적마다 긴 검색을 반복하지 않습니다. 사용 가능한 요율이 없으면 '알 수 없음'으로 작성하고, 가격을 하드코딩하여 기억하지 않으며, 무료를 기본값으로 하지 않습니다.
• 우선 직접 공식 문서 도구를 사용합니다. OpenAI 참고: 모델 페이지 https://developers.openai.com/api/docs/models/gpt-6-astra , API 가격 https://developers.openai.com/api/docs/pricing , Codex 가격 https://developers.openai.com/codex/pricing , 추론 사용량 https://developers.openai.com/api/docs/guides/reasoning . 요율은 변경될 수 있으며, 링크가 이미 확인된 증거는 아닙니다.

작업량 추정

먼저 한 문장으로 인도 범위를 정의합니다. 예를 들어 "한 스테이지의 플레이 가능한 웹 가로 스크롤 게임, 코인, 적, 부활 및 기본 테스트 포함, 출시 제외". 간단한 프로토타입과 완전한 상용 제품을 동일한 견적 범위에 혼합하지 않도록 합니다. 소량의 읽기 전용 검사만 수행합니다. 전체 작업, 유료 시험 호출 또는 새 어시스턴트를 실행하여 견적을 내지 않습니다.

가시적인 컨텍스트, 파일 크기, 도구 왕복, 전달 길이, 계획된 반복 횟수 및 실제 사용 가능한 유사 작업 기록을 결합하여 각각 가장 가능성 높은, 낮은, 높은 사용량을 예측합니다. 사용자는 우선 가장 가능성 높은 예상치를 보고, 그 옆에 합리적인 변동 범위를 확인합니다. 단순히 최저가에서 최고가까지 큰 폭의 범위만 제공하지 않습니다.

범위를 좁히는 방법은 기계적인 압축이 아니라 근거를 추가하는 것입니다. 우선 유사 작업의 실제 사용량을 매칭하고, 현재 컨텍스트 길이, 도구 기능, 캐시 가용성 및 전달 요구사항을 조정합니다. 기록이 없으면 단계별 작업량을 추정합니다. 단 하나의 과거 사례만으로 유추할 수 있으며, 검증된 정확도를 의미하지는 않습니다. 방금 완료한 작업의 실제 측정 비용을 이전에 예측한 결과인 것처럼 포장할 수 없습니다. 가장 가능성 높은 값은 명확한 작업량 시나리오에서 비롯되어야 하며, 자동으로 상한과 하한의 평균을 취할 수 없습니다.

범위가 여전히 넓다면, 결과에 가장 큰 영향을 미치는 한 가지 모호성을 찾아 짧은 질문으로 좁히거나, 더 작은 버전과 완전한 버전의 두 가지 견적을 명확히 제시합니다. 여전히 핵심 데이터가 부족하다면 추정이 거칠다는 점을 인정해야 하며, "범위가 작다"는 이유로 확신을 조작하지 않습니다. 데이터 지원 없이 "오차 20% 미만" 또는 통계적 신뢰도를 주장하지 않습니다.

과금 시 주의사항:

• 여러 번의 요청은 히스토리, 도구 결과 및 새로운 입력을 반복해서 포함하므로, 사용자의 이 한 문장만으로 계산해서는 안 됩니다.
• 캐시되지 않은 입력과 캐시된 입력을 구분합니다. 적중 여부를 알 수 없는 경우 캐시되지 않은 시나리오를 사용하거나 각각 계산하며, 적중을 보장하지 않습니다.
• 출력은 추론 과금 및 기타 과금 생성 토큰을 포함해야 하며, 최종 가시 텍스트만이 아닙니다. usage.output_tokens에 이미 reasoning_tokens가 포함되어 있다면, 후자를 중복해서 더할 수 없습니다.
• 긴 컨텍스트 임계값, 속도, 서비스 계층, 캐시 쓰기 등 규칙은 채널별로 요청 단위로 확인한 후 집계합니다. 전체 작업에 대한 누적 토큰을 단일 요청 임계값에 잘못 적용하거나, API와 Codex의 배율을 혼용할 수 없습니다.
• 이미지 생성, 비디오, 음성, 검색, 컨테이너, 기타 공급업체 도구 및 승인된 어시스턴트의 추가 사용량을 별도로 나열합니다. 가격이 책정되지 않은 항목은 '알 수 없음'으로 작성하며, 알려진 부분의 소계를 총 비용으로 가장할 수 없습니다.
• 작업 범위 내에 있고 사용자가 접근할 수 있는 사용량 데이터만 사용할 수 있습니다. 자격 증명을 읽거나, 관련 없는 채팅 기록을 스캔하거나, 계정 공유 한도의 전후 변화를 통해 이 작업 비용을 단정하지 마십시오. 다른 작업 및 한도 재설정이 방해할 수 있습니다.

견적 및 후속 조치

기본값으로 작은 견적서를 출력하며, 현재 사용자의 언어를 유지합니다:

작업: 버전 및 인도 범위를 명확히 한 문장.

| 등급 | 주요 예상 | 예상 범위 | | 표준 | 약 X credits | L–H credits | | Fast | 약 Y credits | A–B credits |

근거: 가장 중요한 한두 가지 작업량/캐시 가정; 포함되지 않은 항목 또는 특별 위험. 처음 또는 데이터 부족 시 "보정되지 않은 추정치, 실제 청구 금액이 아님"을 명시.

표준 또는 Fast 중 선택 후 시작.

X/Y 등은 형식 자리 표시자이며, 작업 및 확인된 요율을 기반으로 계산된 숫자로 대체해야 하며, 그대로 복사할 수 없습니다. 기본적으로 합리적인 반올림을 사용하며, 소수점 이하 자릿수로 예측 정밀도를 위장하지 않습니다. 특정 등급을 계산할 수 없는 경우, 해당 행을 유지하고 '알 수 없음'을 설명하며, Fast를 묵묵히 생략하지 않습니다.

두 등급 비교는 동일한 인도 범위 및 작업량 가정을 사용하고, 적용 요율만 비교합니다. 증거가 없는 한, Fast가 더 강력한 성능, 더 적은 토큰 또는 확정된 완료 시간을 가진 것으로 간주하지 않습니다. Codex credits와 API 금액의 Fast 배율은 다를 수 있으며, 각각 확인합니다. 적용 가능한 모델 요금에만 배율을 적용하고, 이미지, 타사 도구 등은 자체 요율로 계산하며, 총 가격에 일괄적으로 배율을 곱하지 않습니다.

기본값으로 사용자의 선택 또는 확인을 기다립니다. 호스트가 사용 가능한 도구를 통해 등급을 전환할 수 없는 경우, 사용자가 전환해야 함을 설명하고, Fast가 이미 켜져 있다고 거짓말하지 않습니다. 비용 관련 확인은 작업 자체의 권한 요구사항을 대체하지 않습니다. 승인 기준을 임의로 낮추거나, 유료 인터페이스를 새로 추가하거나, 작업을 위임하지 않습니다.

사용자가 예산을 설정할 때, 먼저 단위와 포함 범위를 확인합니다. 추정치가 예산을 초과하거나 주요 비용을 알 수 없는 경우, 다음 제어 가능한 유료 작업 전에 질문합니다. Skill 단독으로는 실행 중인 모델 요청, 외부 생성 작업 또는 동시 어시스턴트를 강제로 중지할 수 없습니다. 절대 초과하지 않음을 보장할 수 없습니다. 하드 예산은 실제 실행 계층의 계량 및 차단이 필요하며, 이 Skill에서 위조하지 않습니다.

사후 재계산은 사용자가 요청할 때만 수행되며, 사전 견적의 주요 프로세스를 방해하지 않습니다. 신뢰할 수 있는 작업 수준 사용량이 있는 경우 "실제 측정 사용량"을 보고하고, 요율로 계산된 금액은 여전히 "요율 추정"이며, 공식 청구서를 기준으로 합니다. 데이터가 없으면 '획득하지 못함'으로 작성합니다. 사용자가 요청할 때만 비식별화된 보정 기록을 영구 저장합니다.

선택적 로컬 계산기

여러 항목을 더하려면 python3 scripts/calculate.py quote.json을 사용합니다. 순수 오프라인이며, 모델을 호출하지 않고, 계정을 읽지 않으며, 토큰을 수집하지 않고, 요율의 최신 여부를 확인하지 않습니다.

JSON 입력 필드:

• unit: USD, CNY 또는 credits, 전체 테이블 통일; 다른 통화는 따로 계산하고, 암시적 환전을 하지 않습니다.
• items: 각 항목은 name, quantity: [low, high], expected_quantity, rate, basis, source, as_of를 포함합니다. expected_quantity는 근거가 있는 가장 가능성 높은 수량이며, 범위 내에 있어야 하고, 알 수 없거나 생략된 경우 자동으로 중간점을 취하지 않습니다.
• quantity는 명확한 과금 단위의 수량 범위입니다; rate는 단위당 적용 요율(이미 확인되고 채널/배율 처리됨)입니다; basis는 단위, 모델, 채널 및 수량 근거를 설명합니다; source는 공식 링크 또는 사용자가 제공한 요율 출처임을 명확히 표시합니다; as_of는 해당 요율 확인 날짜 YYYY-MM-DD입니다.
• 수량 또는 요율을 알 수 없으면 null을 사용하며, 0을 입력할 수 없습니다. 여러 시나리오, 모델 또는 도구를 지원하지만, 중복 과금해서는 안 됩니다.
• 동시에 두 등급을 보고할 때는 최상위 compare_fast: true를 설정하고, 각 항목에 fast_rate를 추가로 제공합니다; 적용 배율은 호출자가 현재 채널에 따라 확인합니다. 고정 도구 비용의 fast_rate는 rate와 동일합니다; Fast 요율이 누락되면 '알 수 없음'으로 처리됩니다. 두 등급은 동일한 수량 시나리오 세트를 사용합니다.

출력은 알려진 항목 소계, 총 예상 범위 및 가장 가능성 높은 값을 구분합니다; 알 수 없는 항목이 하나라도 있으면 총 예상은 비어 있습니다. 완전성은 여전히 모든 항목을 나열했는지에 달려 있으며, 계산이 통과되었다고 해서 예측이 정확함을 의미하지는 않습니다. 테스트: python3 -m unittest discover -s scripts -p 'test_*.py'.