abs-article

Overview

本 skill 用于基于 本地 AJG（Chartered ABS Academic Journal Guide）CSV，离线生成“投稿期刊推荐”候选列表。
默认不联网、不自动更新数据；只有当用户明确提出“更新/重新抓取/刷新 AJG/ABS 数据”时才执行抓取。

When to Use

• ✅ 推荐投稿期刊、目标期刊清单、基于论文题目/摘要/关键词选期刊
• ✅ 用户提供 AJG CSV（或已在 assets/data/）
• ❌ 用户未准备任何本地 CSV 且也未要求更新（此时应提示先抓取或放入 CSV）

Core Workflow

A) 离线推荐（默认）

在仓库根目录运行（相对路径 base=仓库根目录）：

python3 scripts/abs_article_recommend.py \
  --title "论文题目" \
  --abstract "摘要（可选）" \
  --keywords "keyword1,keyword2（可选）" \
  --topk 20 \
  --format md

说明：

• 自动选择 assets/data/ 下最新年份的 ajg_<year>_journals_core_custom.csv
• 输出固定列：序号 | 期刊名 | ABS星级 | 期刊主题
• 期刊主题 = CSV 的 Field
• ABS星级 优先 AJG 2024，缺失回退 AJG 2021

B) 仅在用户明确要求时更新 AJG 数据（显式触发）

触发词示例：更新/重新抓取/刷新/更新数据库/更新ABS(AJG)数据/同步最新AJG列表

export AJG_EMAIL="你的AJG邮箱"
export AJG_PASSWORD="你的AJG密码"

python3 scripts/ajg_fetch.py --outdir "$(pwd)/assets/data"

Quick Reference

• 离线推荐脚本：scripts/abs_article_recommend.py
• 抓取脚本（显式更新）：scripts/ajg_fetch.py
• 离线推荐说明：references/abs_article.md
• 数据契约：references/ajg_data_contract.md
• 抓取说明：references/ajg_fetch.md

Common Mistakes

1. 没有本地 CSV 还想离线推荐
   • 解决：先运行抓取命令生成 assets/data/，或把已有 ajg_<year>_journals_core_custom.csv 放入该目录。
2. 误把“推荐”请求当成“更新”
   • 规则：只有用户明确说“更新/重新抓取/刷新…”才抓取；否则只做离线推荐。