Memory와 Skills는 서로 다른 종류의 지속성을 다룹니다. Memory에는 세션이 바뀌어도 유지할 사실을 남깁니다. Skill에는 같은 유형의 작업에서 다시 쓸 절차를 둡니다. 둘을 섞으면 사용자 맥락이 지시문 더미가 되고 절차를 검토하기도 어려워집니다.
- 안정적인 사실과 선호는 Memory에 둡니다.
- 반복 가능한 단계, 검사, 안전 경계는 Skill에 둡니다.
- Skill은 도구 사용에 영향을 줄 수 있으므로 설치 전에 읽어봅니다.
- 두 저장소 어디에도 자격 증명을 넣지 않습니다.
1. 경계 정하기
“이 사실을 기억해”라는 문장으로 자연스럽게 이어지는지 보면 됩니다. 선호 언어나 저장소 규칙처럼 오래 유지할 사실이라면 Memory가 맞습니다. 검색·비교·실행·확인 같은 동작으로 시작한다면 Skill로 작성하세요.
Hermes에는 기본 USER.md와 MEMORY.md가 항상 있습니다. 외부 memory provider는 선택 사항입니다. hermes memory status는 기본 파일을 대체하지 않고 현재 provider 구성을 보여줍니다.
hermes memory status
hermes skills list2. 검토 가능한 절차 만들기
Skill은 SKILL.md를 진입점으로 쓰는 디렉터리입니다. description에는 언제 이 Skill을 적용하는지 적습니다. 본문에는 다른 세션도 따라갈 수 있도록 작업 순서, 합격 조건, 승인 경계를 명확히 둡니다.
이 장의 fixture에는 짧은 조사 절차가 있습니다. 안전 섹션은 외부 쓰기 전에 승인을 요구합니다. 워크플로 실행 방식을 제어하는 규칙이므로 절차와 같은 곳에 두는 편이 맞습니다.
3. 설치 전에 검사하기
저장소 루트에서 fixture를 실행합니다.
python3 examples/chapter-05-memory-skills/validate_workflow.py
python3 -m unittest discover -s examples/chapter-05-memory-skills/tests -v첫 명령은 Memory schema와 Skill 계약을 검사합니다. 테스트는 두 파일을 일부러 바꿉니다. Memory에 지시를 넣습니다. 승인 문장을 지우거나 알 수 없는 필드를 추가하기도 합니다. 모든 변조는 실패해야 합니다.
PASS: memory facts and research skill have separate, safe responsibilities4. 활성 profile에 설치하기
Hermes profile은 서로 다른 home을 사용합니다. 검토한 Skill을 복사하기 전에 활성 profile을 확인하세요. HERMES_HOME이 설정된 환경이라면 더 중요합니다. Markdown 파일 하나가 아니라 Skill 디렉터리 전체를 $HERMES_HOME/skills/ 아래에 둡니다.
registry 자료는 hermes skills inspect로 먼저 살펴봅니다. 설치된 Skill은 hermes skills audit으로 검사할 수 있습니다. 저장소 로컬 Skill에는 명시적인 project trust가 필요합니다. 임의의 checkout이 지시를 조용히 추가하지 못하게 하는 경계입니다.
5. fixture가 보장하는 범위 알기
예제가 증명하는 범위는 좁습니다. 안정적인 사실은 선언형으로 남습니다. Skill에는 활성화 description과 승인 규칙이 있습니다. 잘못된 변조는 실패합니다. 조사 결과의 정확성을 보장하거나 Skill을 설치하거나 실제 Memory를 바꾸지는 않습니다.
Memory는 간결하게 유지하세요. Skill은 실행 의미가 분명하고 감사하기 쉬워야 합니다. 부작용도 명시해야 합니다. 절차가 달라지면 Memory에 설명을 덧붙이지 말고 Skill을 고친 뒤 테스트를 다시 실행하는 편이 낫습니다.
답글 남기기