ko-tech-writer

# ko-tech-writer — 한국어 기술문서 집필·개고 파이프라인 독자 대면 한국어 기술 산출물(테크블로그 글 · 기술문서 · 발표 파생 자산)을 쓰거나 개고한다. 핵심 전제: **좋은 문장은 취향이 아니라 절차다** — 실물 표본으로 톤을 캘리브레이션하고, 번역투를 패턴 목록으로 제거하고, 수치는 근거와 창을 달고, 렌더 결과를 눈으로 확인한다. > 출처: 2026-08-10 발표 기술문서 세션에서 실측으로 벼려진 규율의 자산화. 이 문서의 규칙 > 클래스는 그 세션의 개고에서 실제로 검출·수리된 것들이다 — 근거 원장은 그 세션 기록 > (`fh_completed_2026-08-10` 및 해당 개고 커밋 이력. 비공개 세션 기록이라 외부 배포본 > 독자에게는 도달하지 않는 내부 포인터다). **실측 근거가 없는 클래스를 추가하지 않는 것**이 > 이 문서의 유지 규칙이다. 이 SKILL.md 자체는 독자 대면 ���서가 아니라 하네스 자산이므로 > 이 파이프라인의 적용 대상이 아니다(FH 하우스 스타일을 따른다). ## Step 0 — 대상 판별 (레지스터 분기) 같은 내용도 매체에 따라 규율이 다르다. 먼저 셋 중 무엇인지 정한다: | 대상 | 레지스터 | 이 스킬의 적용 | |---|---|---| | **독자용 문서** (블로그 글·기술문서) | 문어 존댓말 (습니다체) | Step 1~5 전체 | | **낭독 대본** (발표 스크립트) | 구어 발표체 | Step 2~4 만 — 구어 리듬 유지, 줄표는 «쉼»으로만 실현되므로 소리로 안 들리는 동격·재진술 줄표 제거 | | **파생 압축 자산** (티저·요약 이미지·1장 슬���이드) | 자립형 평문 | Step 2~**5** + **자립성 검사**: 화면·본문 맥락 없이 서야 하므로 정본 어휘·주장 범위·은어를 따로 대조. 렌더 산출물을 만들면 Step 5 지각 QA 필수 | 검증된 원문에서 파생 자산을 만들 때도 재검사한다 — 압축은 주장 범위를 움직일 수 있다 (예: «지점 앞에서 벼려졌다» → «도메인에서 확인해 온»으로 줄면 담당 범위가 넓어져 읽힌다). ## Step 1 — 실물 캘리브레이션 (표본 없이 톤 단정 금지) 게재 매체가 지정되지 않았으면 **먼저 묻는다**(한 줄). 답을 받을 수 없는 환경이면 일반 규율로 진행하고 그 사실을 이력에 명기한다. 게재 목표 매체의 **실제 표본을 1편 이상** 확인(WebFetch)하고 세 가지를 기록한다: 1. **문체**: 존댓말 변형(습니다/해요), 도입 형식(질문형/선언형) 2. **구성**: 소제목 밀도, 마무리 관행(일반화 + 트레이드오프 + 실무 조언 등) 3. **시각물**: 다이어그램/그래프/표를 어느 밀도로 쓰는가 캘리브레이션 기록은 **산출물 이력**(작업 로그·PR 본문·문서 frontmatter)에 남긴다 — 게재 본문에는 노출하지 않는다. 표본을 확인할 수 없으면 **무엇을 시도했고 왜 안 됐는지**(호출 실패·매체 미상 등)를 같은 이력에 명기하고 일반 규율(습니다체·소제목 ...