주제별 자료 · 9강
closed-review로 동료심사 준비하기
Hermes, 관리하는 모델 서버, creview 실행 프로그램과 스킬을 구분하고 실습 환경을 확인합니다.
어떤 프로그램이 필요한가요
동료심사 소개를 먼저 읽어도 좋습니다. 이 레슨은 설치를 원하는 분을 위한 후속 실습입니다. closed-review 0.9.0.dev5의 공개 소스와 명령 정의를 기준으로 하며 실제 환경에서의 성공 여부는 아래 확인표로 점검합니다.
| 구성 | 하는 일 | 준비 기준 |
|---|---|---|
| 모델 서버 | 원고를 읽을 모델 실행 | 자신이 관리하는 컴퓨터 또는 사설망, 도구 호출 지원 |
| Hermes | 모델과 파일·터미널 도구 연결 | 위 서버와 모델을 선택한 프로필 |
| creview | 설정 검사, 기계적 검사와 기록 | Python 3.11 이상을 사용하는 실행 프로그램 |
| journal-article-review | 심사 대화의 절차 | Hermes에서 읽는 스킬 |
closed-review는 Claude Code나 Codex용 proof 명령을 그대로 옮긴 도구가 아닙니다. 이 레슨에서는 Hermes를 사용합니다. 모델 서버가 없다면 설치를 중단하고 가상 예제 읽기와 작성란으로 진행해도 됩니다.
1. 모델 서버와 Hermes를 맞춥니다
Hermes를 아직 설치하지 않았다면 공식 설치 안내에서 운영체제에 맞는 설치 방법을 확인합니다.
저장소의 모델 서버 안내에 따라 Ollama, LM Studio, llama.cpp 또는 vLLM 등 자신이 관리하는 서버를 준비합니다. 서버는 /v1/models, /v1/chat/completions와 도구 호출을 지원해야 합니다. 모델 이름만으로 도구 호출이나 원고 길이 처리가 보장되지는 않습니다. 메모리와 문맥 길이도 확인하십시오.
Hermes의 주 모델을 같은 서버로 지정합니다. 예를 들어 Ollama의 기본 주소는 http://localhost:11434/v1, LM Studio는 http://127.0.0.1:1234/v1입니다. 다른 컴퓨터의 서버라면 그 컴퓨터의 사설 주소를 씁니다. 인터넷에 공개된 서버를 실습용으로 열지 않습니다. 모델을 선택하고 서버를 실행하는 세부 화면은 해당 프로그램의 현재 안내를 따릅니다.
2. 실행 프로그램과 스킬을 준비합니다
Git과 uv가 필요합니다. uv는 Python 프로그램과 실행 환경을 설치하는 도구입니다. 이미 준비되었다면 일반 터미널에서 다음 명령을 한 줄씩 실행합니다. 첫 줄은 현재 폴더 아래에 저장소를 내려받습니다.
git clone https://github.com/junhewk/closed-review.git
uv tool install ./closed-review
creview --help
creview config detect
config detect는 서버 후보를 보여 주며 아직 저장하지 않습니다. 자신이 관리하는 서버와 모델인지 확인한 다음 저장하고 스킬을 설치합니다.
creview config detect --apply
creview hermes install --apply
creview hermes doctor
여러 모델 때문에 자동 선택할 수 없다면 creview config detect --model "실제 모델 이름" --apply를 사용합니다. 이름은 서버의 실제 목록에서 확인합니다. 이름을 추측해 넣지 않습니다. 이름 있는 Hermes 프로필을 사용하면 detect, install, doctor에 같은 --profile "프로필 이름"을 붙입니다.
이 레슨은 스킬을 복사하는 설치 방식을 사용합니다. 저장소의 skills.external_dirs 방식을 이미 쓰는 분은 같은 스킬을 중복 설치하지 말고 설치 안내의 해당 경로를 유지합니다. /learn은 유지되는 스킬을 설치하는 명령이 아닙니다.
| 막힌 곳 | 다음 확인 |
|---|---|
uv 또는 creview를 찾지 못함 | 설치와 PATH를 확인하고 터미널을 새로 엽니다 |
| 서버를 찾지 못함 | 서버 실행 상태, 주소, 모델 선택을 확인합니다 |
| doctor 실패 | 주 모델뿐 아니라 보조·대체 경로와 스킬 버전도 오류대로 확인합니다 |
| Desktop에 스킬이 안 보임 | 터미널·파일 도구를 켜고 완전히 종료한 뒤 다시 엽니다 |
doctor 실패를 건너뛰지 않습니다. 원격 Hermes를 쓰면 실행 프로그램과 스킬은 원격 호스트의 활성 프로필에 있어야 합니다. Windows의 보관 위치와 업데이트 방법은 저장소의 운영체제별 안내를 확인합니다.
3. 가상 원고로 시작합니다
manuscript.md를 실습 폴더에 저장합니다. 이 파일은 교육용으로 만든 가상 원고이며 실제 연구나 제출 자료가 아닙니다. Hermes에서 다음 스킬을 먼저 열고, 설정 검사와 사용 범위 확인 뒤 파일을 지정합니다.
/journal-article-review
교육용 가상 원고로 연습합니다. 실제 학술지 심사가 아닙니다.
먼저 설정을 확인하고, 원고를 읽기 전에 필요한 확인을 물어봐 주세요.
외부 조회는 제가 요청 문구를 확인하고 승인하기 전에는 실행하지 마세요.
스킬은 원고를 읽기 전에 creview session start를 실행합니다. 설정 검사가 통과하면 가상 원고임을 본인의 말로 답하고 파일을 제공합니다. 이번 준비 단계에서는 요약과 다음 확인 질문이 나오는지 확인합니다. 다음 레슨에서 설계와 검토 범위를 정합니다.
검사 통과가 보장하지 않는 것
doctor는 Hermes 프로필의 모델 경로와 스킬의 보호 지침을 검사합니다. 에이전트의 모든 터미널 통신을 운영체제 수준에서 차단하지는 않습니다. 모델 서버의 보관 정책, 다른 사용자 접근, 실제 학술지 허용 여부는 따로 확인합니다. 실습을 위해 실제 비공개 원고를 이 사이트의 작성란에 넣을 필요는 없습니다.
직접 해 보기약 10분
설치했다면 명령 결과를 기록하고, 설치하지 않았다면 각 구성의 역할과 준비할 일을 적습니다. 키나 서버 인증 정보는 기록하지 않습니다.
| 준비 항목 | 확인 결과 | 남은 일 |
|---|---|---|
1행
2행
3행
4행
작성란은 이 브라우저에 저장됩니다. 내려받기 버튼으로 Markdown 파일을 보관하십시오. 공개 게시판에는 가상 실습 자료에 대한 질문만 올리고 비공개 심사 원고나 심사 기록은 올리지 않습니다.
연구에 적용하면
준비의 기준은 프로그램을 내려받은 것이 아니라 같은 모델 경로와 스킬을 확인한 것입니다. 검토 범위와 원고 요약으로 이어 갑니다.