HuggingFace router의 모델 목록과 chat-ui 설정을 비교해 미등록 모델을 조사합니다. 짧은 영어 설명을 작성하고 운영용·개발용 설정에 함께 추가합니다.
- 라우터의 새 모델을 추가할 때
- 모델 특징을 짧은 설명으로 정리할 때
- 운영용·개발용 모델 정보를 함께 갱신할 때
ruvnet/ruflo7.8만2026년 10월 21일 업데이트
무료GitHub에 공개한국어 소개
harness-similarity
에이전트 실행 구성과 평가값을 담은 두 JSON 데이터를 비교해 유사도와 세부 결과를 계산합니다. 구성 재사용 판단, 템플릿 비교, 구성 변화 확인에 활용합니다.
원문원문 설명 보기
ADR-152 — weighted similarity between two harness fingerprints (genome + score JSON). Returns overall score in [0,1] plus per-component breakdown (cosine over 9 numerics, categorical agreement over 4 enums, jaccard over agent_topology). Unblocks ADR-151 §3.2 Recommender, §3.3 Drift Detection, §3.5 Plugin Compat. Pure-TS, no `@metaharness/*` dep — preserves ADR-150's four architectural constraints.
이럴 때 유용합니다
- 기존 에이전트 구성의 재사용 여부 판단
- 템플릿 후보의 순위 결정
- 팀 사이의 중복 작업 확인
- 유사도 임계값으로 구성 변화 확인
한국어 소개
할 수 있는 일
harness-similarity는 에이전트 실행 구성을 나타내는 하네스의 특성 데이터와 평가값을 비교해 0에서 1 사이의 유사도를 반환합니다. 수치 아홉 항목, 분류 네 항목, 에이전트 구성의 공통 요소를 각각 60%, 25%, 15% 비중으로 합산합니다. 전체 유사도와 구성 요소별 세부 결과를 함께 확인할 수 있습니다.
이럴 때 유용합니다
기존 구성을 바탕으로 수정할지 새로 만들지 판단하는 데 활용합니다. 대상 저장소에 맞는 템플릿 후보의 순위를 정하거나 다른 팀이 만든 구성과 중복되는 작업을 확인할 때도 유용합니다. 유사도가 지정한 값보다 낮아지면 알림을 통해 구성 변화를 확인할 수 있습니다.
사용 예시
- “이 두 JSON의 유사도와 항목별 세부 결과를 보여 주세요.”
- “저장된 두 구성을 비교하고 유사도가 0.5 미만이면 알려 주세요.”
주의 사항
입력은 일반 문장이 아니라 하네스 특성과 평가값을 포함한 JSON 데이터여야 합니다. 파일이나 저장된 레코드의 키로 비교할 수 있습니다. ruflo CLI 또는 대응하는 MCP 도구를 사용합니다. 잘못된 입력에는 이유가 포함된 축소 결과와 종료 코드 2를 반환합니다. 추가 의존성 패키지나 @metaharness/* 불러오기는 필요하지 않습니다.
이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.
객관 평가
AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.
- 지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가
- A양호구성 재사용과 중복 확인이라는 용도 및 두 구성 특성을 비교하는 동작이 명시되어 있습니다.
- 절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가
- A양호가중 계산식, 입력 지정 명령, 세부 결과 예시와 잘못된 입력의 반환 결과가 제시되어 있습니다.
- 안전성전송·삭제·명령 실행 등을 명시하고 있는가
- A양호기재된 작업은 JSON 또는 저장된 레코드 비교이며 삭제나 외부 전송은 포함하지 않습니다.
- 도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가
- B일부 부족ruflo CLI와 MCP 사용법은 있지만 설치와 저장된 레코드 준비 절차는 기재되어 있지 않습니다.
총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 21일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.
평가가 다르다고 생각되면 재검토를 요청하기
포함된 파일(1)
- SKILL.md3.4 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
Surfaces the production similarity function from scripts/_similarity.mjs as a callable skill. Use when an agent needs to:
- decide whether to fork an existing harness vs scaffold a new one
- rank candidate templates against a target repo's genome
- diff two harnesses produced by different teams to find duplicate work
- generate the confidence number that ADR-151 §3.2's Recommender wraps
Algorithm (from ADR-152 §Decision)
overall = 0.60·cosine + 0.25·categorical + 0.15·jaccard
- cosine — over a 9-dim numerical vector of normalized scorecard + genome dims
- categorical — fraction of 4 enum fields that match (
repo_type,archetype,template,recommendedMode) - jaccard —
|A ∩ B| / |A ∪ B|over theagent_topology[]array
The 3-component design is load-bearing: numerical cosine alone is too coarse (the iter-35 spike showed LEGAL vs DEVOPS at cosine=0.97 despite being unrelated verticals). Categorical + jaccard pull the composite to the correct ordering.
Reference outputs (iter-35 spike fixtures)
| Pair | overall | cosine | categorical | jaccard |
|---|---|---|---|---|
LEGAL × LEGAL (self) | 1.0000 | 1.0000 | 1.0000 | 1.0000 |
LEGAL × SUPPORT | 0.8296 | 0.9987 | 0.7500 | 0.2857 |
LEGAL × DEVOPS | 0.5840 | 0.9734 | 0.0000 | 0.0000 |
Both invariants from ADR-152 §"Smallest demonstrable spike" hold:
similarity(X, X) === 1exactlysimilarity(LEGAL, DEVOPS) < similarity(LEGAL, SUPPORT)(vertical affinity)
Architectural constraint inheritance (ADR-150)
- Removable — pure-TS function, zero static
@metaharness/*imports. - Optional — no new dep in
package.json. - Graceful — malformed inputs emit
{ degraded: true, reason }with exit code 2; never throws. - CI-gate — smoke step 17y locks the contract: module exports, spike fixtures reproduce, CLI dispatcher entry registered, MCP tool registered.
Usage
# File inputs
npx ruflo metaharness similarity --a a.json --b b.json
# Memory inputs (records persisted by oia-audit.mjs)
npx ruflo metaharness similarity --a-key harness-X --b-key harness-Y
# Per-dimension breakdown (used by ADR-151 §3.2 Recommender)
npx ruflo metaharness similarity --a a.json --b b.json --per-dimension
# Alert when too-dissimilar (used by ADR-151 §3.3 Drift Detection)
npx ruflo metaharness similarity --a a.json --b b.json --alert-below 0.5
Implementation
Production module: scripts/_similarity.mjs
CLI skill: scripts/similarity.mjs
MCP tool: mcp__plugin_ruflo-core_ruflo__metaharness_similarity (registered in v3/@claude-flow/cli/src/mcp-tools/metaharness-tools.ts)
Spike anchor: scripts/_spike-similarity.mjs (regression suite — invariants locked here)
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
기술 선택과 설계 판단을 기록하는 ADR을 기존 파일에 이어지는 번호로 만듭니다. 템플릿 생성, AgentDB 등록과 관련된 과거 결정의 연결을 처리합니다.
- 기술 도입 이유 기록
- API나 데이터 모델 변경 기록
- 인프라 구성 결정 문서화
ruvnet/ruflo7.8만2026년 10월 21일 업데이트
설계 결정과 이유를 기록한 ADR을 읽어 검색 색인과 의존 관계 그래프를 만들고 갱신합니다. 두 문서 형식을 지원하며 참조와 상태의 불일치도 집계합니다.
- 다른 프로젝트의 ADR을 가져온 뒤 색인 생성
- 파일과 관계 그래프 동기화
- 기존 코드베이스에서 ADR 관리 시작
ruvnet/ruflo7.8만2026년 10월 21일 업데이트
삭제한 ADR 설계 결정 기록이나 관계 정보가 색인에 남았을 때 전체 삭제 후 재구축합니다. 현재 파일 수와 등록 수를 대조하며, 변경 없이 작업 내용을 미리 확인할 수 있습니다.
- ADR 파일을 삭제한 뒤 색인을 재구축할 때
- ADR 관계 삭제 후 남은 정보를 정리할 때
- ADR 색인을 정기적으로 맞출 때
ruvnet/ruflo7.8만2026년 10월 21일 업데이트
코드 변경 사항을 채택된 설계 결정을 기록한 ADR과 대조합니다. 결정 위반, 오래된 기록 참조, 관련 기록이 없는 변경을 정리하고 코드 수정이나 결정 재검토를 제안합니다.
- PR 병합 전 설계 결정 확인
- 대규모 변경과 설계 결정 대조
- 대체된 ADR을 참조하는 코드 검색
ruvnet/ruflo7.8만2026년 10월 21일 업데이트
저장된 아키텍처 결정 기록인 ADR의 관계를 검증해 끊어진 참조, 대체 관계의 순환, 상태 불일치를 보고합니다. 가져오기 후나 출시 전 점검에 활용합니다.
- ADR 가져오기 후 일관성 확인
- 지속적 통합에서 불일치 탐지
- 출시 전 저장된 ADR 데이터 점검
ruvnet/ruflo7.8만2026년 10월 21일 업데이트