메뉴
문서 파일(HWP/HWPX/PDF/DOCX/XLSX/PPTX)의 텍스트를 추출해 컨텍스트에 로드합니다. docs-business/ 폴더의 파일이나 .hwp/.hwpx/.pdf/.docx/.xlsx/.pptx 파일이 언급될 때, 또는 문서 내용을 검토/분석해야 할 때 반드시 사용.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Configure, observe, and recover Discord AI jobs from the ADK workspace with either Codex or Claude. Use for Discord setup, background-job status, live activity, stalled-job diagnosis, reboot recovery, idle rotation, or session history.
Codex 또는 Claude로 실행되는 Discord 백그라운드 작업의 설정·상태·실시간 활동·재부팅 복구를 ADK 워크스페이스에서 관리합니다.
세션 변경사항을 분석해 verify-* 스킬 드리프트를 탐지하고 자동 생성/업데이트합니다. issue-driven-development Sync 단계, 새 패턴/규칙 도입 후, PR 전 검증 스킬 커버리지 확인 시 반드시 사용. /manage-skills로 호출.
원요청 무결성과 세션 바인딩 하네스의 원문 해시체인, 완전 범위 추적, 서명 권한, 2회 Clean 결박, Claude Code/Codex 등록·동등성을 결정론으로 검증합니다. request-contract·session-inject 코어/어댑터·설정·스키마·review-pass를 수정한 뒤, Review/Post-test Review 및 커밋 전에 반드시 사용합니다.
등록된 모든 verify-* 스킬을 순차 실행해 통합 검증 보고서를 생성합니다. 기능 구현 후, PR 전, 코드 리뷰 시, issue-driven-development Review/Post-test Review 단계마다 반드시 사용. /verify-implementation으로 호출.
기존 제품의 경로·진입점·내비게이션·사용자 여정·운영 표면이 기능 추가 뒤에도 유지되는지 기준 버전과 보존 계약으로 검증합니다. 기존 프로젝트의 기능 추가·통합·리팩터링 후, planning/integration 리뷰와 release 전에 반드시 사용합니다.
| name | read-doc |
| description | 문서 파일(HWP/HWPX/PDF/DOCX/XLSX/PPTX)의 텍스트를 추출해 컨텍스트에 로드합니다. docs-business/ 폴더의 파일이나 .hwp/.hwpx/.pdf/.docx/.xlsx/.pptx 파일이 언급될 때, 또는 문서 내용을 검토/분석해야 할 때 반드시 사용. |
| tier | T0 |
| argument-hint | <file-path-or-glob> |
| input_schema | {"file":{"type":"string","required":true,"description":"File path to read"}} |
문서 파일의 텍스트를 추출해 분석할 수 있도록 컨텍스트에 로드합니다.
| 확장자 | 방법 | 사전 설치 |
|---|---|---|
.hwp | hwp5html → XHTML → 텍스트 | pip install pyhwp |
.hwpx | PrvText.txt 추출 + XML fallback | 없음 |
.pdf | pdftotext -layout | sudo dnf install poppler-utils |
.docx | python-docx | pip install python-docx |
.xlsx | openpyxl | pip install openpyxl |
.pptx | OOXML <a:t> 파싱 | 없음 |
.txt / .md | Read 도구 직접 사용 | 없음 |
$ARGUMENTS가 없으면 사용법 안내 후 종료:
"Usage: /read-doc <file-path> (glob 지원: /read-doc /path/*.hwp)"
glob(*) 또는 디렉토리인 경우 지원 확장자 파일 목록으로 확장. 알파벳순 정렬.
docs-business HWP/HWPX 파일은 사전 추출된 .txt 사이드카가 있을 수 있음:
SIDECAR="${FILE%.*}.txt"
[ -s "$SIDECAR" ] && cat "$SIDECAR" && exit 0
사이드카가 있으면 Read 도구로 직접 읽음 (훨씬 빠름).
python .agents/skills/read-doc/scripts/extract_doc.py "$FILE"
HWP 파일 5MB 이상이면 5~15초 소요 — 시작 전 사용자에게 안내.
📄 **<파일명>** (<확장자>, <N>자)
경로: <절대경로>
---
<추출된 텍스트>
15,000자 초과 시 앞 15,000자만 표시:
(... 이하 생략. 전체 ${N}자)
파일 여러 개면 ---로 구분, 마지막에:
총 N개 파일, M자 처리 완료
| 에러 | 조치 |
|---|---|
| 파일 없음 | 경로 보고 후 종료 |
| 미지원 확장자 | 지원 형식 안내 |
| 도구 미설치 | 설치 명령어 출력 (스크립트가 자동 안내) |
| 빈 결과 | "텍스트를 추출할 수 없습니다 (이미지 전용 문서일 수 있음)" |