Skip to content

keros68/journal-fit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

journal-fit

AI agent 投稿前期刊定向审查 skill:按目标期刊 Author Guidelines 和同刊范文,检查论文草稿是否符合期刊要求和投稿惯例,并输出可复查的修改方向。它有审查能力,但边界是期刊要求和刊物惯例,不替代同行评审。

中文为主,English version below.

License: MIT Agent Skill

API 配置(可选但推荐)

基础检查可以零配置运行。若希望提高 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 和投稿系统提示。

Attribution and Redistribution

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.

English

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.

License

MIT. See LICENSE.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors