과업지시서(TOR) HWPX 자동 생성 스킬

한국기계연구원 과업지시서(Terms of Reference)를 자동으로 HWPX 파일로 생성한다.
샘플 파일(TermsOfReference_sample.hwpx)의 기관 로고·머리글 레이아웃을 그대로 재사용하고,
본문 10개 섹션만 새로 생성·치환한다.

스킬 구조

skills/tor/
├── SKILL.md
├── assets/
│   └── TermsOfReference_sample.hwpx   ← 기관 로고·머리글 포함 샘플 양식
└── scripts/
    ├── build_tor.py                   ← 메인 생성 스크립트
    ├── validate.py                    ← HWPX 구조 검증
    ├── requirements.txt               ← lxml
    └── office/
        ├── unpack.py                  ← HWPX → 디렉터리 언팩
        └── pack.py                    ← 디렉터리 → HWPX 재조립

모든 경로는 스크립트 위치 기준 상대경로로 동작하므로 어느 PC에서도 작동한다.

의존성 설치

# uv 사용 (권장)
uv pip install lxml

# pip 사용
pip install lxml

실행 방법

# 작업 디렉토리로 이동 (pyproject.toml 또는 출력 파일 위치)
cd <작업_디렉토리>

# JSON 파일로 실행
PYTHONUTF8=1 uv run python ~/.claude/skills/tor/scripts/build_tor.py \
  --input tor_data.json --output result.hwpx

# CLI 인수로 간단히 실행 (title/dept/author/period만)
PYTHONUTF8=1 uv run python ~/.claude/skills/tor/scripts/build_tor.py \
  --title "과업명" --dept "부서명" --author "홍길동" --period "계약일로부터 50일" \
  --output result.hwpx

Windows: PYTHONUTF8=1 필수 (한국어 CP949 환경의 stdout 인코딩 문제 방지)

스크립트가 자동으로 validate.py를 실행하여 구조 검증까지 수행한다.

입력 JSON 스키마

{
  "title": "과업명",
  "department": "나노디스플레이연구실",
  "author": "홍길동",
  "period": "계약일로부터 50일",
  "purpose": "목적 설명 (1~2문장)",
  "scope_summary": "과업 범위 주요내용 한 줄 (가. 주요내용의 ○ 항목)",
  "scope_items": ["1) 항목1", "2) 항목2"],
  "content_items": ["  가. 세부 설명1", "    ○ 하위 항목"],
  "deliverables": ["가. 검수 방법", "나. 결과물 목록"],
  "responsibilities": ["가. 책임 내용1", "나. 책임 내용2"],
  "qualifications": ["가. 자격 조건1"],
  "termination_conditions": ["가. 조건1", "나. 조건2", "다. 조건3"],
  "misc": "기타 조항 (생략 시 기본 문구 사용)"
}

10개 섹션 매핑

사용 워크플로우

1. 사용자가 자연어로 과업지시서 내용을 설명
2. Claude가 JSON 데이터를 작성하여 임시 파일(tor_data.json)로 저장
3. build_tor.py 실행 → result.hwpx 생성
4. validate.py 자동 실행 (구조 검증)
5. 결과 파일 경로를 사용자에게 안내

스타일 규칙

• 섹션 제목: paraPrIDRef="21" + charPrIDRef="16" (13pt Bold)
• 본문 기본: paraPrIDRef="21" + charPrIDRef="17" (13pt Regular)
• 빈 줄: paraPrIDRef="34" + charPrIDRef="16"
• 10번 기타: paraPrIDRef="36" + charPrIDRef="16"/"26" (번호 Bold + 내용 Regular)

섹션별 들여쓰기 paraPrIDRef

주의사항

• PYTHONUTF8=1 필수 (Windows 한국어 환경)
• 스크립트는 스킬 디렉토리 기준 상대 경로로 동작 (별도 작업 디렉토리 설정 불필요)
• 기관 로고(image4.jpg)는 샘플에서 자동 재사용됨
• PREFIX 내 치환 대상: "나노디스플레이연구실", "김재현", "뇌졸중 환자 재활훈련 프로그램 개발"