---
name: create-docx
description: Word(.docx) 문서를 생성합니다. 다크 헤더 테이블, Phase 색상 박스, 교차 행 배경 등 전문적인 스타일을 지원합니다. 사용자가 Word 파일, docx 파일 생성을 요청할 때 사용합니다.
user-invocable: true
argument-hint: [output-path]
---

# Word(.docx) 문서 생성 스킬

Word 문서를 생성할 때 이 스킬의 Python 모듈을 사용합니다.

## 사용법

```python
import sys
sys.path.insert(0, ".claude/skills/create-docx")
from create_docx import create_docx

path = create_docx(
    title="문서 제목",
    sections=sections,
    output_path="$ARGUMENTS",  # 또는 사용자가 지정한 경로
    subtitle="작성일: YYYY-MM-DD",
)
```

Bash 도구로 Python 스크립트를 실행하여 문서를 생성합니다.

## create_docx() 매개변수

- `title` (str): 문서 제목
- `sections` (list[dict]): 섹션 리스트
- `output_path` (str): 저장 경로 (.docx)
- `subtitle` (str, 선택): 부제목/정보 텍스트

## 섹션 구조

각 섹션은 dict이며, 아래 키를 조합하여 사용:

| 키 | 타입 | 설명 |
|---|------|------|
| `heading` | str | 섹션 제목 |
| `level` | int | 제목 레벨 (1 또는 2, 기본 1) |
| `paragraphs` | list[str] | 본문 텍스트 |
| `bullets` | list[str] | 불릿 리스트 |
| `numbered` | list[str] | 번호 리스트 |
| `bold_items` | list[tuple[str,str]] | (굵은제목, 설명) 쌍 |
| `table` | dict | 테이블 (아래 참조) |
| `phase_box` | dict | Phase 색상 박스 (아래 참조) |

### table 구조

```python
{
    "headers": ["컬럼1", "컬럼2", "컬럼3"],
    "rows": [["값1", "값2", "값3"], ...],
    "col_widths": [2, 5, 3],        # cm 단위 (선택)
    "center_cols": [0, 2],          # 가운데 정렬 컬럼 인덱스 (선택)
    "bold_cols": [1],               # 굵게+파란색 컬럼 인덱스 (선택)
}
```

스타일: 다크 네이비(#2B3544) 헤더 + 흰색 텍스트, 교차 행 배경색

### phase_box 구조

```python
{
    "title": "Phase 1: 제목 (기간)",
    "color": "green",   # green, orange, blue, purple
    "items": ["항목1", "항목2", "항목3"],
}
```

스타일: 색상 테두리 + 연한 배경 헤더 + 항목 리스트

## 전체 예시

```python
sections = [
    {
        "heading": "1. 배경",
        "paragraphs": ["프로젝트 배경 설명입니다."],
    },
    {
        "heading": "2. 제약사항",
        "bold_items": [
            ("핵심 포인트", "설명 내용"),
        ],
    },
    {
        "heading": "3. 데이터",
        "table": {
            "headers": ["순위", "항목", "비고"],
            "rows": [["1", "첫 번째", "메모"], ["2", "두 번째", "메모"]],
            "col_widths": [1.5, 8, 5],
            "center_cols": [0],
            "bold_cols": [1],
        },
    },
    {
        "heading": "4. 실행 계획",
        "phase_box": {
            "title": "Phase 1: 기반 구축 (1~2개월)",
            "color": "green",
            "items": ["항목 1", "항목 2"],
        },
    },
    {
        "phase_box": {
            "title": "Phase 2: 고도화 (3~4개월)",
            "color": "orange",
            "items": ["항목 3", "항목 4"],
        },
    },
    {
        "heading": "5. 다음 단계",
        "numbered": ["첫 번째 할 일", "두 번째 할 일"],
    },
]

path = create_docx(
    title="문서 제목",
    sections=sections,
    output_path="/path/to/output.docx",
    subtitle="작성일: 2026-03-03",
)
```

## 주의사항

- 폰트: 맑은 고딕 (기본)
- 콘텐츠 컨트롤(sdt) 서식 자동 제거
- python-docx 패키지 필요 (`pip install python-docx`)