mcpField
P
paper-spine-translate

paper-spine-translate

github.com/wubing2023ドキュメント6.1k207 回インストール2 週間前に更新
リポジトリ

paper-spine-translate について

paper-spine-translateは、PaperSpineの執筆ワークフロー向けに、中国語の翻訳一式を作成するスキルです。必要なファイルを洗い出して全文を翻訳し、チェック用スクリプトで網羅性を検証します。

主な機能

  1. 01翻訳対象ファイルの一覧化
  2. 02文書と表の全文翻訳
  3. 03マニフェストで状態を管理
  4. 04翻訳チェックの実行
  5. 05翻訳範囲の記録

活用シーン

  1. 01PaperSpineの成果物を中国語に翻訳
  2. 02ワークフロー固有のファイルをすべて翻訳
  3. 03監査前に翻訳の網羅性を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/wubing2023/paperspine --skill paper-spine-translate

インストール後、Claude Code で/paper-spine-translateを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
scripts/
_paper_spine_utils.py
humanize_check.py
translate_guard.py

詳細

PaperSpine Translate

output_language が en で、translation_package が zh の場合は、このブランチを使用します。このブランチの役割は、 paper_rewriting_output/translation_zh/ 以下に必要な中国語翻訳ファイルをすべて作成することです。要約でも、一部のファイルだけでもありません。

運用原則

一部のファイルしか含まない翻訳パッケージは、失敗した出力です。 ワークフローの完了を宣言する前に、オーケストレーターは完全な translation_zh/ を必要とします。このブランチが、翻訳の責任を最初から最後まで担います。

3 段階のフロー

フェーズ 1 — 一覧作成

paper_spine_config.json を読み、workflow を確認します。翻訳が必要なファイルをすべて一覧にします。各項目のステータスを pending として、一覧を translation_zh/manifest.md に記載します。

共通ファイル(両方のワークフロー):

英語のソース中国語の翻訳先
paper_spine_config.jsonpaper_spine_config.zh.md
source_map.mdsource_map.zh.md
reference_materials/source_index.mdreference_materials/source_index.zh.md
research_dossier.mdresearch_dossier.zh.md
exemplar_learning_dossier.mdexemplar_learning_dossier.zh.md
style_profile.mdstyle_profile.zh.md
sota_gap_map.mdsota_gap_map.zh.md
motivation_options_after_research.mdmotivation_options_after_research.zh.md
confirmed_motivation.mdconfirmed_motivation.zh.md
section_blueprints.mdsection_blueprints.zh.md
writing_rationale_matrix.mdwriting_rationale_matrix.zh.md
citation_support_bank.mdcitation_support_bank.zh.md
latex_report.mdlatex_report.zh.md
final_artifact_manifest.mdfinal_artifact_manifest.zh.md
artifact_check.mdartifact_check.zh.md
最終論文(.tex または .md)full_paper_translation.zh.md
—translation_coverage.md

リライトのみで追加されるファイル:

| original_logic_map.md | original_logic_map.zh.md | | rewrite_matrix.md | rewrite_matrix.zh.md | | logic_transfer_audit.md | logic_transfer_audit.zh.md |

ビルドのみで追加されるファイル:

| source_inventory.md | source_inventory.zh.md | | evidence_bank.md | evidence_bank.zh.md | | figure_asset_map.md | figure_asset_map.zh.md | | claim_register.md | claim_register.zh.md |

フェーズ 2 — 翻訳

一覧に記載されたすべてのファイルを翻訳します。以下のルールに従います。

  • 通常の文章ファイル: 全文を翻訳します。LaTeX の引用キー (\cite{...})、ラベル(\label{...})、数式、ファイルパス、生の数値、 URL、コード識別子はそのまま保持します。周囲の文章を翻訳します。
  • 大規模な表形式ファイル(writing_rationale_matrix.md、 citation_support_bank.md、section_blueprints.md、 research_dossier.md、exemplar_learning_dossier.md、 sota_gap_map.md、およびワークフロー固有の表形式ファイル): すべての行とすべてのセルを翻訳します。翻訳後の表は、元の表と同じ行数以上でなければなりません。要約した短縮版の表は出力失敗です。
  • full_paper_translation.zh.md には、タイトル、要旨、すべてのセクションとサブセクションの本文、図のキャプション、表のキャプションと注記、制限事項、結論、謝辞、付録の説明文を含める必要があります。
  • 各ファイルの翻訳後、manifest.md のステータスを pending から translated に更新します。

ファイルが「大きい」ことを理由に、スキップしてはいけません。翻訳の代わりに要約してはいけません。監査では、一部しか翻訳されていないものは不合格となります。

フェーズ 3 — 検証

ガードスクリプトを実行し、PASS を確認します。

python scripts/translate_guard.py paper_rewriting_output --markdown --write

これにより、translation_zh/translate_guard_report.md が生成されます。チェックに失敗した場合はフェーズ 2 に戻り、レポートで指摘されたファイルを修正します。

すべてのソースファイル、中国語の翻訳先、最終ステータス(translated)を記載した translation_coverage.md を作成します。監査に合格するには、すべての項目が translated でなければなりません。

統合

このブランチは、オーケストレーターによって paper-spine-latex の後、paper-spine-audit の前に呼び出されます。オーケストレーターの必須ルートのステップ 14 では、監査を開始する前に翻訳ガードが PASS することが求められます。

コメント