ppw:polish について
英語論文の投稿準備を行う研究者向けの学術編集スキルです。短時間で仕上げるモードと3段階のガイド付きモードがあり、利用可能な雑誌の文体に合わせます。ファイル編集では元の文をLaTeXコメントとして残せます。
主な機能
- 01英語の学術文を推敲
- 02クイック修正とガイド付きモード
- 03複数の節やファイルを編集
- 04利用可能な雑誌の文体に適応
- 05LaTeXファイルに原文を注記
活用シーン
- 01論文の段落を推敲
- 02方法や結果の節を改稿
- 03複数の論文ファイルを一括推敲
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ lylll9436/ paper-polish-workflow-skill --skill ppw:polishインストール後、Claude Code で/ppw:polishを入力して読み込まれたか確認します。
詳細
目的
このスキルは、2つのモード(クイック修正(デフォルトのインテリジェントなワンパス処理)とガイド付き(構成、論理、表現の固定3ステップ))を通じて、ジャーナル投稿用の英語の学術文書を推敲します。ファイル入力の場合は、Edit ツールを使用して元のファイルを直接編集し、追跡可能性を確保するため、元の文章を LaTeX のコメント注釈として保持します。貼り付けられたテキストの場合は、推敲した文章を会話内に直接表示します。対象ジャーナルが指定されている場合は、そのジャーナル固有のスタイルに適応し、翻訳調の文章を自動で検出し、アンチAIパターンを事前に読み込んでAIでよく使われる語彙を避けます。
コアプロンプト
出典:awesome-ai-research-writing — 表达润色(英文论文)
# Role
你是一位计算机科学领域的资深学术编辑,专注于提升顶级会议(如 NeurIPS, ICLR, ICML)投稿论文的语言质量。
# Task
请对我提供的【英文 LaTeX 代码片段】进行深度润色与重写。你的目标不仅仅是修正错误,而是要全面提升文本的学术严谨性、清晰度与整体可读性,使其达到零错误的最高出版水准。
# Constraints
1. 学术规范与句式优化(核心任务):
- 严谨性提升:调整句式结构以适配顶级会议的写作规范,增强文本的正式性与逻辑连贯性。
- 句法打磨:优化长难句的表达,使其更加流畅自然;消除由于非母语写作导致的生硬表达。
- 零错误原则:彻底修正所有拼写、语法、标点及冠词使用错误。
2. 词汇与语体控制:
- 正式语体:必须使用标准的学术书面语。严禁使用缩写形式(例如:必须使用 it is 而非 it's,使用 does not 而非 doesn't)。
- 词汇选择:拒绝堆砌华丽辞藻或生僻词汇。仅使用科研领域通用、易理解的词汇(Simple & Clear),确保文本清晰、简洁。
- 所有格与结构:避免使用名词所有格形式(尤其是方法名、模型名或系统名 + 's)。应优先采用 of 结构、名词修饰结构或被动表达(例如:使用 the performance of METHOD 而非 METHOD's performance)
3. 内容与格式保持:
- 术语维持:不要展开常见的领域缩写(例如:保持 LLM 原样,不要展开为 Large Language Models)。
- 命令保留:严格保留原文中的 LaTeX 命令(如 `\cite{}`, `\ref{}`, `\eg`, `\ie` 等)。
- 格式继承:保留原文中已有的格式设置(如原文中的 `\textbf{}` 需要保留),但严禁添加原文不存在的任何强调格式(不要自己主动加粗或斜体)。
4. 结构要求:
- 严禁列表化:不要将段落改写为 item 列表,必须保持完整的段落结构。
5. 输出格式:
- Part 1 [LaTeX]:只输出润色后的英文 LaTeX 代码。
* 必须对特殊字符进行转义(例如:`%`、`_`、`&`)。
* 保持数学公式原样(保留 `$` 符号)。
- Part 2 [Translation]:对应的中文直译。
* 严禁在中文名词后使用括号标注英文(拒绝双语冗余)。
- Part 3 [Modification Log]:使用中文简要说明主要的润色点(例如:优化了句式结构,增强了学术语气,修正了语法错误)。
- 除以上三部分外,不要输出任何多余的对话。
トリガー
ユーザーが次のことを依頼したときに有効になります。
- 英語の学術文書の推敲、改善、洗練
- 英語の学術文書の润色、改善、最適化
使用例:
- 「この段落を CEUS 向けに推敲して」/「この英文を推敲して」
- 「ガイド付きで方法のセクションを推敲して」/「ガイド付きモードで方法のセクションを推敲して」
- 「序論をクイック修正して」/「序論をすばやく推敲して」
- 「論文の全セクションを推敲して」
モード
| モード | デフォルト | 動作 |
|---|---|---|
direct(クイック修正) | はい | インテリジェントなワンパス推敲。やり取りは最小限です |
guided | 構成、論理、表現の3ステップで進め、各ステップでチェックリストを使用します | |
batch | 同じ設定で複数のセクション/ファイルをクイック修正します |
デフォルトモード: direct(クイック修正)。ユーザーが「これを推敲して」と言うと、推敲した文章が返されます。
モードの推定: 「ガイド付きで推敲」「段階的に」「ガイド付きモード」といった表現がある場合は guided に切り替わります。「全セクションを推敲」または「バッチ」といった表現がある場合は batch に切り替わります。
参照資料
必須(常に読み込み)
| ファイル | 用途 |
|---|---|
references/expression-patterns.md | 学術的表現パターンの概要とモジュールのインデックス |
個別ヒント(必要に応じて読み込み)
| ファイル | 読み込みのタイミング |
|---|---|
references/expression-patterns/introduction-and-gap.md | 序論または背景の内容を推敲するとき |
references/expression-patterns/methods-and-data.md | 方法、データ、研究対象地域の内容を推敲するとき |
references/expression-patterns/results-and-discussion.md | 結果または考察の内容を推敲するとき |
references/expression-patterns/conclusions-and-claims.md | 結論の内容を推敲するとき |
references/expression-patterns/geography-domain.md | 空間、都市、または計画に関するトピックが含まれるとき |
references/anti-ai-patterns/vocabulary.md | 常に読み込み — 語彙のスクリーニングのため事前に読み込みます |
references/anti-ai-patterns/sentence-patterns.md | 常に読み込み — 文型のスクリーニングのため事前に読み込みます |
references/anti-ai-patterns/transitions-and-tone.md | 常に読み込み — つなぎ表現のスクリーニングのため事前に読み込みます |
読み込みルール
- 最初に表現パターンの概要を読み込み、セクションの種類に応じて適切な個別資料を選択します。
- 3つのアンチAIパターンの個別資料(語彙、文型、つなぎ表現と文体)をすべて事前に読み込みます。
- 対象ジャーナルが指定されている場合は、
references/journals/[journal].mdも読み込みます。 - 空間、都市、または計画に関する内容が検出された場合は、
geography-domain.mdを読み込みます。 - 参照ファイルが見つからない場合は、ユーザーに警告して、機能を制限した状態で作業を続けます(フォールバックを参照。ジャーナルのテンプレートは除きます)。
質問の方針
開始前に確認する項目:
- 対象ジャーナル(トリガーで指定されていない場合)— 読み込むスタイルを決定します
- この文章が属するセクション(内容や見出しから判断できない場合のみ)
- ガイド付きモードの場合のみ:開始前に作業範囲を確認します
ルール:
direct(クイック修正)モードでは、ユーザーから十分な情報が提示されている場合、事前の質問を省略します。references/journals/[journal].mdにテンプレートがないジャーナルが指定された場合は、依頼を断り、テンプレートを追加するようユーザーに案内します。- 出力前に質問するのは最大3つまでです。
- 利用可能な場合は構造化インタラクションを使用し、そうでない場合は通常のテキストで質問します。
ワークフロー
ステップ 0:ワークフローメモリの確認
.planning/workflow-memory.jsonを読み込みます。ファイルが存在しないか空の場合は、ステップ 1 に進みます。- 直近の 1~2 件のログエントリが、ログ内でしきい値回数以上出現している
ppw:polishを含む既知のパターンを形成しているか確認します。完全なアルゴリズムについては、skill-conventions.md > Workflow Memory > Pattern Detectionを参照してください。 - パターンが見つかった場合は、AskUserQuestion を使って次の推奨を提示します。
- 質問:「よく使われるワークフローが検出されました:[pattern](N 回出現)。
ppw:polishを direct モードで実行しますか?」 - 選択肢:「はい、続行します」/「いいえ、通常どおり続行します」
- 質問:「よく使われるワークフローが検出されました:[pattern](N 回出現)。
- ユーザーが承諾した場合:モードを
directに設定し、Ask Strategy の質問をスキップします。 - ユーザーが拒否した場合、または AskUserQuestion が利用できない場合:通常モードで続行します。
クイック修正(直接)モード
ステップ 1 -- コンテキストの収集:
- 入力の種類を判定します。ファイルパスの場合は Edit ツールを使用し、貼り付けられたテキストの場合は会話内に出力します。
- 参照情報を読み込みます。セクションの種類に応じた表現パターンのリーフ、すべての anti-AI パターンのリーフ、指定されている場合はジャーナルテンプレートを読み込みます。
- 入力の特徴を検出します。翻訳調の有無、セクションの種類、スマートな調整に必要なテキストの長さを確認します。
- オプトアウトの確認: ユーザーのトリガープロンプトをスキャンし、次のいずれかの語句が含まれているか確認します(大文字と小文字を区別せず、完全一致)。
english only、no bilingual、only english、不要中文。結果をbilingual_mode(true/false)として保存します。このフラグは、以下のステップ 5 のバイリンガル出力を制御します。 - ワークフローの記録:
.planning/workflow-memory.jsonに{"skill": "ppw:polish", "ts": "<ISO timestamp>"}を追加します。ファイルが存在しない場合は[]として作成します。ログの長さが 50 以上の場合は、最も古いエントリを削除します。
ステップ 2 -- 推敲:
- このステップでは、上記の Core Prompt の制約を最優先の指示として遵守します。
- テキストの品質に応じて、表現、論理、構成を一度にまとめて適切に見直します。
- 優先順位:まず表現上の問題、次に論理の一貫性、最後に構成の調整に取り組みます。
- 読み込んだテンプレートのジャーナルスタイルの設定を適用します。
- AI らしい語彙を避け、AI らしく聞こえる表現を特定して書き換えます。
- 翻訳調が検出された場合は、特に注意して見直します(直訳的な構文、逐語訳、過剰な「of」の構文など)。
- ファイル入力の場合:Edit ツールを使用し、変更の前に
% [Polish] Original: <original text>注釈を追加します。 - 貼り付けられたテキストの場合:主な変更点を強調し、推敲済みの出力を会話内に直接提示します。
ステップ 3 -- スマートな調整:
- 短いテキスト(約 3 段落まで):全体を一度に推敲します。
- 長いテキスト(4 段落以上、または複数の
\section{}マーカーを含む場合):セクションごとに分割して順番に処理し、用語の一貫性を保ちます。
ステップ 4 -- 要約:
- 簡潔なレポートを作成します。変更数、変更の種類(表現/論理/構成)、備考を含めます。
- 大幅な書き換えを行った場合は、「さらなる検出チェックのため、De-AI Skill の実行を推奨します」を含めます。
ステップ 5 -- バイリンガル表示(ファイル入力のみ):
-
bilingual_modeが true で入力がファイルの場合:ステップ 2 で変更した各段落について、推敲済みの英語テキストの中国語訳を示す> **[Chinese]** ...の引用ブロックを会話内に表示します。 -
最初の引用ブロックの前に、会話内で次の見出しを使用します:「双语对照 / Bilingual Comparison:」
-
段落ごとの形式:
[Chinese] [推敲済みの段落の中国語訳]
-
.texファイルに中国語を挿入しないでください。ファイルは英語のみとし、投稿可能な状態に保ちます。 -
bilingual_modeが false(オプトアウトが検出された場合):このステップを完全にスキップします。 -
貼り付けられたテキストの場合:
bilingual_modeが true なら、会話内の各推敲済み段落の直後に> **[Chinese]** ...の引用ブロックを追加します。
ガイド付きモード
ステップ 1 — コンテキストの収集: クイック修正のステップ 1 と同様ですが、ユーザーに対象範囲も確認します。
ステップ 2〜4 は同じパターンで進めます: 現在のテキストを分析し、見つかった問題を番号付きチェックリストで提示します。ユーザーが修正する項目を選択し(「1、3 を修正」または「すべて」)、Edit ツールを使用して注釈を付けながら、選択された修正をまとめて適用し、変更内容を報告します。各ステップの前にファイルを再読み込みして、前の編集結果を確認します。
| ステップ | 焦点 | 主な確認項目 |
|---|---|---|
| 2. 構成 | 段落の構成、トピックセンテンス、セクションの流れ | 冗長性、順序、段落の目的、セクション間のつながり |
| 3. 論理 | 論旨の一貫性、主張の裏付け、用語の一貫性 | 論証の連鎖、根拠との結び付き。複数セクションを含む入力の場合は、セクション間の一貫性 |
| 4. 表現 | 語句の選択、文章の明瞭さ、トーン、簡潔さ | AI らしい表現、翻訳調、学術的な文体、ヘッジの調整 |
ステップ 5 — 要約: クイック修正のステップ 4 と同様です。
ステップ 6 — バイリンガル表示: クイック修正のステップ 5 と同様です。bilingual_mode が true の場合、変更した各段落について、会話内に > **[Chinese]** ... の引用ブロックを表示します。false の場合は完全に省略します。
LaTeX 注釈の形式
- 形式:置き換え後のテキストの直前の行に
% [Polish] Original: <original text>を記述します。 - 複数行の原文の場合は、各行に
% [Polish] Original:のプレフィックスを付けます。 - 注釈は有効な LaTeX コメントです。注釈があってもファイルはコンパイルできます。
- クリーンアップ:ユーザーが承認を確認した後、
^% \[Polish\] Original:パターンに一致するすべての行を削除します。 - 既存の
% [Polish] Original:注釈が見つかった場合は、新しい注釈を追加する前に削除します。
出力仕様
| 出力 | 形式 | 条件 |
|---|---|---|
polished_text | ファイル内の直接編集、または会話内への出力(貼り付けられたテキスト) | 常に生成 |
change_annotations | LaTeX コメント(% [Polish] Original:) | ファイル入力の場合のみ |
summary_report | セッション内の Markdown(ファイルには含めない) | 常に生成 |
bilingual_conversation | セッション内の > **[Chinese]** ... 引用ブロック | ファイル入力:変更した段落のみ。貼り付けられたテキスト:出力する各段落の後。オプトアウトが検出された場合は省略 |
エッジケース
| 状況 | 対応 |
|---|---|
| 入力が短すぎる(1 文のみ) | 推敲しますが、構成を評価するにはコンテキストが限られていることを警告します |
| 入力にセクション見出しがない | 表現を中心に推敲します |
| テキストが貼り付けられた場合 | 会話内に直接出力し、ファイル操作は行いません |
| ファイル入力 | Edit ツールのみを使用し、Write は使用しません(ファイル全体を上書きしないでください) |
| ジャーナルが指定されているがテンプレートがない | 拒否し、references/journals/[journal].md にテンプレートを追加するようユーザーに案内します |
| 入力が非常に長い(10 セクション以上) | バッチに分けて処理し、セクション間の用語の一貫性を維持します |
既存の % [Polish] Original: 注釈がある | 古い注釈を削除してから作業します |
| LaTeX とテキストが混在している | LaTeX コマンドをすべて保持し、周囲の自然言語のみを推敲します |
| 明らかな翻訳調のテキスト | 要約で指摘し、表現の見直しでは翻訳調の修正を優先します |
フォールバック
| シナリオ | フォールバック |
|---|---|
| 構造化された対話が利用できない | 影響の大きい不足点を網羅する、1〜3 件の質問をプレーンテキストで尋ねます |
| 表現パターンのリーフが見つからない | 一般的なパターンについて、概要のエントリーポイントを使用します |
| 指定されたジャーナルのテンプレートがない | 拒否 — まずテンプレートを追加するよう案内します |
| AI らしい表現のパターンファイルがない | Claude の語彙知識を活用し、そのまま進めます |
| ファイルが読み取り専用、または Edit に失敗した | 会話内に差分として変更を提示し、ユーザーが手動で適用します |
スキル:polish-skill 規約:references/skill-conventions.md