nsfc-ref-alignment

NSFC Ref Alignment

适用场景

• 你有一份 NSFC 标书（LaTeX 项目），希望检查：
  • .tex 里所有 \cite{...} / \citep{...} / \citet{...} 等引用的 bibkey 是否都存在于 .bib
  • .bib 条目的基础字段是否完备、格式是否明显错误（如 DOI 非法、年份缺失）
  • 引用所在句子的“语义主张”是否与该文献（至少从 title/author/year/venue/DOI 等元信息）相匹配，是否存在乱引/过度主张/张冠李戴风险
• 你希望只得到一份报告先人工审核（改 .bib / 改正文属于大事）。

不适用

• 你希望“自动替换 bibkey / 自动改写正文”——本 skill 默认禁止直接修改（除非你明确要求）。
• 你只是想补齐 BibTeX 条目：优先使用 nsfc-bib-manager。

输入

• project_root：标书项目根目录（如 projects/NSFC_General）
• 可选：main_tex：主入口 tex（默认 main.tex）
• 可选：report_dir：报告输出目录（默认 ./references，相对你运行 skill 的当前目录）
• 可选：verify_online：是否进行在线核验（默认 false；仅做确定性查询，失败降级）

流程

输入

按用户请求和配置文件提供必要输入；缺失信息应明确列出并停止依赖该输入的步骤。

执行步骤

• 当用户环境中出现因本 skill 设计缺陷导致的 bug 时，优先使用 bensz-collect-bugs 按规范记录到 ~/.bensz-skills/bugs/，严禁直接修改用户本地 Claude Code / Codex 中已安装的 skill 源码。
• 若 AI 仍可通过 workaround 继续完成用户任务，应先记录 bug，再继续完成当前任务。
• 当用户明确要求“report bensz skills bugs”等公开上报动作时，调用本地 gh 与 bensz-collect-bugs，仅上传新增 bug 到 huangwb8/bensz-bugs；不要 pull / clone 整个 bug 仓库。

步骤 1：预检与定位

1. 确认 project_root 存在且包含 main_tex。
2. 自动解析 main_tex 的 \input{} / \include{} 依赖树，收集所有涉及的 .tex 文件。
3. 自动发现 \bibliography{...} / \addbibresource{...} 指向的 .bib 文件；若发现 0 个 .bib，则回退为在 project_root 下搜索 *.bib 并给出 warning。

步骤 2：确定性抽取（脚本执行）

运行脚本生成结构化输入与确定性报告：

cd /path/to/ChineseResearchLaTeX
python3 skills/nsfc-ref-alignment/scripts/run_ref_alignment.py \
  --project-root "projects/NSFC_General" \
  --main-tex "main.tex" \
  --report-dir "references" \
  --prepare

如需在线核验（建议只对最终稿/重点条目开启）：

python3 skills/nsfc-ref-alignment/scripts/run_ref_alignment.py \
  --project-root "projects/NSFC_General" \
  --main-tex "main.tex" \
  --report-dir "references" \
  --prepare \
  --verify-online

步骤 3：宿主 AI 语义核查（本 skill 的核心）

宿主 AI 在读取 {run_dir}/ai_ref_alignment_input.json 后，逐条核查：

1. 真实性/存在性（P0）

   • bibkey 缺失：正文引用了不存在的条目
   • DOI/URL 明显无效或在线核验失败且元信息严重不一致

2. 语义不匹配风险（P0/P1）

   • P0：句子对文献作出了“强断言”，但从元信息看高度不可能（如年份矛盾、领域完全不相关、明显张冠李戴）
   • P1：可疑但证据不足（元信息不足、缺少 DOI/缺少 title/作者信息不全）