Operation observed

Refactor Checklist — 대규모 rename / API 변경 6 단계

Refactor Checklist — 대규모 rename / API 변경 6 단계 운영 규칙을 Skill OS에서 확인하고 변경 전후 검증 게이트로 사용한다.

operation.refactorChecklist GitHub 원본

절차

실행 순서

  1. 1

    자동 게이트 — 사람이 빠뜨려도 막히는 안전망 기준을 확인한다.

  2. 2

    6 단계 점검 기준을 확인한다.

  3. 3

    1. src 변경 기준을 확인한다.

  4. 4

    2. tests 변경 기준을 확인한다.

  5. 5

    3. Skills/ 문서 변경 기준을 확인한다.

  6. 6

    공개 API 메서드/함수/클래스 rename (예: `c.review()` → `c.story()`)

  7. 7

    모듈 경로 이전 (예: `dartlab.engines.X` → `dartlab.providers.X`)

  8. 8

    폐기 (예: `c.docs.X` namespace → `c.show(topic)` 단일 진입)

  9. 9

    registry/dataclass 필드 rename, 변수/contextvar rename

예시

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

  • Refactor Checklist — 대규모 rename / API 변경 6 단계 규칙 확인
  • refactor-checklist 작업을 Skill OS에서 시작

출력

기대 결과

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

Skill OS 흡수 규칙

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

실행 순서

  • 자동 게이트 — 사람이 빠뜨려도 막히는 안전망 기준을 확인한다.
  • 6 단계 점검 기준을 확인한다.
    1. src 변경 기준을 확인한다.
    1. tests 변경 기준을 확인한다.
    1. Skills/ 문서 변경 기준을 확인한다.
  • 공개 API 메서드/함수/클래스 rename (예: c.review() → c.story())
  • 모듈 경로 이전 (예: dartlab.engines.X → dartlab.providers.X)
  • 폐기 (예: c.docs.X namespace → c.show(topic) 단일 진입)
  • registry/dataclass 필드 rename, 변수/contextvar rename

런타임

실행 환경별 호환성

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

실패 회피

흔한 실패 · 절대 금지

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