mcpField
H
hwp

hwp

github.com/pitzcarraldoドキュメント094 回インストール6 週間前に更新
リポジトリ

hwp について

hwpは、韓国語のHangul Word Processor文書を読み、その内容に基づく回答を支援するスキルです。pyhwp2mdでテキストを抽出し、パッケージ実行ツールの選択や大きな出力の扱い方を定めています。

主な機能

  1. 01HWP・HWPXファイルの読み取り
  2. 02pyhwp2mdによる内容抽出
  3. 03利用可能なPython実行ツールの選択
  4. 04大きな出力の一時ファイル保存
  5. 05画像・リンク・書式の制限を明記

活用シーン

  1. 01HWPファイル内の情報検索
  2. 02HWPX文書に基づく質問への回答
  3. 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.hwpxXML ベースの形式(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

その後、ユーザーの質問に回答するために、必要に応じてファイルを分割して読み込みます。

技術要件

要件バージョン備考
Python3.10+必須
uv/pipx/pipLatestいずれか1つ

制限事項

  • 画像:まだサポートされていません
  • リンク:部分的なサポート
  • 書式設定:スタイル、色、フォントは保持されません

参考資料

コメント