Hermes 스킨 유지보수

Hermes 스킨 유지보수은(는) 무엇을 하나요?

이 스킬을 사용하여 기존 Hermes 스킨을 감사, 확장 또는 수정하면서 CLI, TUI, 데스크톱 앱 전반에서 시각적 특성을 유지합니다.

권한 및 범위

• 표준 크로스-서피스 색상 계약은 Hermes Agent 저장소의 apps/shared/src/skin.ts 파일에 있는 SKIN_COLOR_TOKENS입니다. 사용자가 요청한 브랜치 또는 수정본이 지정되지 않은 경우 main 브랜치에서 원시 파일을 가져옵니다.
• 스킨에는 레거시 또는 특수 키가 포함될 수 있지만, 토큰 적용 범위는 표준 목록에 대해서만 측정해야 합니다. 표준 목록에 없다고 해서 호환 가능한 추가 키를 삭제하지 마십시오.
• 활성 Hermes 홈 디렉토리는 $HERMES_HOME 환경 변수에서 확인하고, 설정되지 않은 경우 ~/.hermes를 사용합니다. config.yaml 파일을 직접 편집하지 마십시오.

절차

1. 사용 가능한 경우 Hermes 테마 가이드를 로드하고 대상 스킨 YAML을 검사합니다.
2. SKIN_COLOR_TOKENS를 가져와서 구문 분석합니다. 이전 템플릿에서 목록을 유추하지 마십시오.
3. 스킨의 colors 매핑에서 누락된 키를 프로그래밍 방식으로 계산합니다.
4. 표준 키 중 누락된 것만 추가합니다. 기존 값은 유지하고 새 색상은 관련 없는 색조를 임의로 만들지 말고 의미론적 패밀리별로 할당합니다:
   • background: 기존 스킨에 어울리는 어둡거나 밝은 기본 배경입니다.
   • primary/text/border: 기존 제목, 본문 및 구조 팔레트를 재사용합니다.
   • tool/thinking: 의도적인 대비 구분이 없는 한 스킨의 강조 및 보조 레이블 색상을 상속합니다.
   • diff/status/syntax: 긍정→ok, 경고/숫자→warn, 부정→error에 매핑합니다. 단어 수준 diff 및 중요한 상태에는 약간 더 강한 음영을 사용합니다.
   • terminal chrome: 프롬프트/강조/텍스트 계층을 일관되게 재사용합니다.
5. 모든 값은 따옴표로 묶인 여섯 자리 #rrggbb 색상으로 유지합니다.
6. YAML의 유효성을 검증하고 모든 표준 토큰이 이제 존재하는지 확인합니다.
7. hermes config set display.skin <name> 명령어로 편집된 스킨을 적용하고 hermes config get display.skin 명령어로 다시 읽어온 후 성공을 보고합니다.

확인 체크리스트

다음 항목을 정확히 보고하십시오:

• 대상 파일 경로와 포함된 스킨 name이 일치합니다.
• YAML이 성공적으로 구문 분석됩니다.
• 가져온 표준 SKIN_COLOR_TOKENS에 대해 missing_tokens=none입니다.
• 활성 스킨이 적용 후 대상 이름과 일치합니다.

주의사항

• 스킨의 기존 팔레트가 의도적으로 background를 생략할 수 있습니다. 안정적인 데스크톱/TUI 기본 표면 렌더링을 위해 추가하는 것이 여전히 필요합니다.
• status_bar_bad와 status_bar_critical은 서로 다릅니다. 이전의 더 작은 템플릿 팔레트에 멈추지 마십시오.
• 동일 세션에서 구성된 모델 제공자를 변경할 때 OAuth 제공자를 선택한 후 상속된 사용자 정의 model.base_url을 제거하십시오. 그렇지 않으면 이전 로컬 엔드포인트가 구성에 남을 수 있습니다. 마이그레이션 완료를 선언하기 전에 선택한 제공자의 인증 상태를 확인하십시오.
• 번들로 제공되거나 사용자가 소유한 Hermes 스킬을 수정하지 마십시오. 대신 큐레이터가 관리하는 동반 스킬을 생성하거나 업데이트하십시오.