ppw:cover-letter

目的

このスキルは、投稿先ジャーナルのテンプレートを読み込んで貢献内容の説明をジャーナルの対象範囲と目的に合わせ、Ask Strategy を通じて連絡著者の詳細を収集し、論文（ファイルまたは貼り付けられたテキスト）を読んで論文タイトル、主要な貢献、データの利用可能性に関する情報を抽出することで、提出可能な完全な学術論文のカバーレターを作成します。出力は、必須の4つの内容ブロックすべてを含む完全なレターです。（1）貢献内容の説明 — 読み込んだテンプレートに記載されたジャーナルの対象範囲に明確に沿ったもの、（2）データ／コードの利用可能性に関する説明、（3）利益相反の申告、（4）連絡著者の連絡先ブロック。ジャーナルのテンプレートが見つからない場合、このスキルは直ちに処理を拒否し、汎用的な学術文に置き換えることはありません。これは、プロジェクト全体で採用されているジャーナルを考慮したパターンに沿ったものです。

トリガー

ユーザーが次のことを依頼した場合に起動します：

• 論文のカバーレターまたは投稿レターの作成、生成、執筆
• 投稿レターの執筆、カバーレターの生成、投稿レターの作成依頼

呼び出し例：

• 「CEUSへの投稿用にカバーレターを書いてください」
• 「投稿レターを書いてください」
• 「論文のカバーレターを生成してください」
• 「CEUSに投稿するカバーレターを書いてください」
• 「投稿用カバーレターの下書きを手伝ってください」
• 「この論文の投稿レターを作成してください」

モード

モード	デフォルト	動作
direct	はい	1回でレターを生成します。Ask Strategy を使って必要な情報をすべて事前に収集します
batch		サポート対象外 — 各レターには個別の論文情報と著者の詳細が必要です

デフォルトモード： direct。ユーザーが論文とジャーナルを指定します。スキルは不足している情報を確認し、1回の処理で完全なレターを生成します。

参照資料

必須（常に読み込み）

なし。

リーフヒント（条件に応じて読み込み）

ファイル	読み込み条件
references/journals/ceus.md	ユーザーが CEUS を投稿先に指定した場合。貢献内容を合わせるための「目的と対象範囲」および対象範囲のキーワードが記載されています

読み込みルール

• ジャーナルが指定された場合は、references/journals/[journal].md を読み込みます。
• テンプレートが見つからない場合は、直ちに次のメッセージを返して処理を拒否します：「[X] のジャーナルテンプレートが見つかりません。利用可能なもの：CEUS。」
• テンプレートがない場合、汎用的な文章で進めてはいけません。
• 読み込んだテンプレートから「目的と対象範囲」のセクションを抽出します。貢献内容の説明では、そこに直接言及する必要があります。

質問方法

このスキルには4つの入力情報が必要です。トリガーまたは論文の内容にすでに含まれている場合は、該当する質問を省略します。

1. 投稿先ジャーナル — 必須。読み込むテンプレートを決定します。指定がなければ質問します。
2. 論文ファイルまたはテキスト — 必須。論文のタイトルと主要な貢献を抽出するために使用します。指定がなければ、ファイルパスを尋ねるか、テキストの貼り付けを依頼します。
3. 連絡著者の詳細（氏名、メールアドレス、所属機関）— 必須。指定がなければ、まとめて1つの質問で尋ねます。
4. データ／コードの利用可能性 — 任意。データセットまたはコードが一般公開されているかを確認します。公開されている場合は、リポジトリの URL を尋ねます。ユーザーが回答を断る場合、または不明な場合は、「データは一般公開されていません」をデフォルトとします。

ルール：

• 処理を進める前の質問は最大3つまでです。
• 利用可能な場合は構造化された対話を使用し、それ以外の場合は通常のテキストで質問します。
• 連絡著者の詳細が提示されず、ユーザーが提供を断った場合は、[Corresponding Author Name]、[Email]、[Institution] のプレースホルダーを使用します。

ワークフロー

ステップ0：ワークフローメモリの確認

• .planning/workflow-memory.json を読み込みます。ファイルが存在しないか空の場合は、ステップ1に進みます。
• 直近1～2件のログエントリに、ログ内でしきい値以上の回数出現している ppw:cover-letter を含む認識済みパターンがあるか確認します。アルゴリズムの詳細は skill-conventions.md > Workflow Memory > Pattern Detection を参照してください。
• パターンが見つかった場合は、AskUserQuestion を使って次の推奨を提示します。
  • 質問：「よく使われるワークフローが検出されました：[pattern]（N 回出現）。ppw:cover-letter を direct モードで実行しますか？」
  • 選択肢：「はい、続行」／「いいえ、通常どおり続行」
• ユーザーが同意した場合は、モードを direct に設定し、質問方法の質問を省略します。
• ユーザーが同意しない場合、または AskUserQuestion を利用できない場合は、通常モードで続行します。

ステップ 1：コンテキストを収集する

• 不足している入力情報（ジャーナル、論文、著者の詳細、データの利用可能性）について、Ask Strategy を実行します。
• references/journals/[journal].md を読み込みます。見つからない場合は、「Journal template for [X] not found. Available: CEUS.」として拒否します。続行してはいけません。
• 論文がファイルで提供されている場合：Read ツールを使用して読み込み、タイトルと主な貢献を抽出します。
• 論文がテキストとして貼り付けられている場合：貼り付けられた内容からタイトルと主な貢献を抽出します。
• 読み込んだジャーナルテンプレートから「Aims & Scope」セクションを抽出します（貢献の説明では、この内容を直接参照します）。
• ワークフローを記録します： {"skill": "ppw:cover-letter", "ts": "<ISO timestamp>"} を .planning/workflow-memory.json に追記します。ファイルが存在しない場合は [] として作成します。ログの長さが 50 以上の場合は、最も古いエントリを削除します。

ステップ 2：レターを作成する

次の固定レター形式を使用します。

[Date]

The Editor-in-Chief
[Editor Name]
[Journal Name]

Dear [Editor Name],

We submit our manuscript entitled "[Paper Title]" for consideration in [Journal Name].

**Contribution Statement**
[1–2 sentences explicitly referencing journal's stated scope from loaded template]

**Data and Code Availability**
[Repository URLs, or "Data are not publicly available due to [reason]."]

**Conflict of Interest**
The authors declare no conflict of interest.

**Corresponding Author**
[Name]
[Email]
[Institution]

Sincerely,
[Authors]

貢献の説明に関するルール： 読み込んだテンプレートに記載されているジャーナルの対象範囲と目的を明示的に参照する文を 1～2 文で記述します。ジャーナルに合わせた表現を使用します：「本論文は [X] を扱っており、[Journal] が重視する [scope phrase from template] と直接的に合致しています。」一般的な表現（「本論文はこの分野の発展に寄与します」など）は使用しないでください。

データ／コードのブロック： リポジトリの URL が提供されている場合は記載します。提供されていない場合は、「データは [理由が示されている場合はその理由、示されていない場合は理由に関する句を省略] により公開されていません。」と記載します。

利益相反： 常に標準の宣言文「著者らは利益相反がないことを宣言します。」を使用します。

連絡先のブロック： 提供された著者情報を使用します。情報が提供されていない場合は、角括弧付きのプレースホルダーを使用します。

ステップ 3：出力する

• ファイル入力： {input_filename_without_ext}_cover_letter.md に Write ツールを使用して書き込みます。
• 貼り付けられたテキスト入力： 完全なレターを会話内に表示します。
• 出力先をユーザーに伝えます。

出力仕様

出力	形式	条件
cover_letter_md	{input_filename_without_ext}_cover_letter.md にある Markdown ファイル	ファイル入力
cover_letter_text	会話内に表示する完全なレター	貼り付けられたテキスト入力、または Write ツールの失敗時

必須の内容ブロック（すべてのレターに次の 4 つを必ず含めます）：

**Contribution Statement**    ← references journal scope explicitly
**Data and Code Availability** ← links or "not publicly available"
**Conflict of Interest**       ← standard declaration
**Corresponding Author**       ← name, email, institution

注：貢献の説明では、一般的な学術的賛辞ではなく、ジャーナルの対象範囲を明示的に参照する必要があります。

エッジケース

状況	対応
ジャーナルテンプレートが見つからない	「Journal template for [X] not found. Available: CEUS.」として拒否します。一般的な表現で作成してはいけません。
論文ファイルが見つからない、または読み取れない	論文のテキストまたは抄録を貼り付けるようユーザーに依頼します
著者の連絡先情報が提供されず、ユーザーも提供を断った	[Corresponding Author Name]、[Email]、[Institution] のプレースホルダーを使用し、投稿前にユーザーが入力する必要があることを伝えます
データの利用可能性が不明	「データの利用可能性は改訂段階で確認します。」と記載します
連絡担当として複数の著者が記載されている	誰が責任著者かを尋ね、連絡先のブロックには 1 名のみ記載します
テンプレートの「Aims & Scope」セクションの記述が乏しい	テンプレートにある対象範囲に関する記述をすべて使用し、貢献との整合性は概算である可能性があることを伝えます

フォールバック

状況	フォールバック
構造化された対話が利用できない	ジャーナル名と著者情報を、順番に通常のテキストで尋ねます
論文ファイルの読み込みに Read ツールが失敗する	抄録または主な貢献を述べた文を貼り付けるようユーザーに依頼します
Write ツールが失敗する	完全なレターを会話内に表示し、ユーザーに .md ファイルへコピーするよう伝えます
references/journals/ceus.md が見つからない	ジャーナルテンプレートが見つからない旨のメッセージを表示して拒否します。テンプレートなしで作成してはいけません

例

呼び出し：「CEUS への投稿用カバーレターを書いてください」（ファイル my_paper.tex を使用）

1. スキルが references/journals/ceus.md を読み込み、Aims & Scope を抽出します。
2. スキルが my_paper.tex を読み込み、タイトルと主要な貢献を抽出します。
3. スキルが「連絡先欄に記載するお名前、メールアドレス、所属機関をお知らせください」と尋ねます。
4. スキルが「データまたはコードは公開されていますか？公開されている場合は、リポジトリの URL をお知らせください」と尋ねます。
5. スキルがレターを生成し、my_paper_cover_letter.md に書き込みます。

出力の最初の 8 行：

March 2026

The Editor-in-Chief
[Editor Name]
Computers, Environment and Urban Systems

Dear [Editor Name],

We submit our manuscript entitled "Spatiotemporal Analysis of Urban Heat Islands Using Remote
Sensing" for consideration in Computers, Environment and Urban Systems.

**Contribution Statement**
This paper addresses urban heat island detection and mitigation across metropolitan areas, which
aligns directly with CEUS's focus on computational approaches to understanding urban systems and
the built environment.

---

スキル：cover-letter-skill 規約：references/skill-conventions.md