mcpField
A
add-journal

add-journal

github.com/aperivueドキュメント353111 回インストール1 日前に更新
リポジトリ

add-journal について

add-journal は、投稿規定をもとに学術誌のプロフィールを作成するスキルです。詳細な write-paper 用と簡潔な find-journal 用を生成し、確認手順と公開・ユーザー個人用の保存先を備えています。

主な機能

  1. 01投稿規定情報の抽出
  2. 022種類のプロフィール生成
  3. 03既存プロフィールの確認
  4. 04公開用と個人用の保存先を分離
  5. 05書き込み前の確認手順

活用シーン

  1. 01執筆用資料への学術誌追加
  2. 02学術誌検索プロフィールの準備
  3. 03個人用プロフィールの管理

インストール

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

$npx skills add https://github.com/aperivue/medsci-skills --skill add-journal

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

同梱ファイルreferences/write_paper_profile_template.mdskill.yml

詳細

Journal Skill の追加

各ジャーナルの投稿規定をもとに、ジャーナルごとに 2 つのプロファイルを生成します。詳細な論文執筆用プロファイル(約 100~150 行)と、簡潔なジャーナル検索用プロファイル(約 30 行)です。プロファイルの内容は英語で記述してください。ライブラリは共有されています。

主要ディレクトリ

プロファイルは 2 つの階層のいずれかに保存します。抽出を始める前に、フェーズ 0 で保存先を選択してください。

  • 公開(配布対象。${CLAUDE_SKILL_DIR}/../find-journal/POLICY.md に記載された検証基準を満たす必要があります):
    • 論文執筆用:${CLAUDE_SKILL_DIR}/../write-paper/references/journal_profiles/
    • ジャーナル検索用:${CLAUDE_SKILL_DIR}/../find-journal/references/journal_profiles/
  • ユーザー限定の非公開(ユーザーごとに管理され、git にはプッシュされません):
    • 論文執筆用:$HOME/.claude/private-journal-profiles/write-paper/
    • ジャーナル検索用:$HOME/.claude/private-journal-profiles/find-journal/

非公開から公開への昇格についても、POLICY.md に記載されています。


フェーズ 0:入力情報の収集

  • 必須: ジャーナルの正式名称、対象階層(public または private)。
  • 強く推奨: 投稿規定の URL。ユーザーが名称しか提示していない場合は、作業を進める前にこの URL を尋ねてください。これが主要なデータソースです。
  • 任意: 分野の焦点(3.1 で使用)、階層の推定(Q1/Q2/Q3)、ISSN。

このスキルでは、ジャーナルの信頼性を判断しません。なじみのない出版社の場合は、プロファイルを作成する前に DOAJ への加盟(オープンアクセス誌の場合)とインデックス登録状況を確認し、その結果をユーザーに伝えてください。

公開と非公開の対象選択

ユーザーが対象階層を指定していない場合は、先に進む前に尋ねてください。

  • ユーザーが深い専門知識を持つ分野以外のジャーナルは、デフォルトで private にしてください。非公開プロファイルは公開基準の各項目をすべて満たす必要はありませんが、ジャーナル独自の投稿規定ページを引き続き主要な情報源としてください。関連する別のジャーナルから推測したり、出版社系列の AI ポリシーを流用したりしないでください。
  • public にできるのは、以下のすべてを満たす場合に限ります:
    1. ユーザーがプロファイルを上流に寄稿する意向である。
    2. ユーザーがジャーナルのホームページと投稿規定ページを実際に確認し、各項目を最新の情報源と照合できる、または該当箇所を貼り付けられる。
    3. AI ポリシーの文言が、姉妹誌からの推測ではなく、ジャーナルまたは出版社独自のポリシーページから転記されている。
    4. ユーザーがコミット前に ../find-journal/POLICY.md の昇格チェックリストを完了済み、または完了する予定である。

対象が public でも、ユーザーが (2) と (3) を確認できない場合は、対象を private に変更し、チェックリストの条件を満たした後で昇格できることを伝えてください。


フェーズ 1:重複の確認

抽出を始める前に、以下を実施してください。

  1. 4 つすべてのディレクトリを glob します:
    ${CLAUDE_SKILL_DIR}/../write-paper/references/journal_profiles/*.md
    ${CLAUDE_SKILL_DIR}/../find-journal/references/journal_profiles/*.md
    $HOME/.claude/private-journal-profiles/write-paper/*.md
    $HOME/.claude/private-journal-profiles/find-journal/*.md
    
  2. 正規化した名称(ルール 4.1)と完全一致するファイル名があるか確認します。
  3. 既存のプロファイルを grep し、ジャーナルの一般的な略称(例:「JCO」)を検索します。

見つかった場合はパスを報告してください。1 つのディレクトリにのみ存在する場合は、不足している方だけを作成することを提案してください。両方に存在する場合は、更新するか中止するかを提案してください。ユーザーの指示なしにフェーズ 2 へ進んではいけません。


フェーズ 2:データ抽出

  • パス A(WebFetch が利用可能): 投稿規定の URL を取得して解析します。ページへのログインが必要な場合、JavaScript への依存が大きい場合、または情報が少ない場合は、パス B に切り替えてください。
  • パス B: 投稿規定の内容(または該当箇所)を貼り付けるようユーザーに依頼してください。取得に失敗した場合は、必ずその旨を伝えてください。
抽出チェックリスト

特定できない項目には [TODO: verify at journal site] と記入してください。

投稿先選定プロファイルの場合: 正式名称、略称、出版社、ISSN(冊子版/オンライン版)、 発行頻度、JCR の年を添えたインパクトファクター、OA モデル、採択率、査読方式、語数・ 抄録・参考文献・図の上限を含む原稿の種類、抄録の形式(構造化の有無、見出し、 語数制限)、原著論文に必要なセクション、統計要件(p 値の表記、CI、効果量)、図の 仕様(DPI、形式、カラー、最大数)、カバーレターの要件。

投稿先検索プロファイルの場合: スコープを説明する1~2文、カンマ区切りの スコープキーワード15~20個、受け付ける論文の種類、分類(分野内のランクQ1/Q2、OA、 分野)。

--- ゲート 1:メタデータの確認 ---

抽出したメタデータを、構造化された要約として提示します。次の点を尋ねてください。

  1. 「この情報は正確ですか?修正点はありますか?」
  2. 「このジャーナルでよくある不採択の理由は何ですか?」(抽出できない場合)
  3. 「この分野の類似ジャーナルと比べて、このジャーナルをどのように位置づけますか?」

ユーザーの情報が出典と矛盾する場合は、相違点を提示して確認してください。ユーザーが確認または修正するまで、フェーズ3に進まないでください。


フェーズ3:プロファイルの作成

3.1 参照テンプレートの読み込み

形式の参考として、類似分野の既存の投稿先選定プロファイルを1つ読み込みます。

分野読み込むテンプレート
放射線医学Radiology.md または European_Radiology.md
総合医学The_BMJ.md または JAMA.md
医学教育JMIR_Medical_Education.md
AI/デジタルヘルスnpj_Digital_Medicine.md または JMIR.md
IVR/インターベンショナルCVIR.md または JVIR.md
外科Annals_of_Internal_Medicine.md
その他The_BMJ.md(汎用テンプレートとして最も無難)

また、簡潔な形式の参考として、既存の投稿先検索プロファイルを1つ読み込みます。

3.2 投稿先選定プロファイルの作成

詳細なプロファイル /write-paper は、このジャーナル向けの原稿を作成する際に読み込まれます。作成時に ${CLAUDE_SKILL_DIR}/references/write_paper_profile_template.md を読み込み、テンプレートの内容をそのまま埋めてください。

正式な11セクションの順序を厳守してください。 /write-paper のフェーズ7と /find-journal は これらのプロファイルを順番に読み込むため、セクションの順序変更、名称変更、または省略があると、両方の機能の品質が気づかれないまま低下します。

  1. ジャーナルの基本情報 — 正式名称、略称、出版社、ISSN、発行頻度、インパクトファクター、OA モデル、採択率、査読方式
  2. 原稿の種類と語数制限
  3. 抄録の要件 — 語数上限と見出し構成
  4. 原著論文に必要なセクション
  5. 統計報告 — 必須。ガイドラインに指定がない場合は、次の既定値を使い、[TODO: verify at journal site] と記入してください。正確なp値は有効数字2~3桁で表記(それ未満は p < 0.001);主要評価項目の95% CI;臨床的に意味のある単位での効果量;統計ソフトウェアとバージョンの明記。
  6. 図
  7. よくある不採択の理由
  8. カバーレター
  9. AIによる文章作成の開示方針 — 許可される範囲、開示場所、AI生成画像に関する方針、方針のURL
  10. 著者向けガイドラインのURL
  11. 位置づけ — このジャーナルに投稿すべき場合、投稿すべきでない場合、および類似ジャーナル2~3誌との比較表(学会、スコープの重点、インパクトファクターの範囲、特徴)

記入ルール。 値を推測してはいけません。インパクトファクター、採択率、APC、ISSN、査読にかかる期間、語数制限、抄録の構成を決して捏造しないでください。捏造した値は原稿にそのまま反映されるため、代わりに [TODO: verify at journal site] と記入してください。出典が裏付けている場合に限り、概算の範囲(例:「約15~20%」)を使用してください。ジャーナル独自のAI方針がない場合は、出版社レベルの方針を引用し、その旨を明記してください。

3.3 投稿先検索プロファイルの作成

正式な形式を厳守してください。

# {Full Name}

## Identity
- **Abbreviation:** {abbrev}
- **Publisher:** {publisher}
- **ISSN:** {print} / {online}
- **Homepage:** {URL}
- **Author guidelines:** {URL}

## Scope
{1-2 sentence scope description.}

## Scope Keywords
{comma-separated keywords, 15-20 terms}

## Article Types Accepted
- Original Article
- Review Article
- ...

## Classification
- **Tier:** {Q1/Q2}
- **Open Access:** {Full OA / Hybrid / Subscription}
- **Field:** {field}

## Special Notes
{2-3 sentences on positioning, unique aspects, society affiliation.} AI policy: {1-line summary from write-paper profile's AI Writing Disclosure Policy section — e.g., "language editing only, dual disclosure required, AI images banned." or "follows ICMJE — disclose AI use in Methods."}
--- ゲート 2:プロフィールのレビュー ---

両方の完全なプロフィール案を提示します。次の点を確認してください。

  1. 「これらのプロフィールを確認してください。修正が必要な点はありますか?」
  2. 「Scope 段落は正確ですか?」
  3. 「Common Rejection Reasons は現実的ですか?」

ユーザーが両方のプロフィールを承認するまで、ファイルを書き込まないでください。


フェーズ 4:ファイルの書き込みと件数の更新

4.1 ファイル名の決定

スペースはアンダースコアに置き換え、特殊文字は削除します:"Journal of Clinical Oncology" → Journal_of_Clinical_Oncology.md、「JACC」→ JACC.md、「JAMA Network Open」→ JAMA_Network_Open.md。

4.2 プロフィールファイルの書き込み

write-paper プロフィールと find-journal プロフィールを、それぞれ {filename}.md として、フェーズ 0(キーとなるディレクトリ)で選択したディレクトリペアに書き込みます。private の場合、不足している 2 つのプライベートディレクトリを作成します。medsci-skills の git ツリー内には、プライベートプロフィールを書き込まないでください。

4.3 プロフィール件数の更新

プロフィール件数を更新するために、SKILL.md、README.md、その他のファイルを編集しないでください。件数は実行時にディスクから取得され、プライベートプロフィールは件数に含まれません。

4.4 確認

対象のティアと書き込んだパスを報告し、次のように対応します。

  • public:POLICY.md の要件に従い、開いたページとその日付を記録したメッセージを添えて、2 つのプロフィールファイルをパス指定でステージングし、コミットするようユーザーに伝えます。
  • private:「ファイルはプライベートプロフィールディレクトリ内にのみローカル保存されています(このリポジトリの外部)— パブリックリポジトリにはコミットしないでください。」

バッチモード

1 回のセッションで複数のジャーナルを扱う場合:

  1. すべてのジャーナル名と URL を最初に収集します。
  2. まず、すべてのジャーナルについてフェーズ 1(重複チェック)を実行します。
  3. 各ジャーナルについて、両方のゲートを設けてフェーズ 2~3 を実行します。
  4. フェーズ 4 で、すべてのファイルをまとめて書き込みます。

コメント