기술 문서
자동 생성기
API 스펙 → AI가 포맷 → Word/PDF 내보내기
// 에이전트 세션 로그
"OpenAPI 스펙으로 API 레퍼런스 문서를 생성해주세요. 기업용 형식, Python과 JS 예제, changelog 섹션, DOCX와 PDF로 내보내기."
// 실행 순서 계획 중
- → openapi.yaml 파싱 — 엔드포인트 & 스키마 추출
- → 기업용 .dotx 템플릿 적용
- → 파라미터 + 응답이 포함된 엔드포인트 섹션 생성
- → Python + JS 코드 예제 삽입
- → TOC + 인덱스 + changelog 자동 생성
$ ap-docs new --type api-reference --template enterprise-docs
✓ Document created from enterprise template
$ ap-docs parse-openapi --input openapi.yaml --sections endpoints,schemas
✓ Parsed: 42 endpoints, 18 request/response schemas
$ ap-docs generate-sections --code-examples python,javascript
✓ 42 endpoint sections with dual-language code blocks
$ ap-docs export --word --pdf --toc --index
✓ api-reference-v2.docx (84 pages) · api-reference-v2.pdf
// 이 시나리오에서 지원하는 기능
OpenAPI / Swagger 가져오기
YAML 또는 JSON 스펙 파일 파싱. 엔드포인트 섹션 자동 생성.
다국어 코드 예제
모든 엔드포인트에 curl, Python, JavaScript, Go, Java 예제 자동 생성.
자동 TOC + 인덱스
제목에서 목차와 전체 텍스트 인덱스 생성. PDF에서 클릭 탐색 가능.
기업용 템플릿 지원
로고, 헤더, 푸터가 포함된 .dotx 템플릿 적용.
다중 형식 출력
DOCX, PDF, ODT, HTML로 내보내기.
스펙 변경 자동 업데이트
업데이트된 스펙으로 재실행 — 문서가 점진적으로 업데이트됨.