paper-spine-translate について
paper-spine-translateは、PaperSpineの執筆ワークフロー向けに、中国語の翻訳一式を作成するスキルです。必要なファイルを洗い出して全文を翻訳し、チェック用スクリプトで網羅性を検証します。
主な機能
- 01翻訳対象ファイルの一覧化
- 02文書と表の全文翻訳
- 03マニフェストで状態を管理
- 04翻訳チェックの実行
- 05翻訳範囲の記録
活用シーン
- 01PaperSpineの成果物を中国語に翻訳
- 02ワークフロー固有のファイルをすべて翻訳
- 03監査前に翻訳の網羅性を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wubing2023/ paperspine --skill paper-spine-translateインストール後、Claude Code で/paper-spine-translateを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlscripts/_paper_spine_utils.pyhumanize_check.pytranslate_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.json | paper_spine_config.zh.md |
source_map.md | source_map.zh.md |
reference_materials/source_index.md | reference_materials/source_index.zh.md |
research_dossier.md | research_dossier.zh.md |
exemplar_learning_dossier.md | exemplar_learning_dossier.zh.md |
style_profile.md | style_profile.zh.md |
sota_gap_map.md | sota_gap_map.zh.md |
motivation_options_after_research.md | motivation_options_after_research.zh.md |
confirmed_motivation.md | confirmed_motivation.zh.md |
section_blueprints.md | section_blueprints.zh.md |
writing_rationale_matrix.md | writing_rationale_matrix.zh.md |
citation_support_bank.md | citation_support_bank.zh.md |
latex_report.md | latex_report.zh.md |
final_artifact_manifest.md | final_artifact_manifest.zh.md |
artifact_check.md | artifact_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 することが求められます。