무료GitHub에 공개한국어 소개

harness-drift-from-history

저장된 감사와 현재 저장소의 새 감사를 명령 하나로 비교합니다. 구조 유사도가 지정한 임곗값보다 낮아지는 변화를 감지하고 비교 결과와 종료 코드로 알립니다.

원문원문 설명 보기

One-command drift detection. Composes audit-list + oia-audit + audit-trend into a single primitive — finds the most recent audit in `metaharness-audit` namespace, runs a fresh audit against the current repo, diffs them via ADR-152 §3.1 similarity, and alerts when structural distance crosses `--threshold`. Iter 53 of ADR-150 deep integration.

ruvnet/ruflo

AI 평가90점/ 100 설치 방법 보기

이럴 때 유용합니다

주간 감사 이후 구조 변화 확인
최소 7일 전 감사와 비교
구조 변화 감지를 CI 판정에 활용
JSON이나 표로 비교 결과 확인

한국어 소개

할 수 있는 일

과거 감사 결과와 현재 저장소를 비교하여 구조 변화를 감지합니다. 이력 조회, 새 감사 실행, 차이 비교를 명령 하나로 수행합니다. 구조 유사도가 지정한 임곗값보다 낮으면 알리고, 비교 결과는 JSON이나 표로 제공합니다.

이럴 때 유용합니다

개발자와 운영 담당자가 정기 감사 이후 저장소가 얼마나 달라졌는지 확인할 때 유용합니다. 기본적으로 가장 최근의 이력을 비교 기준으로 선택합니다. --baseline-since 7d를 사용하면 최근 7일간의 기록을 제외하고 선택합니다. 종료 코드로 변화 감지와 설정 오류를 구분하므로 CI 판정에도 활용할 수 있습니다.

사용 예시

“현재 저장소를 과거 감사와 비교하고 유사도가 0.95보다 낮으면 알려 주세요.”
“최소 7일 전의 감사를 기준으로 삼아 결과를 JSON으로 출력해 주세요.”

주의 사항

npx ruflo metaharness drift-from-history를 실행할 수 있는 환경과 metaharness-audit에 저장된 감사가 필요합니다. 이력이 없으면 종료 코드 2, 상위 metaharness를 사용할 수 없으면 3을 반환합니다. 변화를 감지하면 1, 유사도가 임곗값보다 낮지 않으면 0을 반환합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

객관 평가

AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.

지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가: A양호정기 감사 후 변화 확인이라는 용도와 이력 조회, 새 감사, 비교 동작을 명시합니다.
절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가: A양호다섯 단계 절차, 실행 명령, 비교 결과 예시와 종료 코드 0부터 3까지를 제시합니다.
안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호이력 조회, 현재 경로 감사와 비교로 범위를 한정하며 삭제나 인증 정보 조작은 없습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족ruflo와 감사 이력이 필요하지만 상위 metaharness의 설치 절차는 설명하지 않습니다.

총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 21일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(1)

SKILL.md2.5 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

The natural ops question after running oia-audit weekly is "did anything drift?" Before this skill, the answer required a three-step sequence:

npx ruflo metaharness audit-list --format json   # → pick a key by hand
npx ruflo metaharness oia-audit --format json > /tmp/curr.json
npx ruflo metaharness audit-trend \
  --baseline-key <picked-key> --current /tmp/curr.json \
  --alert-on-distance-below 0.95

This skill collapses it into one command:

npx ruflo metaharness drift-from-history --threshold 0.95

What it does

Lists records from metaharness-audit namespace via audit-list.mjs
Picks the most recent record by startedAt (or --baseline-since 7d skips anything newer than 7 days)
Runs a fresh oia-audit against the current path
Diffs the two via audit-trend, applying --alert-on-distance-below ${threshold}
Returns the structured drift report

Architectural constraint inheritance (ADR-150)

Constraint	How drift-from-history satisfies it
Removable	Pure subprocess composition over existing scripts — no new `@metaharness/*` import
Optional	If oia-audit reports `degraded:true`, this skill exits 3 with a degraded payload
Graceful	Empty audit history → exit 2 with hint to seed it; never crashes
CI-gate	Smoke step 17z16 anchors the dispatcher entry + subcommand listing

Exit codes

0 — similarity ≥ threshold (or threshold not crossed)
1 — drift detected: similarity < threshold (alert fired)
2 — config error (no history, audit-list failed)
3 — upstream metaharness absent (degraded payload returned)

Example

$ npx ruflo metaharness drift-from-history --threshold 0.95
# drift-from-history

Baseline:        audit-2026-06-16T22-58-47-840Z
Current:         2026-06-16T23:05:02.231Z

Structural similarity: 1 (near-identical)
Distance:              0

✓ similarity ≥ 0.95 — OK

Implementation

scripts/drift-from-history.mjs

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬