ko-academic-style

Files (1)

• SKILL.md

SKILL.md (first lines)

# 문서 모드 (ko-academic-style)

## 1. 선언
문서 작업 착수 시 가시 답변 첫 줄에 한 줄 선언한다.
`문서 모드: 논문 문어체 적용 · 민감도: 공개 | 민감`
파일로 나가는 문서 텍스트에는 챗 페르소나(반말·슬랭·세션 은어)를 적용하지 않는다. 챗 답변은 페르소나를 유지한다.

## 2. 쓰기 전 용어 조회 (직역 신조어 차단)
영문 개념을 한글로 옮기기 직전에 매핑표를 조회한다.
```
~/docstyle-lab/.venv/bin/python ~/docstyle-lab/termtable/lookup.py "<영문 개념 또는 한글 표기>"
```
- 분야 표기(국내 논문 최빈 표기)가 있으면 그것을 쓴다. 예: tolerance→공차, topology optimization→위상최적화, lattice→격자.
- 없으면 영어 원어 그대로 둔다. 굳은 음차(커밋·캐시·훅·파이프라인·폴백)는 음차.
- 정책 우선: NURBS·mesh·gyroid는 혼용 용어라 원어 기본(사용자 결정 2026-09-04). 정책 파일 `~/docstyle-lab/termtable/policy.json`.
- 즉석에서 번역어를 만들지 않는다. 조회 결과가 없는 개념을 한글로 옮겨야 하면 첫 등장에 원어를 병기하고 한 줄 뜻을 단다.

## 3. 압축 조어 풀어쓰기 (의미 전달 차단 방지)
스스로 만든 명사 결합(쓰기범위·제조제약·공격품질 류)은 조사·관형절로 풀어 쓴다: 쓰기 권한 범위, 제조 공정 제약, 공격 품질. 매핑표·정책 화이트리스트에 없는 2~4음절 명사 결합은 신조어로 간주한다. 판정 기준: 처음 보는 10년차 실무자가 한 번에 뜻을 잡는가.

## 4. 문체
- 은유·문학 수사·구어·드라마 표현 금지. 부류 목록은 메모리 `feedback-doc-formal-register.md`, 확정 위반은 `policy.json`의 banned_ko.
- 서술 종결은 `-하였다/-되었다/-이다`. `-했다`는 쓰지 않는다.
- 문장 사이 논리 관계는 접속부사(따라서·그러나·또한·한편)로 드러낸다. 관계를 암시로 남기지 않는다.
- 그림·표 번호는 단일 시퀀스.

## 5. 작성 단위
절(h2) 하나를 Write 1회로 쓴다(4k자 이내 권고). 절을 마칠 때마다 2·3·4항을 자기 점검한 뒤 다음 절로 넘어간다.

## 6. 송출 전
CLAUDE.md의 [문서 표현 전수검사 v5.6.13] 절차를 그대로 따른다. 자체 스윕에 `policy.json` banned_ko grep과 신규 한글 용어의 lookup 조회를 포함한다. 민감(민감·수출통제) 문서는 외부 모델 검수를 생략하고 그 사실을 명시한다.

## 7. 축적
사용자 지적 1건은 `policy.json`(banned_ko 또는 whitelist) 1줄로 되돌려 넣는다. 매핑표 갱신: `build_terms.py --queries queries.txt`(분기 1회, 원문 미보관).

From jsb4702-glitch/verification-harness, MIT.

More from jsb4702-glitch/verification-harness