Operation observed

API Contract — dartlab 호출 규칙 단일 진실의 원천

API Contract — dartlab 호출 규칙 단일 진실의 원천 운영 규칙을 Skill OS에서 확인하고 변경 전후 검증 게이트로 사용한다.

operation.apiContract GitHub 원본

절차

실행 순서

  1. 1

    1. 단일 진입점 — Dual Access (call form + attr form) 로 간다 기준을 확인한다.

  2. 2

    구현 기준을 확인한다.

  3. 3

    좋은 예 기준을 확인한다.

  4. 4

    내부 series-tuple 빌더 기준을 확인한다.

  5. 5

    검증 방법 기준을 확인한다.

  6. 6

    **IS · CIS · CF (flow)** — 4 분기 모두 있을 때만 단순 합 (3 분기 이하 → None).

  7. 7

    **BS (stock)** — Q4 (= 연말잔액). 없으면 그 해 가장 최근 분기.

  8. 8

    공개 함수는 종목코드 (str) 또는 Company 만 받는다.

  9. 9

    추가 import 금지 — `import dartlab` 하나로 모든 기능 접근.

예시

이런 질문이 들어오면 이 skill 을 쓴다

  • API Contract — dartlab 호출 규칙 단일 진실의 원천 규칙 확인
  • api-contract 작업을 Skill OS에서 시작

출력

기대 결과

  • 작업 경로
  • 확인한 근거
  • 검증 결과

Skill OS 흡수 규칙

  • 이 skill이 공식 진입점이다. 삭제된 운영 문서 경로를 다시 안내하지 않는다.
  • 공개 호출 방식과 대표 반환 형태는 skill에서 확인하고, 세부 필드는 capability/docstring으로 검산한다.
  • 분석이나 변경 결과는 ref, 실행 로그, 테스트 결과로 검증한다.

실행 순서

    1. 단일 진입점 — Dual Access (call form + attr form) 로 간다 기준을 확인한다.
  • 구현 기준을 확인한다.
  • 좋은 예 기준을 확인한다.
  • 내부 series-tuple 빌더 기준을 확인한다.
  • 검증 방법 기준을 확인한다.
  • IS · CIS · CF (flow) — 4 분기 모두 있을 때만 단순 합 (3 분기 이하 → None).
  • BS (stock) — Q4 (= 연말잔액). 없으면 그 해 가장 최근 분기.
  • 공개 함수는 종목코드 (str) 또는 Company 만 받는다.
  • 추가 import 금지 — import dartlab 하나로 모든 기능 접근.

런타임

실행 환경별 호환성

환경상태비고 / 제한
Local Python supported
Server supported
MCP supported
Web AI supported
Pyodide supported

실패 회피

흔한 실패 · 절대 금지

흔한 실패
  • Skill OS 검색 없이 과거 문서 경로를 직접 찾음
  • API schema를 skill 본문에 중복해 docstring/기능와 어긋남
  • 검증 게이트 없이 변경 또는 답변을 완료 처리함
절대 금지
  • 삭제된 운영 문서 경로를 공식 진입점으로 안내하지 않는다.
  • 공개 호출 방식, 대표 반환 형태, 오류/제한 동작을 skill과 불일치한 채 방치하지 않는다.