paper-polish-workflow について
paper-polish-workflowは、学術論文を構成、論理、表現の順に改稿するスキルです。複数の対話モードと参考表現パターンを用い、一貫性やジャーナルのスタイルも確認します。
主な機能
- 01構成から表現まで論文を推敲
- 024種類の対話モード
- 03構成と論理の確認ポイント
- 04節に応じた表現参考の適用
- 05一貫性とジャーナル様式の確認
活用シーン
- 01学術論文を節ごとに改稿
- 02投稿先に合わせた草稿の推敲
- 03つなぎや重複表現の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lylll9436/ paper-polish-workflow-skill --skill paper-polish-workflowインストール後、Claude Code で/paper-polish-workflowを入力して読み込まれたか確認します。
詳細
目的
このスキルは、学術論文を推敲するための体系的なトップダウン型ワークフローを提供します。構成から論理、表現へと順に進め、各判断の段階でユーザーに確認します。表現の選択肢には、その場限りの書き換えではなく、参考資料に基づく学術的なパターンを採用し、投稿に適した、専門的で一貫性のある成果物を実現します。
起動条件
次の依頼があったときに起動します:
- 学術論文をセクションごとに推敲、改訂、改善する
- 润色、精修、逐步改进学术论文
呼び出し例:
- "Polish my paper section by section" / "润色论文"
- "Help me revise my introduction step by step" / "精修论文"
- "Guide me through polishing this draft" / "帮我逐步润色这篇论文"
モード
| モード | デフォルト | 動作 |
|---|---|---|
interactive | はい | 各判断の段階でユーザーに確認しながら、4段階のフローをすべて実行します |
guided | 主要なチェックポイントのみ確認しながら、複数回に分けて処理します | |
direct | デフォルト設定を使用して一度で推敲し、AskUserQuestion をスキップします | |
batch | 複数のセクションに同じ処理を順番に適用します |
デフォルトモード: interactive
モードの推定: 「quickly」または「just fix」が含まれる場合は direct に切り替えます。「step by step」または「逐步」が含まれる場合は interactive を指定します(デフォルトのままです)。
参考資料
必須(常に読み込み)
| ファイル | 目的 |
|---|---|
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.md | 表現を推敲する場合(ステップ3)— AIらしい言い回しがないか確認します |
references/journals/ceus.md | 投稿先ジャーナルが CEUS の場合 |
読み込みルール
- 最初に表現パターンの概要を読み込み、セクションの種類に応じた個別ファイルを選択します。
- 表現を推敲する際(ステップ3)に、アンチAIパターンを読み込みます。
- 投稿先ジャーナルが指定されている場合は、ジャーナルのテンプレートを読み込みます。
- 空間、都市、または計画に関する内容が見つかった場合は、
geography-domain.mdを読み込みます。 - 参考ファイルが見つからない場合は、ユーザーに警告し、機能を限定して処理を続けます。
質問の方針
開始前に、次の点を確認します:
- 投稿先ジャーナル(まだ不明な場合)
- 対象とするセクション
- 希望するモード(起動条件から判断できない場合)
ルール:
- 初回の出力を行う前に、質問は最大3つまでとします。
directモードでは、ユーザーが十分な情報を提供している場合、事前質問を省略します。batchモードでは、項目ごとの質問を省略し、最初の項目の設定を適用します。- Structured Interaction が利用できる場合は使用し、利用できない場合は通常のテキストで質問します。
- 詳細なルールについては、
skill-conventions.md > AskUserQuestion Enforcementを参照してください。
ワークフロー
ステップ1:コンテキストの収集
- 入力形式(ファイルパスまたは貼り付けられたテキスト)を特定します。
- 必須の参考資料(表現パターンの概要)を読み込みます。
- 投稿先ジャーナルを特定し、指定されている場合はジャーナルのテンプレートを読み込みます。
- Read ツールを使用して入力内容を読み取り、主要な数値、主張、データポイントを抽出します。
- ユーザーが例や参考論文を提示した場合は、その場所を特定します(PDF には Read ツールを使用します)。
interactiveまたはguidedモードでは、次に進む前に対象範囲をユーザーに確認します。
ステップ 2:構成と論理の確認
- セクション全体の構成を分析します(例:要旨 = 背景 + ギャップ + 方法 + 結果 + 貢献)。
- ユーザーに確認してもらうため、構成表を提示します。
- 内容を文ごとに分割し、それぞれに論理上の役割を割り当てます。
- ユーザーに確認してもらうため、論理の流れを提示します。
- チェックポイント:表現の作業を始める前に、ユーザーが構成と論理を確認します。
directモードでは、構成と論理の分析を内部で実行し、ステップ 3 に自動的に進みます。
ステップ 3:表現の推敲と一貫性の確認
- セクションに適した表現パターンのリーフと、AI らしい表現を避けるパターンを読み込みます。
- 表現に問題のある文について、AskUserQuestion を使って 2~3 個の選択肢を提示します(
interactiveモード)。または最適な選択肢を自動的に適用します(directモード)。
AskUserQuestion({
question: "Which expression do you prefer for [sentence function]?",
options: [
{ label: "[Expression A]", description: "[full sentence with expression A]" },
{ label: "[Expression B]", description: "[full sentence with expression B]" },
{ label: "[Expression C]", description: "[full sentence with expression C]" }
]
})
- **参考論文の参照:**ユーザーが専門性に疑問を呈した場合は、Read ツールで参考論文を読み込み、表現パターンを抽出します。
- **ジャーナルのスタイル確認:**読み込んだテンプレートにあるジャーナル固有の要件を適用します。
- **繰り返しと一貫性の確認:**表現の重複やつなぎの不足を確認し、修正案を提示します。
- **セクション間の一貫性:**セクション間で数値、用語、主張に一貫性があることを確認します。
ステップ 4:出力
- ジャーナルで必要とされる場合は、ハイライトを作成します(CEUS については
references/journals/ceus.mdを参照してください)。 - 不自然な表現を見つけるため、最終チェックで音読することを提案します。
- 確認済みの内容をすべてまとめて最終版を作成します。
- 語数とともに最終版を提示し、ユーザーに確認してもらいます。
- 確認後に
*_polished.mdに書き込みます(batchモードでは自動的に書き込みます)。 - 語数と、ジャーナルの制約に関する注意事項を報告します。
出力仕様
| 出力 | 形式 | 条件 |
|---|---|---|
polished_text | Markdown ファイル(*_polished.md)または会話での出力 | 必ず出力 |
change_summary | セッション内の Markdown | 必ず出力 |
| 語数 | 整数 | 必ず報告 |
| ジャーナルへの準拠に関する注意事項 | 箇条書き | 対象ジャーナルが指定されている場合 |
例外的なケース
| 状況 | 対応 |
|---|---|
| 専門性に欠ける語句が指摘された | AskUserQuestion で 2~3 個の代替案を提示します。ユーザーが希望する場合は、その語句を使用します |
| 1 回の処理にはセクションが長すぎる | 段落単位の複数回の処理に分割し、段落間の一貫性を保ちます |
| ジャーナルが指定されていない | 一般的な学術スタイルを適用し、出力にその旨を記載します |
| 複数の言語が混在する入力 | 主な言語を判定し、対象言語をユーザーに確認します |
| 参考論文が PDF で提供された | Read ツールで PDF を読み込み、表現の照合に使うスタイルパターンを抽出します |
| 文のつながりが唐突 | AskUserQuestion でつなぎの選択肢を提示します |
| セクション間で繰り返しが検出された | 重複する内容を特定し、どちらを言い換えるか提案します |
| 論理構成の変更が必要 | ステップ 2 に戻り、続行前に構成を再確認します |
フォールバック
| シナリオ | フォールバック |
|---|---|
| 構造化された対話が利用できない | 影響の大きい不足点を扱う自由記述の質問を 1~3 個行い、ワークフローを止めないでください |
| 参考ファイルが見つからない | ファイルが見つからないことを記録し、機能を制限した状態で続行して、ユーザーに警告します |
| 対象ジャーナルが指定されていない | 一度だけ確認します。指定しない場合は、一般的な学術スタイルを使用します |
| 参考論文の PDF を読み取れない | 関連する抜粋を貼り付けるようユーザーに依頼します |
スキル:paper-polish-workflow 規約:references/skill-conventions.md
コメント
Markdown 対応