add-journal

添加期刊技能

根据期刊的作者指南，为每本期刊生成两份档案：一份详细的写论文档案（约 100–150 行），以及一份精简的找期刊档案（约 30 行）。档案内容使用英语编写；资料库由所有人共享。

关键目录

档案分属以下两个层级之一。请在第 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）。
• **强烈建议：**作者指南网址。如果用户只提供名称，请先询问网址，再继续；这是首要数据来源。
• **可选：**研究领域重点（用于 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. 对所有四个目录执行 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”）。

如果找到匹配项，请报告路径。如果仅存在于一个目录，请提出只创建缺失的另一份档案；如果两个目录中都存在，请提出更新档案或中止。未经用户指示，不得继续到第 2 阶段。

---

第 2 阶段：提取数据

• **路径 A（可用 WebFetch）：**获取作者指南网址并解析内容。如果页面需要登录、严重依赖 JavaScript 或内容稀少，请改用路径 B。
• **路径 B：**请用户粘贴作者指南内容（或关键章节）。获取失败时绝不可不作说明地放弃。

提取清单

对于无法确定的字段，标记为 [TODO: verify at journal site]。

**撰写论文配置文件需提取：**全名；缩写；出版商；ISSN（纸质版/在线版）； 出版频率；影响因子及其 JCR 年份；OA 模式；录用率；同行评审类型；稿件 类型及其字数、摘要、参考文献和图表限制；摘要格式（结构化或非结构化、 标题、字数限制）；原创文章所需章节；统计要求 （p 值格式、CI、效应量）；图表规格（DPI、格式、颜色、数量上限）；投稿附信 要求。

**查找期刊配置文件需提取：**1-2 句的范围简介；15-20 个以逗号分隔的范围 关键词；接受的文章类型；分类（Q1/Q2 分区、OA、领域）。

--- Gate 1：元数据确认 ---

将提取的元数据显示为结构化摘要。询问：

1. “这些信息准确吗？有需要更正的地方吗？”
2. “该期刊常见的拒稿原因有哪些？”（如果无法从资料中提取）
3. “你会如何将该期刊与本领域的类似期刊进行定位比较？”

如果用户提供的信息与来源冲突，请列出冲突并询问。在用户确认或更正之前，不要继续 进入 Phase 3。

---

Phase 3：配置文件生成

3.1 加载参考模板

读取一个相近领域的现有撰写论文配置文件，作为格式参考：

领域	要加载的模板
放射学	Radiology.md 或 European_Radiology.md
综合医学	The_BMJ.md 或 JAMA.md
医学教育	JMIR_Medical_Education.md
AI / 数字健康	npj_Digital_Medicine.md 或 JMIR.md
IR / 介入治疗	CVIR.md 或 JVIR.md
外科	Annals_of_Internal_Medicine.md
其他	The_BMJ.md（最稳妥的通用模板）

另外，读取一个现有的查找期刊配置文件，作为紧凑格式的参考。

3.2 生成撰写论文配置文件

为该期刊起草论文时，会加载详细配置文件 /write-paper。撰写时读取 ${CLAUDE_SKILL_DIR}/references/write_paper_profile_template.md，并填写 原样模板。

严格遵循规范规定的 11 个章节顺序。/write-paper 的 Phase 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. “常见拒稿原因是否符合实际？”

在用户批准两份资料之前，不要写入文件。

---

第 4 阶段：写入文件并更新计数

4.1 确定文件名

空格替换为下划线，移除特殊字符：“Journal of Clinical Oncology” -> Journal_of_Clinical_Oncology.md；“JACC” -> JACC.md；“JAMA Network Open” -> JAMA_Network_Open.md。

4.2 写入资料文件

将投稿论文资料和查找期刊资料分别写入 Phase 0（关键目录）中选定的目录对，文件名均为 {filename}.md。如果选择 private，则在缺失时创建两个私有目录。不要将私有资料写入 medsci-skills git 树中的任何位置。

4.3 更新资料计数

不要编辑 SKILL.md、README.md 或任何其他文件来更新资料计数：计数会在运行时从磁盘读取，私有资料永远不会计入。

4.4 确认

报告目标层级和写入的路径，然后：

• public：提醒用户按 POLICY.md 的要求，按路径暂存这两个资料文件并提交，提交消息需记录打开过哪些页面以及日期。
• private：“文件仅保存在本地的私有资料目录中（在此仓库之外）——不要提交到公共仓库。”

---

批处理模式

在一次会话中处理多个期刊时：

1. 提前收集所有期刊名称和 URL。
2. 先对所有期刊运行第 1 阶段（重复项检查）。
3. 按期刊分别运行第 2 至第 3 阶段，并执行两道关卡。
4. 在单次第 4 阶段中写入所有文件。