nsfc-ref-alignment

# NSFC Ref Alignment ## 与 bensz-collect-bugs 的协作约定 - 当用户环境中出现因本 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 仓库。 ## 适用场景 - 你有一份 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；仅做确定性查询，失败降级） ## 输出（只读 + 可复现） ### 中间产物（强制） **所有中间文件**必须托管在： `{project_root}/.nsfc-ref-alignment/run_{YYYYMMDDHHMMSS}/` 其中 `run_{YYYYMMDDHHMMSS}` 为时间戳；如同秒重复运行，脚本会追加 `-2/-3/...`，确保多次分析不冲突。 该目录至少包含： - `ai_ref_alignment_input.json`：结构化输入（引用位置 + 句子上下文 + 文献元信息 + 校验结果），供宿主 AI 做语义判断 - `ref_integrity_report.md`：确定性报告（缺失 bibkey、重复条目、字段缺失、DOI 格式问题等） - `citations.csv`：逐条引用清单（file/line/bibkey/sentence） - `bib_inventory.json`：BibTeX 清单（被引用条目与问题标注） ### 最终交付（默认） 仅输出一份**供用户审核的报告**（默认写入 `./references/`；用户可指定其他目录）： - `N...