Communitygithub.com

벤치마크 최적화 루프

사용자가 속도 향상, 변형 시도, 반복 최적화, 레이턴시/처리량/비용 벤치마킹 또는 반복 측정 테스트를 통한 최적 구현 선택을 요청할 때 사용합니다.

벤치마크 최적화 루프란 무엇인가요?

이 스킬은 '20배 빠르게 만들어 줘' 또는 '50번 반복 최적화 시도'와 같은 요청을 체계적인 측정 루프로 변환하여 시스템을 실제로 개선할 수 있도록 설계되었습니다. 주요 AI 에이전트 플랫폼(Claude Code, Cursor, Codex 등)과 호환되며, 개발자가 성능 병목을 증거 기반으로 식별하고, 각 가설을 테스트하는 변형을 생성하며, 정확성과 안전성을 유지하면서 가장 빠른 변형을 채택할 수 있도록 지원합니다. 이 루프는 기준선 측정, 병목 식별, 변형 실행, 승격 게이트를 포함하여 반복 가능하고 측정 가능하며 예산 범위 내에서 최적화를 수행합니다. 주관적인 '최적'이라는 용어 대신 '최상의 측정된 안전 변형'과 같은 표현을 사용하여 신뢰성과 투명성을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/benchmark-optimization-loop

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

벤치마크 최적화 루프은(는) 무엇을 하나요?

이 스킬을 사용하여 "20배 빠르게 만들어 줘" 또는 "50번 반복 최적화"와 같은 요청을 실제로 시스템을 개선할 수 있는 경계가 있는 측정 루프로 변환하세요.

필수 기준

다음이 준비될 때까지 최적화하지 마세요:

  • 최적화 대상 작업
  • 반드시 통과해야 하는 정확성 검증 게이트
  • 메트릭: wall time, p95 레이턴시, rows/sec, 실행당 비용, 메모리, 오류율
  • 현재 기준선
  • 탐색 예산: 최대 변형 수, 최대 시간, 최대 지출, 최대 데이터 영향

사용자가 비현실적인 목표를 요청하더라도 야망은 유지하되 루프에 경계와 측정 가능성을 부여하세요.

루프

  1. 기준선을 측정합니다.
  2. 증거를 기반으로 병목 지점을 식별합니다.
  3. 각각 하나의 가설을 테스트하는 변형을 생성합니다.
  4. 동일한 입력 형태로 변형을 실행합니다.
  5. 정확성, 안전성 또는 재현성에 실패한 변형을 거부합니다.
  6. 가장 빠른 안전 변형을 승격합니다.
  7. 승리 경로를 스크립트, 명령어, 테스트, 설정 또는 문서에 코드화합니다.
  8. 기준선과 승리자를 재실행하여 차이를 확인합니다.

변형 테이블

다음과 같이 변형을 추적하세요:

변형 | 가설 | 명령어 | 시간 | 정확? | 비고
baseline | 현재 경로 | npm run job | 120초 | 예 | 안정적
batch-500 | 왕복 횟수 감소 | npm run job -- --batch 500 | 42초 | 예 | 승리자
parallel-8 | 워커 증가 | npm run job -- --workers 8 | 31초 | 아니요 | 속도 제한 발생

재귀적 탐색

재귀적 또는 하이퍼파라미터 작업의 경우:

  • 모든 실행을 원장에 지속적으로 기록합니다.
  • 이전 실행뿐만 아니라 이전에 승인된 승리자와 비교합니다.
  • 홀드아웃 또는 재생 검사를 유지합니다.
  • 개선이 노이즈 범위 내에 있거나, 정확성 검증이 실패하거나, 비용이 예산을 초과하거나, 탐색이 설명할 수 있는 변수보다 더 많은 변수를 변경하기 시작하면 중단합니다.

탐색 공간이 실제로 완전 탐색되지 않은 이상 "전역 최적" 대신 "최상의 측정된 안전 변형"과 같은 표현을 사용하세요.

승격 게이트

다음 조건이 충족될 때까지 변형을 새로운 기본값으로 설정할 수 없습니다:

  • 정확성 테스트 통과
  • 성능 차이가 반복되거나 설명됨
  • 롤백이 명확함
  • 변경 사항이 소스 제어 또는 내구성 있는 런북에 기록됨
  • 최종 요약에 정확한 명령어와 측정값이 포함됨

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

관련 스킬