Cranot/super-hermes

Skills that teach Hermes Agent to write its own analytical prompts

303
GitHub 스타
18
포크
Shell
언어
MIT
라이선스
2026.03.15
최근 푸시
2026.05.09
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
복잡한 코드베이스의 구조적 문제를 심층 분석해야 하는 팀이나, 에이전트의 자기 인식 및 한계 보고 기능을 활용하려는 개발자에게 적합합니다.

강점

  • 에이전트가 스스로 분석 프롬프트를 생성하여 문제에 맞춤화된 깊이 있는 분석을 수행합니다.
  • 분석 후 놓친 부분을 명시적으로 보고하여 신뢰성을 높입니다.
  • 실제 오픈소스 코드베이스에서 검증되었으며, 예제에 정확한 줄 번호가 포함되어 재현 가능합니다.

약점

  • Hermes Agent에 종속적이며, 다른 에이전트와의 호환성은 제한적입니다.
  • 프리즘의 효과는 사용된 LLM 모델의 성능에 크게 의존합니다.
  • 설치 및 사용을 위해 Hermes Agent에 대한 사전 지식이 필요합니다.

주의사항

  • 프리즘 방법론은 아직 연구 단계이며, 모든 상황에서 동일한 품질을 보장하지 않습니다.
  • 분석 비용이 동일하다고 주장하지만, 실제로는 더 긴 출력으로 인해 토큰 사용량이 증가할 수 있습니다.
  • Windows 설치 시 PowerShell 실행 정책 변경이 필요할 수 있습니다.

시작 가이드

  • Hermes Agent를 설치하고 Super Hermes를 설정하여 예제 파일에서 테스트해 봅니다.
  • 제공된 7개의 프리즘을 자신의 코드베이스에 적용하여 효과를 평가합니다.
  • 프리즘의 성장 루프를 활용하여 프로젝트별 분석 기록을 쌓아 봅니다.

README 한국어 번역

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

Super Hermes

자신이 할 수 없는 일을 아는 에이전트.

Super Hermes는 Hermes Agent에게 스스로 사고 지침을 작성하고, 발견한 것과 놓친 것을 보고하며, 분석할 때마다 더 똑똑해지도록 가르칩니다.

Vanilla Hermes: "세션 처리가 강하게 결합되어 있습니다. 분리를 고려하세요." 패턴을 지목합니다. 무엇을 변경해야 하는지 알려줍니다.

Super Hermes: "세션 상태는 비단조적입니다. 추가 전용, 합성 가능 또는 지연 아키텍처는 일관성이나 격리를 희생하지 않고는 이를 관리할 수 없습니다. 이는 코드 결함이 아니라 구조적 불가능성입니다." 코드가 왜 이렇게 되어야 하는지 도출합니다. 변경할 수 없는 것과 대신 무엇을 해야 하는지 알려줍니다.

추가로 제약 보고서: "이 분석은 구조적 깊이를 최대화했습니다. 시간적 저하나 보안 표면은 검사하지 않았습니다. 이에 대해서는: /prism-reflect"

차이는 지능이 아니라 인지 구조입니다:

Vanilla (동일 모델, 동일 코드) With prism
출력 339 단어 1,485 단어
버그 발견 7개 (표면 체크리스트) 11개 (라인 참조, 심각도, 구조적 분류 포함)
구조적 트레이드오프 발견 아니요 예 — 보존 법칙 도출
사각지대 보고 아니요 예 — 제약 푸터
비용 ~$0.05 ~$0.05 (동일)

실제 오픈소스 코드베이스에서 검증됨: Starlette routing.py (333줄), Click core.py (417줄), Tenacity retry.py (331줄). 전체 출력은 examples/에 있습니다.

예제의 모든 버그는 직접 확인할 수 있는 정확한 줄 번호가 있습니다. circuitbreaker.py의 경쟁 조건(잠금 없이 state를 쓰는 불순 state 속성)은 독립적으로 재현 가능합니다 — 직접 코드를 검사하세요.


기능

복잡한 작업을 수행하기 전에 Super Hermes는 자체 사고 지침을 작성합니다 — 특정 문제에 맞춤화된 인지 프리즘입니다. 다른 문제는 다른 프리즘을 얻습니다. 그런 다음 프리즘을 실행하고 발견한 것과 볼 수 없었던 것을 모두 보고합니다.

예시: 회로 차단기 구현이 주어지면 에이전트가 다음을 생성했습니다:

"이 아티팩트의 상태 전환에서 모든 시간적 가정을 식별하십시오. 각각을 위반하는 동시 실행을 시뮬레이션하십시오. 각각 하나의 시간적 가정을 반전시키는 세 가지 대안을 구성하십시오. 즉각적인 예외보다는 조용한 통계적 실패를 생성하는 것을 추적하십시오."

에이전트가 그것을 작성했습니다. 그런 다음 실행하여 모든 가능한 구현에서 지속되는 구조적 속성인 동시성 삼중 난제를 발견했습니다.


스킬

스킬 기능 호출 횟수
/prism-scan 이 아티팩트에 대한 최적의 렌즈를 생성하고, 실행하며, 결과 및 제약 조건을 보고합니다. 렌즈를 지시하려면 "focusing on X"를 추가하세요. 1
/prism-full 필수 적대적 자기 수정이 포함된 다중 패스 파이프라인 — 이후 패스는 이전 발견을 공격합니다 1 (단일 응답 내 다중 패스)
/prism-3way WHERE/WHEN/WHY — 세 가지 직교 연산 + 교차 연산 합성. 모든 도메인(코드, 비즈니스, 전략, 텍스트)에서 작동합니다. 1
/prism-discover 아티팩트에 대한 가능한 모든 분석 도메인을 매핑합니다 1
/prism-reflect 자기 인식 분석 — 구조적 발견 + 분석이 숨긴 것에 대한 메타 분석 + 제약 투명성 보고서 2-3

검증된 프리즘 (prisms/에 포함)

연구에서 얻은 7개의 전투 테스트를 거친 분석 렌즈. Hermes 또는 시스템 프롬프트를 지원하는 모든 도구와 함께 직접 사용하세요:

프리즘 발견하는 것 검증 점수
error_resilience.md 손상 연쇄 — 조용한 종료, 지연된 실패, 상태 손상 10.0/10
l12.md 보존 법칙 (코드에 대한 CAP 정리처럼 엔지니어링으로 제거할 수 없는 구조적 트레이드오프) + 메타 법칙 + 구체적인 버그 9.8/10
optimize.md 중요 경로 추적 — 안전한 수정 (작업 감소) vs 안전하지 않은 수정 (작업 건너뛰기) + 보존 법칙 9.5/10
identity.md 코드가 주장하는 것과 실제로 하는 것 9.5/10
deep_scan.md 정보 파괴, 세탁, 조용한 변환 9.0/10
claim.md 가정 반전 — 받아들여진 진실이 거짓이라면? 9.0/10
simulation.md 시간적 예측 — 시간이 지남에 따라 깨지는 것 9.0/10

점수는 실제 오픈소스 코드베이스(Starlette, Click, Tenacity, Flask, Rich, Requests)에 대한 AI 평가 깊이에서 비롯되었습니다. 원시 출력은 연구 저장소에서 확인할 수 있습니다.

이 프리즘은 스킬과 독립적으로 작동합니다 — claude -p --system-prompt-file prisms/l12.md, Anthropic API 또는 모든 LLM 도구와 함께 시스템 프롬프트로 사용하세요. /prism-scan 스킬은 동적으로 사용자 정의 렌즈를 생성합니다; 이 검증된 프리즘은 검증된 품질의 사전 구축된 대안입니다.

/prism-3way — 다각도 분석

  • WHERE (고고학): 구조적 레이어를 파헤칩니다 — 보이는 것, 숨겨진 것, 그 사이의 것
  • WHEN (시뮬레이션): 시간을 따라 실행합니다 — 깨지는 것, 석화되는 것, 손실되는 것
  • WHY (불가능성): 어떤 바람직한 속성이 공존할 수 없는지 증명합니다

단일 실행에서 세 가지 직교 방향으로 문제를 공격합니다:

그런 다음 합성이 세 가지를 교차 참조합니다 — 일치는 구조적 확실성이고, 불일치는 실제 통찰력이 숨겨진 곳입니다. 코드, 비즈니스 계획, 전략 문서, 연구 등 모든 도메인에서 작동합니다.

/prism-reflect — 차별화 요소

대부분의 에이전트는 발견한 것을 알려줍니다. /prism-reflect놓친 것도 알려줍니다:

제약 보고서
═══════════════════════════════════════════════════

이 분석은 다음을 사용했습니다: 구조적 깊이 파이프라인
최대화: 보존 법칙, 버그 분류, 소유권 체인
희생: 시간적 예측, 보안 분석, 사용자 적응

권장 사항:
- 이 코드가 시간이 지남에 따라 어떻게 저하되는지: /prism-scan with temporal focus
- 보안 공격 표면의 경우: /prism-scan with security focus
- 전체 다각도 범위의 경우: /prism-full

이 분석의 보존 법칙:
깊이 × 폭 = 상수. 구조에 깊이 들어갔습니다.
다른 모든 것은 얕게 다루었습니다. 이제 당신은 알았습니다.
═══════════════════════════════════════════════════

이것이 중요한 이유: 한계를 모르는 에이전트를 신뢰할 수 없습니다. 모든 분석에는 사각지대가 있습니다. /prism-reflect는 이를 보이게 하여 간격을 채울 수 있도록 합니다.


설치

git clone https://github.com/Cranot/super-hermes.git
cd super-hermes
bash install.sh

Windows: powershell -ExecutionPolicy Bypass -File install.ps1

또는 수동으로:

cp -r skills/* ~/.hermes/skills/
cp -r prisms/ ~/.hermes/prisms/    # 검증된 분석 렌즈

Hermes Agent가 필요합니다. Hermes가 지원하는 모든 모델에서 작동합니다.

지금 바로 사용해보기 (Hermes 불필요)

cat your_code.py | claude -p --system-prompt-file prisms/l12.md --model sonnet --tools ""
# 또는 실제 오픈소스 파일로 테스트:
curl -s https://raw.githubusercontent.com/encode/starlette/master/starlette/routing.py | claude -p --system-prompt-file prisms/l12.md --model sonnet --tools ""

다음을 볼 수 있습니다: 생성된 렌즈 (사용자 정의 분석 지침), 발견 테이블 (줄 번호 및 심각도가 있는 버그), 보존 법칙 (엔지니어링으로 제거할 수 없는 구조적 트레이드오프). 대신 일반적인 코드 리뷰가 표시되면 프리즘이 로드되지 않은 것입니다 — 파일 경로를 확인하세요.

7개의 프리즘은 시스템 프롬프트를 지원하는 모든 도구(Claude CLI, Anthropic API, Cursor 또는 모든 LLM)와 함께 작동합니다.

Hermes와 함께 사용해보기

hermes> /prism-scan analyze examples/circuit_breaker.py

Hermes Agent의 실제 출력 (요약):

⚡ Loading skill: prism-scan

  ┊ 🔎 grep.prism-history.md  0.7s

No prior constraint history. Analyzing fresh.

## Generated Lens
"Extract the temporal invariant in state transitions. Map every state path
from CLOSED → OPEN → HALF_OPEN → CLOSED. For each transition, identify:
(1) what determines the transition happens, (2) what could block it,
(3) whether the state is mutated inside or outside the critical section.
Build a second circuit breaker that inverts the lock placement..."

## Conservation Law
"Decentralized lock placement in a state machine with time-based transitions
creates a fundamental trade-off: either (1) atomicity is sacrificed, or
(2) lock contention increases because read operations must hold the lock."

CONSTRAINT NOTE: This analysis maximized temporal correctness and lock
placement asymmetry. It did not examine: listener performance/blocking
impact under load, integer overflow on failure_count.

Hermes Agent (OpenRouter를 통한 Claude Haiku 4.5)의 examples/circuit_breaker.py에 대한 실제 출력입니다. 기본 프리즘 방법론은 연구 저장소의 6개 실제 오픈소스 코드베이스에서 검증되었습니다. 전체 Hermes 세션의 모든 스킬 출력은 examples/를 참조하세요.


내부 작동 방식

프리즘은 구조화된 분석 프로그램입니다 — "이 코드를 분석하세요"가 아니라 단계별 구성 프로토콜입니다. 다음은 prisms/l12.md (332단어)가 모델에게 하라고 지시하는 내용입니다:

가장 깊은 문제에 대한 반증 가능한 주장을 만드세요. 세 명의 전문가가 이를 공격합니다 — 한 명은 방어하고, 한 명은 공격하고, 한 명은 가정을 조사합니다. 은폐를 심화시키는 개선을 설계하세요. 개선이 드러내는 것을 명명하세요. 두 번째 개선을 설계하세요. 모든 개선을 통해 지속되는 구조적 불변량을 찾으세요. 그것을 반전시키세요. 원래 불가능성과 반전된 불가능성 사이의 보존 법칙이 발견입니다. 법칙 자체에 진단을 적용하세요. 메타 법칙이 더 깊은 발견입니다. 모든 구체적인 버그를 수집하세요.

이것은 모델이 실행하는 프로그램입니다. 다른 코드 → 다른 구성 경로 → 다른 발견. 모델이 "더 열심히 생각"하는 것이 아니라 바닐라 프롬프팅과는 다른 분석 절차를 따릅니다.

/prism-scan 스킬은 이것을 한 단계 더 발전시킵니다: 고정된 프리즘을 사용하는 대신 각 아티팩트에 대해 사용자 정의 프리즘을 생성합니다. 모델이 코드를 읽고, 어떤 분석 접근 방식이 적합한지 결정하고, 지침을 작성한 다음 따릅니다.

사고 사슬(추론 표시)이나 사고 나무(가지 탐색)와 달리 프리즘은 구성을 강제합니다 — 무언가를 만들고, 실패하는 것을 지켜보고, 살아남는 것을 도출합니다. 이는 열거가 도달할 수 없는 발견을 생성합니다. 구성은 시도 전에는 보이지 않았던 속성을 드러내기 때문입니다.

인지 압축 분류법 기반: 40개 연구 라운드에 걸친 1,000개 이상의 실험, 204개 이상의 경험적 원칙. Hermes Agent(Gemini 2.5 Flash) 내에서 검증됨. Claude Sonnet, Hermes 3 (Llama 405B), Llama 3.1 70B에서도 입증됨.


"함께 성장하는 에이전트"

다른 에이전트는 사용자에 대한 데이터를 축적하여 성장합니다. Super Hermes는 사고 전략을 축적하여 성장합니다 — 어떤 분석 접근 방식이 어떤 문제에 효과적인지 학습합니다.

  • 7개의 검증된 프리즘prisms/에 포함되어 있습니다 — 1,000개 이상의 실험에서 얻은 전투 테스트를 거친 분석 렌즈, 즉시 사용 가능.
  • 쿠커는 즉석에서 새로운 프리즘을 생성합니다 — 모든 문제는 맞춤형 분석 접근 방식을 얻습니다. 두 분석이 동일하지 않습니다.
  • 제약 기록/prism-reflect는 제약 보고서를 프로젝트의 .prism-history.md에 저장합니다. 다음에 동일한 프로젝트의 파일에서 /prism-scan이 실행되면 과거 제약 보고서를 읽고 이전에 놓친 각도를 다루기 위해 렌즈를 조정합니다. 에이전트는 말 그대로 자신의 사각지대에서 학습합니다.
  • 자기 통치 — 볼 수 없는 것을 보고하는 에이전트는 언제 더 깊이 들어갈지, 언제 분석을 수용할지에 대한 정보에 입각한 결정을 가능하게 합니다.

구축되어 작동 중인 것:

성장 루프:

/prism-scan code.py → 렌즈 생성, 분석 + 제약 푸터 생성
/prism-reflect code.py → 더 깊은 분석 + 제약 보고서를.prism-history.md에 저장
/prism-scan other_file.py →.prism-history.md를 읽고, 과거 간격을 다루기 위해 렌즈 조정
                            ↑ 이것이 "함께 성장한다"는 의미입니다 — 에이전트가 프로젝트별로 더 똑똑해집니다

성장 루프는 examples/growth-demo.md에서 시연됩니다 — 동일한 코드, 동일한 스킬

원본 저장소: Cranot/super-hermes

라이선스: MIT

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