virtual-insanity
← 리포트 목록

Hermes architecture-diagram 스킬 적용

2026-04-16 hermes [hermes, architecture-diagram, skill, telegram]

결론

Teknium X 공지의 /architecture-diagram <prompt> 스킬을 로컬 Hermes에 적용했다.

적용 내역

  • upstream origin/main에서 스킬 파일만 추출해 로컬 프로필 스킬에 설치
  • ~/.hermes/skills/creative/architecture-diagram/SKILL.md
  • ~/.hermes/skills/creative/architecture-diagram/templates/template.html
  • 기존 ~/.hermes/hermes-agent는 로컬 수정이 많고 origin/main보다 1010 commits behind라 전체 git pull은 하지 않음.
  • agent/skill_commands.py의 slash command 목록 캐시를 매 호출 재스캔하도록 보강
  • 목적: gateway 실행 중 새로 설치한 /architecture-diagram이 stale cache 때문에 누락되지 않게 함.
  • Gateway 재시작 시도 완료
  • Telegram platform은 polling conflict 1회 후 resumed.
  • API server port 8642는 기존 Python listener가 점유 중이라 새 프로세스에서는 연결 실패. 기존부터 있던 상태이며 이번 스킬 적용과 별개.

검증

  • get_skill_commands() 결과: /architecture-diagram 존재 확인
  • build_skill_invocation_message('/architecture-diagram', ...): message build 성공, 5519자
  • skill_view('architecture-diagram'): 성공, 5025자
  • skill_view('architecture-diagram', 'templates/template.html'): 성공, 12451자
  • py_compile agent/skill_commands.py: 통과
  • Gateway log: Connected to Telegram, Gateway running with 1 platform(s), Telegram polling resumed after conflict retry 1

사용법

Telegram/Hermes에 아래처럼 입력:

/architecture-diagram OpenClaw gateway + Hermes cron + Telegram report topic 구조를 그려줘

결과는 HTML/SVG 파일로 생성되는 스킬이다.

남은 주의

  • API server 8642 포트는 기존 Python 프로세스가 점유 중이다. Telegram 명령 사용에는 영향이 없지만, API surface를 새 프로세스로 완전히 교체하려면 별도 정리가 필요하다.

관련 노트

  • [[260324_report_원자력_산업_제이피모건_c13b58]] -- Hermes 스킬 적용
  • [[260416_gbrain_hermes_readonly_apply]] -- 헤르메스 구조
  • [[260416_hermes_initial_operating_setup]] -- Hermes 아키텍처 및 스킬 정의