Communityライティング&編集github.com

PDF翻訳エージェントスキル

アクティブチャットモデルを使用したPDF翻訳のためのポータブルエージェントスキル。中断再開可能なバッチ処理とレイアウト保持レンダリングを提供します。

PDF翻訳エージェントスキル とは?

このスキルは、AIエージェント(例:Claude Code、Cursor、Codexなど)がPDF文書を翻訳するための完全なワークフローを提供します。アクティブチャットモデルが翻訳エンジンとして機能し、スクリプトはローカルPDFの準備、永続化、レンダリング、検証のみを行います。モデルAPIや認証サービスを呼び出すことはなく、デフォルトの出力は翻訳テキストのみです。対応プラットフォームは、ローカルファイルアクセス、UTF-8の読み書き、Python、シェルアクセス、初回依存関係セットアップの権限がある環境です。ワークフローは、診断、セットアップ、準備(または既存ジョブのステータス確認)、次のバッチ取得、アクティブモデルによる翻訳、送信、レンダリング、検証、最終PDFパスの返却という順序で実行されます。バッチ処理を中断再開可能な設計にしており、翻訳ポリシーやジョブフォーマットのリファレンスを参照することで、正確な翻訳と構造的な整合性を保証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add AIKONG2024/paper-translate-agent-skill

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

PDF翻訳

アクティブチャットモデルが翻訳者です。バンドルされているスクリプトは、ローカルPDF作業の準備、永続化、レンダリング、検証のみを行います。モデル、プロバイダAPI、認証付きサービスを呼び出すことは一切ありません。デフォルトの出力は翻訳テキストのみです。

互換性の境界

開始する前に、ホストがローカルPDFアクセス、UTF-8ファイルの読み書き、Pythonプロセスの実行、シェルアクセス、初回依存関係セットアップの実行権限を持っていることを確認してください。いずれかの機能がない場合は、処理を停止し、次のように報告します:Unsupported host: pdf-translate requires local files, UTF-8 read/write, Python, shell access, and first-run setup. フォールバックを試みないでください。

ワークフロー

リクエストから対象言語とページ範囲を取得します。省略されたソース言語は、最初のテキストを含むページから推測します。どちらかの言語が不明な場合にのみ質問します。書き込み可能な <job-dir> を使用し、以下を実行します:

<python> pdf-translate/scripts/run.py doctor --json
<python> pdf-translate/scripts/run.py setup --json
<python> pdf-translate/scripts/run.py prepare --source <pdf> --job-dir <job-dir> --source-lang <code> --target-lang <code> [--pages <range>] [--output-mode translated|bilingual] [--glossary <file>] [--style academic]
<python> pdf-translate/scripts/run.py next --job-dir <job-dir> --json
<アクティブチャットモデルが batch_path を読み取り、返されたジョブ所有の response_path に対して {"translations":[{"id":"...","text":"..."}]} のみを書き込みます>
<python> pdf-translate/scripts/run.py submit --job-dir <job-dir> --input <batch-response-path>
<next/submit を state が READY_TO_RENDER になるまで繰り返します>
<python> pdf-translate/scripts/run.py render --job-dir <job-dir> --json
<python> pdf-translate/scripts/run.py validate --job-dir <job-dir> --json

既存のジョブの場合は、prepare の代わりに <python> pdf-translate/scripts/run.py status --job-dir <job-dir> --json を実行し、その後その次のアクションから続行します。次の決定ツリーに正確に従ってください:doctor/setup -> prepare or status -> next -> アクティブモデル翻訳 -> submit -> 繰り返し -> render -> validate -> PDFを返す。render は出力をステージングするだけです。validate はすべてのブロッキング構造チェックが合格した後に公開します。成功した validate によって報告された、競合のない最終的なPDFパスと、言語に関する警告、および最初/中間/最後のプレビューペアを視覚検査用にのみ返します。翻訳前に 翻訳ポリシー を、ジョブJSONを処理する前に ジョブフォーマット を読んでください。作業が完了前に停止した場合は、常に <job-dir> を報告し、後続のタスクがトランスクリプト履歴ではなくファイルから再開できるようにします。

関連スキル