# 오케스트레이션 리팩터링 (orch-refine-code)

> 테스트 통과를 확인하고 동작을 바꾸지 않은 채 구조를 개선한 뒤, 리뷰를 거쳐 게이트를 두고 커밋합니다.

- 카테고리: [리팩터링](https://www.myskills.tools/ko/categories/refactoring/)
- 출처: 커뮤니티 · Affaan Mustafa
- 저장소: https://github.com/affaan-m/ECC/tree/main/skills/orch-refine-code (commit db7f2a6)
- SKILL.md: https://github.com/affaan-m/ECC/blob/main/skills/orch-refine-code/SKILL.md
- 설치 명령: `npx skills add affaan-m/ECC --skill orch-refine-code`
- 라이선스: MIT
- 호환 도구: Claude Code, Codex, Cursor, Copilot, OpenCode
- 권한: read-repo ✓, write-files ✓, shell ✓, network ✗
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.
- ⚠ 게이트 2 확인 후 git 커밋을 만들며, 정리 단계에서 죽은 코드를 삭제할 수 있습니다.

## 핵심 규칙

diff는 동작에 영향을 주지 않아야 하며, 동작이 조금이라도 바뀌어야 한다면 이 스킬을 쓰지 않습니다.

## 실행 단계

1. **테스트 통과 확인** — 코드를 건드리기 전에 관련 테스트가 있고 통과하는지 확인하며, 커버리지가 부족하면 특성 테스트를 먼저 추가합니다.
2. **리팩터링 계획** — orch-pipeline 엔진으로 재구성 계획을 세우고 게이트 1에서 멈춰 승인을 기다립니다.
3. **작은 단계로 재구성** — 작은 단계로 수정하고 매번 테스트를 다시 실행합니다. 죽은 코드·중복 정리는 refactor-cleaner 에이전트(knip, depcheck, ts-prune)에 맡깁니다.
4. **코드 리뷰** — 동작에 영향 없는 diff를 코드 리뷰합니다.
5. **게이트 커밋** — 게이트 2에서 멈춰 확인받은 뒤 refactor: 접두사로 커밋합니다.

## 권한 설명 (SKILL.md 기준)

| 기능 | 필요 여부 | 설명 |
|---|---|---|
| 파일 쓰기 | 필요 | 여러 파일에 걸쳐 코드를 재구성하고 필요하면 특성 테스트를 추가합니다. |
| 명령 실행 | 필요 | 테스트 스위트, knip/depcheck/ts-prune 같은 도구, git 커밋을 실행합니다. |
| 네트워크 송신 | 필요 없음 | 스킬은 네트워크 접근을 요구하지 않습니다. |

## SKILL.md 프런트매터(YAML)

```yaml
---
name: orch-refine-code
description: Orchestrate a behavior-preserving refactor — confirm tests are green, restructure without changing behavior, keep tests green, review, and gated commit. Use when the structure should improve but behavior must not change.
metadata:
  origin: ECC
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/orch-refine-code/