generative-output-diversity-gate

생성기가 같은 것을 반복해 내놓지 않게, 한 가지가 아니라 여러 축에서 다양성을 재는 게이트입니다.

GitHub에서 보기View on GitHub

어떤 문제를 푸나The problem

측정하지 않는 것은 결국 수렴합니다. 규칙 종류만 중복 검사하던 파이프라인에서도 새 결과물은 같은 시작 화면, 같은 세션 형태, 같은 레이아웃을 공유했습니다.

축과 값의 어휘, 이미 나온 결과의 목록, 새 후보를 입력하면 후보가 기존 결과와 같은 조합이거나 한 축에서 지나치게 한쪽으로 쏠리는지 판단하고, 다음에 고르면 좋은 안 쓴 값을 알려 줍니다.

이런 분께 맞습니다Who it is for

게임·콘텐츠·이미지처럼 비슷한 결과물을 대량 생산하는 자동 파이프라인을 운영하는 사람.

무엇을 하나What it does

• 선언하지 않은 축이나 어휘에 없는 값은 새 값이 아니라 오류로 거절합니다.
• 이미 같은 조합이 나온 후보는 막습니다.
• 새 후보가 들어가면 한 축의 한 값이 전체의 --max-share(기본 60%)를 넘는 경우 쏠림으로 판정합니다.
• 다음에 고를 만한 안 쓴 값을 알려 줍니다.
• 어휘가 비어 있거나 입력 형태가 틀리면 종료 코드 2로 거부합니다.

직접 돌려 본 출력Real output

저장소의 examples 폴더를 실행한 결과입니다.

$ bash examples/demo.sh
# The registry already has four items that differ only in rule_family.
# A candidate with a fresh rule but the same shape is a monoculture:
$ python3 scripts/axes_gate.py examples/candidate-monoculture.json --vocab examples/vocab.json --registry examples/registry.json --primary rule_family
unused values (prefer these next): {"oracle": ["dataset", "measurement"], "session": ["daily-set", "run-attempt"], "surface": ["canvas", "side-stage"], "rule_family": ["timing"]}
monoculture: 'constraint' would cover 5/5 on axis 'oracle' (max 60%); pick a less-used value
monoculture: 'stage-journey' would cover 5/5 on axis 'session' (max 60%); pick a less-used value
monoculture: 'grid' would cover 5/5 on axis 'surface' (max 60%); pick a less-used value
[exit 1]

# A candidate that differs on the other axes passes:
$ python3 scripts/axes_gate.py examples/candidate-diverse.json --vocab examples/vocab.json --registry examples/registry.json --primary rule_family
unused values (prefer these next): {"oracle": ["dataset", "measurement"], "session": ["daily-set", "run-attempt"], "surface": ["canvas", "side-stage"], "rule_family": ["timing"]}
ok: candidate adds diversity
[exit 0]

알아둘 한계Limits

• 선언한 축만 잽니다. 선언하지 않은 축에서는 여전히 수렴할 수 있습니다.

받아서 쓰기Get it

# 저장소를 받습니다
git clone https://github.com/Kein-chronicle/generative-output-diversity-gate.git

# Claude Code 스킬로 쓰려면 이 폴더 이름으로 받습니다
git clone https://github.com/Kein-chronicle/generative-output-diversity-gate.git ~/.claude/skills/diversity-axes-gate

정보Info

분류Category

검증과 게이트Review gates

형태Type

명령줄 도구Command-line tool

라이선스License

MIT

필요한 것Requires

Python 3.10 이상

저장소Repository

generative-output-diversity-gate

토픽Topics

generative-ai quality-gates diversity ai-agents claude-code claude-skills agent-skills pipeline

2026-10-18 기준: 저장소의 테스트를 로컬에서 실행해 통과했고, 예제 출력은 저장소의 examples 폴더를 실제로 실행한 결과입니다.