← 보드로 돌아가기

SaehwanPark/meta-harness

Codex-native meta-skill that designs domain-specific & specialized agents and generates the skills they use.

GitHub에서 열기 ↗
120
GitHub 스타
6
포크
Python
언어
Apache-2.0
라이선스
2026.04.11
최근 푸시
2026.05.27
별표한 날

AI 분석

설치 난이도: 쉬움
큐레이터 노트
도메인별 워크플로우와 전문가 에이전트를 설계해야 하는 프로젝트에 적합하며, 특히 여러 AI 에이전트 간의 협업이 필요한 환경에서 유용합니다.

강점

  • 표준 우선 접근법으로 일관된 저장소 구조와 재사용성을 보장합니다.
  • 다양한 에이전트(Codex, Aider 등)와 호환되는 런타임 중립적 설계로 이식성이 뛰어납니다.
  • 설치 및 검증 스크립트를 제공하여 초기 설정과 유지보수를 자동화합니다.

약점

  • 문서가 많아 초기 학습 곡선이 있을 수 있습니다.
  • 아직 0.3 버전으로 초기 단계이며, 실제 사용 사례가 많지 않을 수 있습니다.

주의사항

  • 설치 시 `--layout` 옵션을 정확히 지정해야 하며, 잘못된 레이아웃은 예상치 못한 동작을 유발할 수 있습니다.
  • 생성된 SKILL.md 파일은 YAML frontmatter에 name과 description을 포함해야 하며, 이를 누락하면 스킬 검색이 실패할 수 있습니다.

시작 가이드

  • 저장소를 클론하고 설치 스크립트를 실행하여 기본 구조를 프로젝트에 적용해 보세요.
  • AGENTS.md와 SKILL.md를 읽고 워크플로우와 패턴을 이해한 후, 자신의 도메인에 맞는 아티팩트를 생성해 보세요.
  • 스타터 연구 예제를 참고하여 최소한의 하네스를 먼저 구축해 보세요.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Meta Harness

Meta Harness는 도메인별 워크플로우, 재사용 가능한 전문가 스킬, 결정론적 핸드오프 아티팩트를 설계하기 위한 이식 가능하고 표준 우선의 메타 스킬입니다.

현재 프로젝트 버전: 0.3. 체크포인트 기반 버전 기록은 Changelog를 참조하세요.

원본 Harness 프로젝트에서 각색되었으며, 동일한 Apache 2.0 라이선스로 배포됩니다.

추가된 기능

원본 Claude Code 기반 Harness와 비교하여 이 프로젝트는 다음을 추가합니다:

  • AGENTS.md, .agents/skills/, docs/harness/를 중심으로 한 표준 우선 저장소 레이아웃
  • 저장소 전체 WHAT / WHY / HOW와 점진적 공개를 기반으로 한 간결하고 사람이 작성한 AGENTS.md 가이드
  • 스킬, 팀 사양, 결정론적 _workspace/ 핸드오프를 기반으로 한 런타임 중립적 아티팩트 계약
  • 임시 모델별 복구 로직을 쉽게 제거할 수 있도록 유지하는 분리 가능한 하네스 설계 가이드
  • 프로젝트 수준 및 사용자 수준 스킬 설치를 위한 저장소 로컬 부트스트랩 설치 프로그램
  • 저장소 로컬 검증과 더 간단한 플랫폼 독립적 규칙을 통한 더 타이트한 유지 관리 루프

포함 내용

  • 분석, 아키텍처, 생성, 통합, 검증을 위한 6단계 워크플로우
  • 6가지 아키텍처 패턴: 파이프라인, Fan-out/Fan-in, 전문가 풀, 생산자-검토자, 감독자, 계층적 위임
  • 사용자 제어 컴퓨팅을 위한 자율 실험 워크플로우 프로필
  • .agents/skills/ 아래의 저장소 로컬 스킬
  • docs/harness/ 아래의 내구성 있는 출력 사양
  • 결정론적 _workspace/ 핸드오프 규칙
  • 작은 부트스트랩 설치 프로그램과 검증 및 스모크 테스트 스크립트

문서

  • 설치
  • 호환성 가이드
  • 샘플 프롬프트
  • 변경 로그
  • 하네스 출력 사양
  • 스타터 연구 예제
  • AGENTS 작성 가이드
  • 오케스트레이터 템플릿

저장소 레이아웃

meta-harness/
├── AGENTS.md
├──.agents/skills/harness/
│   ├── SKILL.md
│   └── references/
├── docs/harness/README.md
├── docs/harness/starter-research/
├── scripts/install_harness.py
├── scripts/test_install_harness.py
├── scripts/validate_codex_port.py
└── LICENSE

설치

프로젝트에 설치:

python3 scripts/install_harness.py --scope project --target /path/to/repo --layout standard

사용자 수준 공유 스킬로 설치:

python3 scripts/install_harness.py --scope user --layout standard

클라이언트별 미러 또는 후속 가이드가 필요한 경우 --layout forgecode, --layout droid, --layout openhands, 또는 --layout aider를 사용하세요. Codex가 공유 Harness 트리와 네이티브 .codex/skills/harness/ 미러를 모두 보도록 하려면 --layout codex를 사용하세요. Harness는 스킬 트리만 설치합니다. 대상 저장소는 자체 AGENTS.md, README.md, 문서의 소유권을 유지합니다. 경로 매핑 및 에이전트별 후속 조치는 호환성 가이드를 참조하세요.

사용법

  1. AGENTS.md를 읽으세요.
  2. .agents/skills/harness/SKILL.md의 주요 스킬을 읽으세요.
  3. 대상 저장소에 내구성 있는 저장소 전체 가이드가 필요한 경우 AGENTS 작성 가이드에서 시작하고 AGENTS.md를 저장소 전체 WHAT / WHY / HOW로 제한하세요.
  4. 도메인에 맞는 가장 작은 내구성 있는 아티팩트 세트를 생성하세요:
  • .agents/skills/<domain>-orchestrator/SKILL.md
  • .agents/skills/<specialist>/SKILL.md
  • docs/harness/<domain>/team-spec.md
  • workspace/{phase}{role}_{artifact}.md

생성된 SKILL.md 파일은 네이티브 스킬 검색이 저장소별 생성 스킬을 안정적으로 선택할 수 있도록 최소한 name과 description을 포함하는 YAML frontmatter로 시작해야 합니다.

Harness에 적합한 요청:

이 저장소를 위한 재사용 가능한 연구 하네스를 구축해 줘.
명시적인 QA 핸드오프가 있는 검토 워크플로우를 설계해 줘.
이 도메인에 대한 전문가 스킬과 팀 사양을 정의해 줘.
고정된 메트릭과 결정론적 결과 원장을 가진 이 저장소를 위한 자율 실험 하네스를 설계해 줘.

워크플로우 및 패턴

주요 스킬은 6단계 워크플로우를 유지합니다:

  1. 도메인 분석
  2. 팀 아키텍처 설계
  3. 역할 및 아티팩트 정의 생성
  4. 스킬 생성
  5. 통합 및 오케스트레이션
  6. 검증 및 테스트

패턴 가이드는 .agents/skills/harness/references/agent-design-patterns.md에 있습니다. 출력 사양 규칙은 docs/harness/README.md에 있습니다. 짧고 항상 로드되는 저장소 계약이 필요할 때는 AGENTS 가이드를 사용하고, 진화하는 재시도 또는 복구 로직은 루트 파일 대신 분리 가능한 하네스 문서에 유지하세요. 내구성 있는 워크플로우 사양이 필요할 때는 오케스트레이터 템플릿에서 시작하거나, 구체적인 최소 패키지를 원할 때는 스타터 연구 예제를 적용하세요.

검증

python3 scripts/test_install_harness.py
python3 scripts/validate_codex_port.py

스모크 테스트는 프로젝트 및 사용자 범위에서 설치 프로그램을 확인합니다. 검증기는 필수 파일, README 링크, 짧은 AGENTS.md 계약, 주요 스킬 제목, 패턴 적용 범위, 표준 문서에서 제거된 런타임별 경로의 부재를 확인합니다.

라이선스

Apache 2.0

원본 저장소: SaehwanPark/meta-harness

라이선스: Apache-2.0

게재 제외를 원하시면 삭제 요청을 보내주세요.