중급 · 6/9강
작업 지시와 AI 사용 계획
입력 파일, 허용 범위, 산출물, 확인할 사람을 정하고 AI-USE-PLAN.md로 남깁니다. 원고 점검을 시작하기 전의 작업 지시입니다.
원고를 건네기 전에 정할 네 가지
‘이 원고를 좋게 고쳐 주세요’라고 요청하면 무엇을 고쳤을 때 성공인지 알기 어렵습니다. 맞춤법만 바꾸라는 것인지, 해석까지 바꾸라는 것인지, 새로운 인용을 찾으라는 것인지가 열려 있기 때문입니다.
이 레슨에서 말하는 작업 지시는 네 가지를 함께 적는 방식입니다. 입력 파일, 허용한 작업, 남길 산출물, 사람의 확인 지점입니다. 예전 레슨 제목의 ‘하네스 프롬프트’도 이처럼 작업의 틀을 함께 건넨다는 뜻으로 읽으시면 됩니다.
이 코스와 proof는 원고의 주장·해석·새 문장을 저자가 작성하는 범위를 선택했습니다. 모든 학술지가 AI의 모든 문장 작성 도움을 일률적으로 금지한다는 뜻은 아닙니다. ICMJE는 AI 사용 공개와 인간 저자의 책임을 요구합니다. 제출할 학술지의 구체적인 지침도 따로 확인합니다.
실습 원고에 건넬 요청
앞 레슨에서 준비한 proof-practice 폴더를 사용합니다. 아직 proof를 설치하지 않았다면 아래 작성란으로 계획을 먼저 만들 수 있습니다.
Claude Code에서 다음 요청을 입력합니다. Codex에서는 첫 줄을 $ai-use-plan으로 바꿉니다.
/proof:ai-use-plan
이 폴더의 manuscript.md는 오류를 넣은 실습용 가상 원고입니다.
참고문헌 대응, 표의 산술, 보고 지침 대응, 기계적인 표현 점검을 허용합니다.
원고의 주장, 해석, 숫자, 인용 선택과 새 문장 작성은 제가 합니다.
수정 제안은 별도 파일에 남기고 원고에는 직접 반영하지 마세요.
외부 참고문헌 조회는 아직 허용하지 않습니다.
사용할 에이전트와 실제 모델을 확인하고 AI-USE-PLAN.md에 기록해 주세요.
최종 공개문은 ICMJE 일반 형식을 참고하되 제가 학술지 지침과 대조합니다.
스킬은 proof plan으로 계획 파일의 틀을 만들고 허용 범위를 확인합니다. 모델 이름을 알 수 없다면 추측해서 채우지 말고 ‘확인 필요’로 남깁니다. 설정 화면에서 확인한 뒤 고치십시오.
사람이 읽는 계획과 도구가 읽는 이름
proof 0.1.0의 계획 대조는 아래처럼 영어 제목과 작업 이름으로 적힌 목록을 읽습니다. 설명은 한국어로 써도 되지만 목록의 작업 이름은 유지합니다. 에이전트가 만든 파일에 이 범위가 반영되었는지 확인하십시오.
## Allowed tasks
- references
- tables
- checks
- checklist
- polish
- readiness
- disclose
## Not delegated
- drafting
- interpretation
- citation-selection
checks는 숫자와 그림 참조 등의 추가 기계적 검사입니다. 다음 레슨에서 사용합니다. simplify와 stats-recheck는 이번 기본 실습에 넣지 않습니다. 추가로 하기로 정했다면 실행 전에 이유와 날짜를 기록하고 해당 작업 이름을 허용 목록에 추가합니다.
이 실습의 계획은 ‘이미 존재하는 예제 원고를 점검하기 전의 계획’입니다. 템플릿의 Declared before manuscript preparation 문구는 실제 점검 시작 날짜와 단계로 바꾸십시오. 기본 목록에 들어 있는 simplify와 stats-recheck도 이번 실습에서 허용하지 않았다면 제거합니다. 연구 시작 전 사전등록과 같다고 설명하지 않습니다. 실제 새 연구에서는 프로토콜을 작성할 때 AI 사용 범위도 정해 둘 수 있습니다. 나중에 범위를 바꿨다면 원래 계획을 없애거나 시점을 앞당겨 쓰지 말고 변경 이유를 남깁니다.
로컬 폴더와 로컬 AI는 다릅니다
원고가 내 컴퓨터에 있어도 Claude Code나 Codex가 호스팅된 모델로 내용을 보내면 해당 제공자가 원고 내용을 처리합니다. proof config --lookups off가 끄는 것은 참고문헌 메타데이터 조회입니다. 에이전트의 모델 통신까지 끄는 설정은 아닙니다.
실습에서는 가상 원고만 사용합니다. 기관 자료와 실제 원고는 기관의 사용 범위와 제공자 조건을 확인한 뒤 별도로 판단합니다. proof는 다른 사람의 비공개 심사 원고를 넣어 검토하는 용도로 안내하지 않습니다.
직접 해 보기약 10분
실습 또는 본인의 원고 점검을 위한 계획을 적습니다. 아직 설치하지 않은 분도 아래 표를 내려받아 작업 지시로 보관할 수 있습니다.
| 정할 것 | 내 계획 | 확인할 사람·시점 |
|---|---|---|
1행
2행
3행
4행
5행
proof를 사용했다면 AI-USE-PLAN.md도 열어 이 표와 대조합니다. 허용하지 않은 작업이 있으면 첫 점검 전에 바로잡습니다.
연구에 적용하면
작업 지시가 구체적이면 결과도 대조할 수 있습니다. 다음 레슨에서는 참고문헌과 표를 확인하되, 발견한 오류를 자동으로 고치지 않고 보고서로 받습니다.