hwp について
hwpは、韓国語のHangul Word Processor文書を読み、その内容に基づく回答を支援するスキルです。pyhwp2mdでテキストを抽出し、パッケージ実行ツールの選択や大きな出力の扱い方を定めています。
主な機能
- 01HWP・HWPXファイルの読み取り
- 02pyhwp2mdによる内容抽出
- 03利用可能なPython実行ツールの選択
- 04大きな出力の一時ファイル保存
- 05画像・リンク・書式の制限を明記
活用シーン
- 01HWPファイル内の情報検索
- 02HWPX文書に基づく質問への回答
- 03コンテキストに収まらない抽出結果の処理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ pitzcarraldo/ skills --skill hwpインストール後、Claude Code で/hwpを入力して読み込まれたか確認します。
同梱ファイルscripts/html_extractor.pyscripts/hwp_reader.py
詳細
HWP/HWPX 文書リーダー
このスキルは、韓国語のハングル・ワードプロセッサーファイル(.hwp、.hwpx)を読み込み、pyhwp2md を使用して、その内容に基づく回答を準備します。
対応フォーマット
| フォーマット | 拡張子 | 説明 |
|---|---|---|
| HWP | .hwp | バイナリ形式(HWP 5.0 以降) |
| HWPX | .hwpx | XML ベースの形式(Hangul 2014 以降) |
ワークフロー
重要:
uvx、pipx、pipのコマンドを直接実行しないでください。正しいツールを自動的に検出して使用する、以下の完全な bash スクリプトを必ず使用してください。
1. ファイルの存在を確認する
ls -la "[file-path]"
2. コンテンツを検出して抽出する
次のスクリプトをそのまま実行してください(変更したり、個別のコマンドを実行したりしないでください)。
TOOL=$(command -v uvx >/dev/null 2>&1 && echo "uvx" || (command -v pipx >/dev/null 2>&1 && echo "pipx" || (command -v pip >/dev/null 2>&1 && echo "pip" || echo "none"))) && case $TOOL in uvx) uvx pyhwp2md "[file-path]" ;; pipx) pipx run pyhwp2md "[file-path]" ;; pip) pip install -q pyhwp2md && pyhwp2md "[file-path]" ;; *) echo "Error: No Python package runner found" ;; esac
3. 出力サイズに応じて処理する
コンテンツがコンテキストに収まる場合:標準出力の内容をそのまま使用して、ユーザーからの質問に回答します。
コンテンツがコンテキストに収まらない場合:次のスクリプトを使用して、一時ファイルに保存します。
TOOL=$(command -v uvx >/dev/null 2>&1 && echo "uvx" || (command -v pipx >/dev/null 2>&1 && echo "pipx" || (command -v pip >/dev/null 2>&1 && echo "pip" || echo "none"))) && case $TOOL in uvx) uvx pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; pipx) pipx run pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; pip) pyhwp2md "[file-path]" -o /tmp/extracted_content.md ;; esac
その後、ユーザーの質問に回答するために、必要に応じてファイルを分割して読み込みます。
技術要件
| 要件 | バージョン | 備考 |
|---|---|---|
| Python | 3.10+ | 必須 |
| uv/pipx/pip | Latest | いずれか1つ |
制限事項
- 画像:まだサポートされていません
- リンク:部分的なサポート
- 書式設定:スタイル、色、フォントは保持されません
参考資料
コメント
Markdown 対応