Communitygithub.com

harness-mini/harness-mini

CLI에 구애받지 않는 최소한의 에이전트 하네스 — 스킬, 하위 에이전트, 모범 사례 문서를 얇은 셸 글루로 결합합니다. 40% 스마트/덤프 컨텍스트 규칙과 단계별 에이전트 생애주기를 인코딩합니다.

harness-mini란 무엇인가요?

이 스킬은 CLI에 구애받지 않고 작동하는 최소한의 에이전트 하네스(harness)를 제공합니다. 핵심 스킬 집합, 하위 에이전트 관리 기능, 그리고 모범 사례로 압축된 문서를 얇은 셸 스크립트로 결합하여 에이전트의 효율적인 작업 수행을 돕습니다. 특히, 40% 스마트/덤프 컨텍스트 규칙을 적용하여 에이전트가 과도한 컨텍스트를 피하고 핵심 정보에 집중하도록 유도합니다. 또한, 단계별 게이트(Stage-Gated) 에이전트 생애주기를 구현하여 작업의 각 단계를 명확히 정의하고 제어함으로써 복잡한 워크플로우를 안정적으로 실행할 수 있도록 설계되었습니다. Claude Code, Cursor, Codex를 포함한 다양한 CLI 기반 에이전트 환경에서 활용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add harness-mini/harness-mini

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

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

문서

harness-mini은(는) 무엇을 하나요?

CLI에 구애받지 않는 최소한의 에이전트 하네스 — 스킬 + 하위 에이전트 + 얇은 셸 글루로 압축된 모범 사례 문서. 40% 스마트/덤프 컨텍스트 규칙과 단계별 에이전트 생애주기를 인코딩합니다.

개요

이 하네스는 복잡성을 줄이고 핵심 스킬에 집중할 수 있도록 돕습니다.

  • 스킬 집합: 일반적인 작업을 위한 사전 정의된 스킬 모음
  • 하위 에이전트: 복잡한 작업을 분할하여 관리
  • 모범 사례 문서: 경험에서 추출한 압축된 지침
  • 셸 글루: 모든 것을 통합하는 가벼운 스크립트

40% 스마트/덤프 규칙

에이전트가 처리하는 컨텍스트의 40%는 '스마트'(유용하고 실행 가능한 정보)여야 하고, 나머지는 '덤프'(단순 참조 데이터)여야 합니다. 이는 에이전트가 과부하되지 않도록 합니다.

단계별 생애주기

  1. 초기화(Init): 환경 설정 및 컨텍스트 로드
  2. 계획(Plan): 작업 분석 및 접근 방식 결정
  3. 실행(Execute): 계획된 단계 수행
  4. 검토(Review): 결과 확인 및 필요시 반복
  5. 완료(Complete): 최종 정리 및 학습

사용 예시

# 에이전트 하네스 실행
harness run "작업 설명"

요구 사항

  • 지원 CLI: Claude Code, Cursor, Codex 등
  • 운영 체제: Linux, macOS, Windows (WSL)

설치

저장소를 클론하고 기본 경로에 추가하세요:

git clone https://github.com/harness-mini/harness-mini.git
cd harness-mini
export PATH="$PWD/bin:$PATH"

라이선스

MIT

관련 스킬