4강
수정 결정과 AI 사용 공개
원고와 별도인 수정 제안을 확인하고 하나씩 받아들이거나 거절합니다. 실행·결정 기록에서 AI 사용 공개문을 만듭니다.
제안을 받는 것과 고치는 것은 두 단계입니다
에이전트가 수정안을 내면 매끄러운 문장부터 눈에 들어옵니다. 그러나 더 읽기 쉬워졌다는 이유만으로 주장이나 숫자가 달라져도 되는 것은 아닙니다. 이 실습에서는 철자, 단위 표기, 약어, 기계적인 문법 점검으로 범위를 한정합니다.
proof는 원고의 복사본에 원문과 제안을 표시합니다. 저자는 해당 부분을 읽고 받아들일지 결정합니다. 이때 거절한 제안도 기록에 남습니다.
원고를 바꾸는 결정과 AI 사용을 기록하는 절차를 함께 확인합니다.
출처 · ethosLab 작성 도해, 2026-09-06. proof 0.1.0 src/cli.ts와 src/markers.ts의 제안 반영 흐름.
그림을 누르면 원본 크기로 볼 수 있습니다.
1. 기계적인 표현 수정만 요청합니다
Claude Code에서는 아래처럼 입력합니다. Codex에서는 첫 줄을 $polish로 바꿉니다.
/proof:polish
AI-USE-PLAN.md에 정한 범위에서 manuscript.md를 점검해 주세요.
문법과 철자·약어·단위 표기의 기계적인 수정만 제안합니다.
이번 실습에서는 미국식 철자를 기준으로 하되 원고에 직접 반영하지 마세요.
주장, 숫자, 인용, 문장의 강조 정도를 바꾸지 마세요.
proof/polish.md와 manuscript.polish.md를 남기고
proof verify로 확인한 뒤 제가 결정할 수 있게 알려 주세요.
예제에는 randomised와 randomized처럼 철자가 섞여 있습니다. proof/polish.md에는 발견한 문제가, manuscript.polish.md에는 실제 수정 제안이 담깁니다. 스킬이 모델을 사용해 제안 파일을 작성하는 단계와 CLI가 기계적으로 찾는 신호는 구분합니다. proof polish 명령만 실행했다고 제안 파일까지 자동으로 완성되는 것은 아닙니다.
표시는 다음과 같습니다. 아래 한 줄은 형식을 설명하기 위한 예입니다.
<!-- randomised / randomized -->
왼쪽은 원래 표현이고 오른쪽은 제안입니다. 마크다운 미리보기에서는 HTML 주석이 숨겨질 수 있으므로, 텍스트 편집기에서 열거나 다음 명령으로 제안 목록을 확인합니다.
2. 대조한 뒤 저자가 반영합니다
일반 터미널에서 실습 원고 폴더를 열고 실행합니다.
proof verify manuscript.polish.md
proof markers manuscript.polish.md
verify는 제안을 모두 거절했을 때 현재 원고가 복원되는지 확인합니다. 제안 밖의 문장이 바뀌었거나 그동안 저자가 원고를 수정했다면 MISMATCH가 나올 수 있습니다. 이때는 반영하지 말고 현재 원고를 기준으로 제안 파일을 다시 만들어야 합니다. 검사 통과는 제안의 학술적 정확성을 보증하지 않습니다.
목록과 원고 문맥을 읽었으면 다음을 실행합니다.
proof apply manuscript.polish.md --interactive
각 제안에서 a는 받아들임, r은 거절, e는 저자가 바꿀 표현 입력, q는 남은 질문을 그만 보는 선택입니다. q는 이미 고른 결정을 취소하지 않습니다. 아직 결정하지 않은 제안은 원문을 유지하는 거절로 처리됩니다. 이 실습에서는 하나를 받아들이고 하나를 거절해 차이를 확인합니다.
반영 전에 .proof/backups/에 원고 복사본이 생기고, 각 결정이 .proof/ai-use.jsonl에 추가됩니다. 원고를 다시 열어 선택한 부분만 바뀌었는지 확인합니다. 한 번 반영한 제안 파일은 이전 원고를 기준으로 만들었으므로 그대로 반복 적용하지 않습니다.
3. 기억 대신 기록에서 공개문을 만듭니다
일반 터미널에서 proof log show를 실행합니다. 어떤 점검을 실행했고 어느 제안을 받아들이거나 거절했는지 확인합니다. 모델 이름이 비어 있거나 사용한 도구와 다르면 공개문을 확정하기 전에 실제 설정과 실행 기록을 대조하십시오. 하지 않은 작업을 했다고 채우지 않습니다.
Claude Code에서는 /proof:disclose, Codex에서는 $disclose를 실행합니다. 스킬은 기록을 바탕으로 DISCLOSURE.md를 만들고 학술지 문구와 대조하도록 안내합니다. 원고에는 저자가 검토한 문장을 직접 옮깁니다.
ICMJE는 제출 시 AI 사용을 밝히고, 표지 편지와 제출 원고의 적절한 위치에서 사용 방법을 설명하도록 안내합니다. AI는 저자가 될 수 없으며 내용의 책임은 인간 저자에게 있습니다. 제출할 학술지의 최신 양식과 요구 위치를 함께 확인하십시오.
proof의 로그에는 기록된 실행과 결정이 들어 있습니다. 다른 대화창에서 받은 도움이나 기록을 남기지 않은 작업까지 자동으로 수집하지는 않습니다. 공개문을 읽으며 실제 사용 범위와 빠진 기록을 확인합니다. 점검만 했으면 점검으로, 표현 수정 제안을 반영했으면 그 도움까지 설명합니다.
마지막으로 /proof:readiness 또는 $readiness를 다시 실행합니다. 계획과 로그의 차이, 공개문 파일의 존재, 원고에 남은 불일치를 확인합니다. 공개문 파일이 있다는 것만으로 모든 공개 의무가 충족된 것은 아닙니다.
직접 해 보기약 20분
실습 복사본에서 제안 하나를 받아들이고 하나를 거절합니다. 그 이유를 적고 원고·로그·공개문을 나란히 확인하십시오. 설치 전이라면 예시 철자 변경을 받아들이거나 거절할 이유와 앞으로 기록할 항목을 아래에 적을 수 있습니다.
| 제안 또는 점검 | 내 결정과 이유 | 확인한 파일 |
|---|---|---|
1행
2행
3행
작성란, proof/ 보고서, 제안 파일, .proof/ai-use.jsonl, DISCLOSURE.md를 함께 보관합니다. 게시판에는 가상 예제의 결정 이유만 공유해도 충분합니다.
연구에 적용하면
원고를 점검하는 에이전트 활용은 보고서 수령에서 끝나지 않습니다. 저자가 제안을 판단하고 그 과정을 설명할 기록을 남겼을 때 한 번의 작업이 끝납니다. 같은 일을 매번 반복하게 된다면 모듈 8에서 반복 절차를 정리하는 방법으로 이어집니다.
이 모듈의 벽
원고 한 편은 점검을 마쳤습니다. 그러나 문헌 확인과 소식 추적 같은 일은 다음 주에도 같은 손으로 반복해야 합니다.