AI agent 投稿前期刊定向审查 skill:按目标期刊 Author Guidelines 和同刊范文,检查论文草稿是否符合期刊要求和投稿惯例,并输出可复查的修改方向。它有审查能力,但边界是期刊要求和刊物惯例,不替代同行评审。
中文为主,English version below.
基础检查可以零配置运行。若希望提高 Author Guidelines 自动获取成功率,建议在宿主 agent 环境里配置 Tavily:
export TAVILY_API_KEY="YOUR_API_KEY"不要把 API key 写进仓库。没有 key 时,skill 会优先尝试公开页面、reader/search 结果和第三方摘要;只有证据不足时才请求用户粘贴官方指南片段。
不需要额外安装网页转 Markdown 的 skill。journal-fit 已内置轻量 fallback 思路:优先尝试 Jina Reader、defuddle 等公开 reader,把官方页面转成 Markdown;如果仍然只拿到验证码、cookie 页或空内容,才继续降级到搜索摘要、第三方页面或用户粘贴。
- 想按目标期刊要求做投稿前审查。
- 想区分“必须改”的格式问题和“建议优化”的风格偏离。
- 想把摘要、引言、结论等章节和同刊同主题论文做对照。
- 想让 AI agent 先收集证据、列出风险,再由作者自己修改。
它不是“帮你改论文”的工具,也不是替审稿人给录用判断的工具。更准确地说,它是“期刊定向的投稿前审查”:帮你确认草稿和目标期刊要求、刊物惯例差在哪里。小白用户不需要先理解检查类型;如果请求模糊,skill 会先按快速检查跑,再根据结果建议是否升级到完整投稿前审查或深度对标。
- 抽取真实 Author Guidelines 中的字数、摘要、关键词、图表、参考文献和声明要求。
- 解析
.docx、.pdf、.md或.txt草稿中的相关特征。 - 用同刊同主题范文对比摘要长度、参考文献数量、章节篇幅等软性惯例。
- 默认从“快速检查”开始,优先找会导致投稿系统卡住或编辑部退回的硬性问题。
- 输出
P0 必须修改、P1 建议修改、P2 可选优化、已达标和无法评估。
- 不代写、不生成替换段落、不预测录用概率。
- 不模拟同行评审,不判断创新性是否足够录用。
- 不用出版商通用默认值冒充期刊真实要求。
- 不绕过付费墙、验证码、登录墙或机构权限。
目标期刊 + 草稿
↓
默认快速检查(不强迫小白选择复杂范围)
↓
获取 Author Guidelines
↓
解析草稿特征
↓
必要时检索同刊同主题范文
↓
输出 P0 / P1 / P2 诊断和修改方向
在支持 skills / agent instructions 的 agent 里安装:
请从 GitHub 安装这个 skill,并在期刊定向投稿前审查时优先使用它:
https://github.com/keros68/journal-fit
安装后可以这样调用:
使用 $journal-fit 按 Journal of Hydrology 的要求检查这篇论文草稿,只看格式合规和摘要风格。
手动安装示例:
git clone https://github.com/keros68/journal-fit.git ~/.codex/skills/journal-fit没有正式 skill loader 的环境,也可以把 SKILL.md 作为 agent instruction 使用。
SKILL.md- skill 主说明和执行流程。agents/openai.yaml- 兼容运行时的 UI 元数据。references/- Author Guidelines 抓取矩阵和实测踩坑记录。
检查质量取决于期刊页面可访问性、草稿可解析性、同刊范文召回质量和宿主 agent 的联网能力。最终投稿前仍建议人工复核期刊官网、Author Guidelines 和投稿系统提示。
This project is the original journal-fit skill by keros68:
https://github.com/keros68/journal-fit
Released under the MIT License. Forks and redistributed copies should preserve the license text and original repository link.
journal-fit is an AI agent skill for journal-specific pre-submission review. It compares a manuscript draft with real Author Guidelines and same-journal examples, then reports evidence-backed revision directions.
It does not write replacement prose, simulate peer review, predict acceptance, or bypass access restrictions.
Quick start:
Install this skill from GitHub and use it for journal-specific pre-submission checks:
https://github.com/keros68/journal-fit
Call it with:
Use $journal-fit to check this manuscript against the target journal's Author Guidelines.
MIT. See LICENSE.