paper-quality-loop
Skill0 starsChanged 29 days agoMITView on GitHub
논문 원고를 독립 심사, 지적 분류, 수정 실행, 문체 정리의 바퀴로 반복해 미리 정한 품질 기준에 닿을 때까지 진행할 때 사용. "품질 나올 때까지 반복", "심사 돌려", "한 바퀴 더" 같은 지시에 적용.
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- english-academic-styleSkill
- fact-checkSkill
- feasibility-gateSkill
- korean-academic-styleSkill
- literature-scoutSkill
- paper-condenseSkill
- paper-framingSkill
- paper-readabilitySkill
- paper-reviewSkill
- preregister-sealSkill
- problem-grillSkill
- rebuttalSkill
- research-batchSkill
- research-portfolioSkill
- research-scaffoldSkill
- research-sessionSkill
- seminar-slidesSkill
- submission-packageSkill
The file
Files
논문 품질 반복
원고를 심사, 분류, 실행, 문체의 바퀴로 돌리고, 시작 전에 적어 둔 기준에 닿으면 멈춘다. 이 스킬은 순서와 멈춤 규칙만 정한다. 각 단계의 방법은 다음 스킬을 따른다.
| 단계 | 따르는 스킬 |
| 주장과 증거, 초록과 서론과 결론, 틀 | paper-framing |
| 배치 실행과 보고, 할일목록 새 판 | research-batch |
| 숫자, 인용, 부등호, 헤지의 대조 | fact-check |
| 문체 | korean-academic-style, english-academic-style |
| 쪽 수 맞춤 | paper-condense |
| 투고 준비 | submission-package |
| 실제 심사평 대응 | rebuttal |
research-session의 공통 규칙을 따른다. 역할별 모델은 프로젝트 설정을 따른다. 프로젝트에 할일목록, 현황, 사전 등록 문서가 있으면 그 규칙이 이 스킬보다 앞선다. 이 스킬은 모의 심사의 반복을 다룬다. 투고 뒤 실제 심사평을 받으면 rebuttal로 넘긴다.
0. 시작할 수 있는 조건
아래 가운데 하나라도 맞지 않으면 바퀴를 돌리지 않고 이유를 사용자에게 알린다.
- 처음부터 끝까지 읽히는 초안이 있다. 결과 절이 비어 있으면 심사가 아니라 실험 배치가 먼저다.
- 원고의 범위(주장 목록, 넣을 것과 뺄 것)가 정해져 있다. 없으면 paper-framing 0절의 주장 목록부터 만든다.
- 첫 바퀴 전에 틀을 먼저 심사받았다. 심사 에이전트 하나에 paper-framing의 주장 목록(주장, 증거, 감당 여부)과 잠근 문제 정의만 주고, 주장이 증거에 비해 크거나 정의상 참인 부분이 있는지 묻는다. 여기서 큰 지적이 나오면 원고 심사에 들어가지 않고 paper-framing이나 problem-grill로 돌아간다.
- 원고를 막고 있는 사용자 결정이 없다. 있으면 그 결정을 먼저 묻는다.
- 마감과 쪽 수 상한을 안다.
1. 멈춤 기준을 먼저 적는다
첫 바퀴 전에 기준을 <원고 폴더>/품질반복/기준.md에 적고 사용자에게 보인다. 사용자가 따로 정하지 않으면 아래 기본값을 쓴다. 바퀴가 돈 뒤에는 기준을 낮추지 않는다. 바꾸려면 사용자가 정하고 승인기록에 남긴다.
| 기준 | 기본값 | 판정하는 쪽 |
| 증거가 감당하지 못하는 주장 | 0개 | 총괄 (paper-framing 0절 주장 목록) |
| 원고 숫자와 원자료의 불일치 | 0개 | 독립 검산 |
| 숫자는 맞으나 해석이 틀린 곳 | 0개 | 해석 검산 |
| 큰 지적 | 합의된 큰 지적 0개, 치명 지적 0개(paper-review 3절, 5절) | 심사 |
| 새 독자가 막힌 곳(전체) | 3곳 이하 | 새 독자 |
| 쪽 수, 단어 수, 양식 | 투고처 규정 충족 | 총괄 |
| 횟수 상한 | 학회 판 2바퀴, 학술지 판 3바퀴 |
작은 지적이 남아도 멈춘다. 심사 에이전트는 몇 번을 돌려도 지적을 내므로 지적 0개를 기준으로 삼지 않는다.
횟수 상한을 올리려면 사용자가 정하고, 그 결정과 이유를 승인기록에 남긴다. 총괄이 대신 올리지 않는다. 상한을 몇 번 올렸는지는 바퀴마다 보고에 적는다.
큰 지적은 다음과 같다. 주장을 증거가 받치지 못한다, 증명이나 계산이 틀렸다, 계산은 맞지만 해석이 틀렸다, 전제가 숨어 있어 결론이 달라질 수 있다, 비교군이 없어 결론을 내릴 수 없다, 가장 가까운 선행 연구와의 차이가 불분명하다, 재현에 필요한 정보가 없다.
작은 지적은 다음과 같다. 문장, 배치, 설명 부족, 용어 불일치, 그림과 표의 가독성.
2. 한 바퀴
2.1 심사
네 역할(심사, 새 독자, 독립 검산, 해석 검산)의 에이전트를 한 번에 함께 띄운다. 학회 판은 다섯, 학술지 판은 여섯이다. 역할별 모델은 프로젝트 설정을 따른다. 모두 새로 띄우고 앞선 대화와 이전 바퀴의 심사평을 넘기지 않는다.
| 역할 | 받는 것 | 내는 것 |
| 심사 ×2 (학술지는 ×3) | 익명 원고, 투고처의 심사 기준(paper-review의 기준표와 투고처 판) | paper-review 4절 양식의 보고(축 점수, 지적 목록, 권고) |
| 새 독자 | 익명 원고 | 비전문가로 읽어 막힌 곳과 이유만 |
| 독립 검산 | 원고, 규칙 문서, 원자료 | 원고의 모든 숫자를 다시 계산한 대조표 |
| 해석 검산 | 원고, 규칙 문서, 결과 표 | 숫자마다 원고가 붙인 해석(크다, 같다, 개선, 원인)이 결과 표와 판정 규칙에서 나오는지의 대조표 |
- 심사 역할은 paper-review 1~5절의 절차로 돌리고, 종합도 그 5절을 따른다. 심사자에게 지적마다 크다, 작다와 그 이유를 적게 한다. 1절의 정의를 지시문에 넣는다.
- 심사자에게 고칠 문장을 써 달라고 하지 않는다. 지적만 받는다.
- 해석 검산은 독립 검산과 따로 둔다(fact-check 2절). 독립 검산이 모두 맞아도 계산은 맞지만 해석이 틀린 경우가 남는다. 해석 검산은 비교의 방향, 차이를 크다고 부를 근거, 인과를 주장하는 문장, 판정 규칙에 없는 기준으로 내린 결론을 본다.
- 같은 계열 모델만으로 세 바퀴를 넘기지 않는다. 둘째 바퀴 안에 다른 계열 모델이나 사람(교신저자, 동료)의 검토를 한 번 넣는다. 같은 계열은 놓치는 곳이 겹친다. 다른 도구가 있으면 반론자 역할로 맡기고, 프로젝트에 교류 폴더(
00-교류/)가 있으면 그 절차로 넘긴다. 어느 쪽도 없으면 사용자에게 사람 검토를 요청하고, 그 사실을 바퀴 기록에 적는다.
2.2 분류 (총괄)
총괄이 지적을 하나씩 표로 옮긴다. 열은 번호, 낸 쪽, 크기, 위치, 종류, 원자료 대조, 처리, 담당이다.
| 종류 | 처리 |
| 주장과 증거 | paper-framing 0절의 주장 목록으로 돌아간다. 증거를 더할 수 없으면 주장을 줄인다 |
| 실험 | 새 실험이나 재집계가 필요하다. 마감 안에 되는지 어림하고, 안 되면 주장을 줄이거나 한계에 적는다 |
| 사실과 숫자 | 원자료에서 총괄이 직접 다시 계산해 고친다 |
| 해석 | 결과 표와 판정 규칙으로 돌아가 해석 문장을 다시 쓴다. 숫자는 바꾸지 않는다 |
| 문장과 구조 | 해당 문단만 고친다 |
| 받지 않음 | 이유를 한 줄 적는다. 큰 지적은 근거 없이 받지 않을 수 없다 |
- 심사자도 틀린다. 지적을 그대로 믿지 않고, 원자료와 원고를 직접 대조해 지적이 맞는지 확인한 뒤에만 고친다. 대조 결과를 원자료 대조 열에 적는다. 대조해 보니 지적이 틀렸으면 받지 않음으로 두고 근거를 적는다.
- 심사자가 크다고 한 지적을 총괄이 작다고 낮추려면 이유를 적는다.
- 주장을 바꾸는 판단은 총괄이 제안하고 사용자가 정한다. 결정은 승인기록에 남긴다.
- 결과를 본 뒤에는 사전 등록한 판단 규칙을 바꾸지 않는다. 불리한 결과를 빼서 지적을 닫지 않는다.
- 분류가 끝나면 1절 기준으로 판정한다. 모두 충족이면 3절로 간다.
불리한 결과는 공통 규칙 8을 따른다.
2.3 실행
- research-batch 절차로 고친다. 진척을 수시로 보고하고 작업 목록에 올린다.
- 원고 수정, 집계, 조판은 실행 역할이 맡는다. 고친 에이전트가 자기 수정을 채점하지 않는다.
- 배치 구조나 일정이 바뀔 때만 research-batch로 할일목록의 새 판을 만든다. 바퀴마다 만들지 않는다.
- 초록, 서론, 결론을 고칠 때는 paper-framing 5절(심사 대응 이동 기록)을 지킨다. 이전 바퀴에서 닫은 지적이 다시 열리지 않았는지 대조한다.
2.4 문체
- 이번 바퀴에서 바뀐 문단에만 문체 스킬을 적용한다.
- 전체 적용은 원고를 고정하기 직전에 한 번만 한다. 문체 수정은 사실을 바꿀 수 있으므로, 적용 뒤 fact-check로 대조한다. 숫자, 부등호, 인용, 조건, 헤지가 적용 전 판과 같아야 한다.
- 쪽 수가 넘치면 paper-condense로 줄인다.
2.5 바퀴 기록
<원고 폴더>/품질반복/R<번호>/에 심사평 원문, 분류표, 독립 검산과 해석 검산의 대조표, 판정을 둔다. 현황 맨 위에 한 항목을 더하고, 현황의 원고 칸을 갱신한다. 통째로 덮어쓰지 않는다.
3. 멈춤과 보고
바퀴가 끝날 때마다 진행판으로 보고한다. 바퀴 안에서 심사 에이전트를 띄우면 에이전트 표가 있는 진행판을 보인다. 틀은 research-session 8절(시작 안내, 진행판, 마침 보고)을 따른다. 아래는 이 스킬의 보고에 들어갈 내용의 예다.
== 진행 | <프로젝트> | 품질 반복 | HH:MM (R2 끝, 시작 HH:MM, 경과 n분, 남은 어림 n분) ==
전체 [##########--] 기준 5/6
바퀴 R1 [완료] R2 [완료] R3 [예정] (상한 3, 상한 올림 0회)
기준 큰 지적 미충족(심사2 1건: 정리 1 전제) / 감당 못 하는 주장 0 / 숫자 불일치 0
해석 불일치 0 / 새 독자 막힘 2 / 쪽 수 10/10
지적 이번 바퀴 닫음 14(큰 것 3), 남음 6(큰 것 1), 원자료 대조로 받지 않음 2
검토 다른 계열 또는 사람 검토 R1에 1회
결정 R3로 갈지 사용자 결정- 기준을 모두 채우면 멈춘다. 전체 문체 적용과 fact-check 대조를 한 번 하고 원고를 고정한다. 고정판의 경로와 해시를 승인기록과 현황에 적는다. 투고는 submission-package로 준비한다.
- 횟수 상한에 닿았는데 채우지 못하면 더 돌리지 않는다. 남은 큰 지적과 선택지(그대로 제출, 주장이나 범위 축소, 제출 연기, 상한 올림)를 사용자에게 보이고 결정을 받는다. 상한 올림을 고르면 1절대로 승인기록에 남긴다.
- 마감까지 남은 날이 한 바퀴에 드는 날보다 적으면 새 바퀴를 시작하지 않는다.
- 두 바퀴 연속으로 같은 큰 지적이 남으면 문장으로 풀리는 문제가 아니다. 문장 수정을 멈추고, 지적이 신규성, 비교군, 자명성에 걸리면 feasibility-gate(G0, G2, G3)로, 문제나 주장의 틀에 걸리면 problem-grill로 돌아간다. 어느 쪽으로 돌아갈지와 그 이유를 사용자에게 보이고 정하게 한다.
4. 지킬 것
- 없는 사실, 숫자, 인용을 만들어 지적을 닫지 않는다.
- 보고와 문서는 쉬운 한국어로, 평가는 숫자로 쓴다. 논문 본문과 식별자는 영어 그대로 둔다.
- 그 밖의 규칙(만든 쪽이 채점하지 않기, 에이전트 숫자의 재계산, 사용자만 하는 일, 파일 보이기)은 research-session의 공통 규칙을 따른다.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

