القائمة
문서 파일(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자 처리 완료
| 에러 | 조치 |
|---|---|
| 파일 없음 | 경로 보고 후 종료 |
| 미지원 확장자 | 지원 형식 안내 |
| 도구 미설치 | 설치 명령어 출력 (스크립트가 자동 안내) |
| 빈 결과 | "텍스트를 추출할 수 없습니다 (이미지 전용 문서일 수 있음)" |