orch-refine-code은(는) 무엇을 하나요?
Actor · action · target: orch · refine · code. orch-pipeline의 공유 엔진을 간단히 감싸는 래퍼입니다.
사용 시기
- 동일한 동작, 더 나은 구조: 모듈 추출, 중복 제거, 데드 코드 제거, 중첩 줄이기, 명확성을 위한 이름 변경.
- 유사 스킬과의 구분: 동작이 조금이라도 변경되어야 한다면 이 스킬은 적합하지 않습니다 (
orch-change-feature/orch-fix-defect사용).
작업 설정
- 기본 크기 기준: standard — 여러 파일에 걸친 구조 변경을 수행합니다.
- 단계 마스크: 0 → 2 (구조 개선 계획) → 4 (초록색 유지) → 5 → 6. 새로운 동작 테스트는 작성되지 않으며, 기존 테스트 스위트가 안전망 역할을 합니다.
- 첫 번째 이동 (4단계): 코드를 수정하기 전에 관련 테스트가 존재하고 초록색인지 확인합니다. 테스트 범위가 얇다면 먼저 특성화 테스트를 추가합니다. 그런 다음 작은 단계로 리팩터링하고, 각 단계마다 테스트를 다시 실행합니다.
작동 방식
- 위 설정으로
orch-pipeline엔진을 실행합니다. - 데드 코드 / 중복 제거 작업의 경우
refactor-cleaner에이전트에 위임합니다 (knip / depcheck / ts-prune을 실행하고 안전하게 제거합니다). - 게이트 1 (구조 개선 계획)과 게이트 2 (커밋 전)에서 중단됩니다.
refactor:타입으로 커밋합니다. diff는 동작 중립적이어야 합니다.
예시
orch-refine-code: poller.py에서 NWS HTTP 클라이언트 추출
→ 테스트 초록색 확인 → 추출 계획 [게이트 1: 승인]
→ 작은 단계로 이동, 전체 과정에서 테스트 초록색 → 코드 검토
→ refactor: 커밋 [게이트 2: 확인]