# 벤치마크 최적화 루프 (benchmark-optimization-loop)

> 속도 개선 요청을 기준선 측정, 단일 가설 변형, 정확성 게이트 평가로 이루어진 제한된 측정 루프로 바꿉니다.

- 카테고리: [성능 최적화](https://www.myskills.tools/ko/categories/performance/)
- 출처: 커뮤니티 · Affaan Mustafa
- 저장소: https://github.com/affaan-m/ECC/tree/main/skills/benchmark-optimization-loop (commit 0765f7a)
- SKILL.md: https://github.com/affaan-m/ECC/blob/main/skills/benchmark-optimization-loop/SKILL.md
- 설치 명령: `npx skills add affaan-m/ECC --skill benchmark-optimization-loop`
- 라이선스: MIT
- 호환 도구: Claude Code, Codex, Cursor, Copilot, OpenCode
- 권한: read-repo ✓, write-files ✓, shell ✓, network ✗
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.

## 핵심 규칙

최적화 대상, 정확성 게이트, 지표, 기준선, 탐색 예산이 정해지기 전에는 최적화하지 않습니다.

## 실행 단계

1. **기준 조건 정의** — 최적화할 작업, 계속 통과해야 할 정확성 게이트, 지표, 현재 기준선, 변형 수·시간·비용·데이터 영향 한도를 정합니다.
2. **측정 및 병목 파악** — 기준선을 측정하고 추측이 아닌 근거로 병목을 찾습니다.
3. **변형 생성·실행** — 각 변형은 가설 하나만 검증하고 같은 입력 형태로 실행해 표에 기록합니다. 재귀 탐색에서는 모든 실행을 원장에 남기고 이전 채택안과 비교합니다.
4. **게이트 통과 시 채택** — 정확성·안전성·재현성을 통과하지 못한 변형은 버리고, 테스트 통과, 개선 재현, 쉬운 롤백이 확인될 때만 가장 빠른 안전한 변형을 채택합니다.
5. **정착 및 재확인** — 채택안을 스크립트, 명령, 테스트, 설정, 문서에 반영하고 기준선과 채택안을 다시 실행해 차이를 확인한 뒤 정확한 명령과 측정값을 보고합니다.

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

| 기능 | 필요 여부 | 설명 |
|---|---|---|
| 파일 쓰기 | 필요 | 코드를 수정하고 채택안을 스크립트, 테스트, 설정, 문서에 반영합니다. |
| 명령 실행 | 필요 | 기준선과 각 변형의 벤치마크, 정확성 테스트를 실행합니다. |
| 네트워크 송신 | 필요 없음 | 스킬은 네트워크 접근을 요구하지 않습니다. |

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

```yaml
---
name: benchmark-optimization-loop
description: Convert 'make it faster' requests into a bounded measured optimization loop — baseline first, generate one-hypothesis variants, benchmark each against a correctness gate, and promote the fastest safe variant with reproducible commands. Use when asked to speed something up, try many variants, run recursive optimization, benchmark latency/throughput/cost, or pick the best implementation by repeated measured tests.
license: MIT
metadata:
  origin: ECC
tools: Read, Write, Edit, Bash, Grep, Glob
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/benchmark-optimization-loop/