运维助手
- 作者仓库星标 2,062
- 作者更新于 实时读取
- 作者仓库 ChineseResearchLaTeX
- 领域
- 通用
- 兼容 Agent
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- 信任分
- 88 / 100 · 社区维护
- 作者 / 版本 / 许可
- @huangwb8 · 未声明 license
- Token 消耗评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部 API Key
- 不需要
- 兼容的系统
- 未声明（默认跨平台）
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。
需要注意： 未限定 allowed-tools，默认拥有全部工具权限。
---
name: nsfc-ref-alignment
description: 检查 NSFC 标书正文引用与参考文献的一致性与真实性风险（只读）：核查 bibkey 是否存在、BibTeX 字段与 DOI 等格式问题，并生成结构化输入供宿主 AI 逐条评估“正文表述是否…
category: 通用
runtime: 无特殊运行时
---
# nsfc-ref-alignment 输出预览
## PART A: 任务判断
- 适用问题：通用任务拆解、检查和交付。
- 输入要求：目标材料、限制条件、期望输出和验收方式。
- 证据边界：围绕“与 bensz-collect-bugs 的协作约定 / 适用场景 / 不适用”读取原文规则，不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断：确认你的需求是否属于通用任务拆解、检查和交付，并标出输入、限制和预期结果。
- **02** 执行计划：优先按“与 bensz-collect-bugs 的协作约定 / 适用场景 / 不适用”拆成步骤，说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果：给出可复制的命令、文件改动、检查清单或内容草稿，并说明如何继续迭代。
- **04** 风险边界：结合 读取文件、写入/修改文件、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件；主要在本地完成；通常不需要额外 API Key。
- 先小样例验证，再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。 先确认触发方式
原文出现了 `/path` 这类斜杠命令；如果你的 Agent 支持命令触发，优先用命令开场，再补充目标和边界。
给清楚输入和边界
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是：读取文件、写入/修改文件。
小样例验证后再放大
先用一个小任务确认它会围绕“与 bensz-collect-bugs 的协作约定 / 适用场景 / 不适用”工作；涉及文件或命令时，先看 diff、日志、预览或测试结果。
复核后再交付
检查最终产物是否包含明确结果、必要证据和下一步动作；如果输出泛泛而谈，就补充输入、边界和验收标准后重跑。
---
name: nsfc-ref-alignment
description: 检查 NSFC 标书正文引用与参考文献的一致性与真实性风险（只读）：核查 bibkey 是否存在、BibTeX 字段与 DOI 等格式问题，并生成结构化输入供宿主 AI 逐条评估“正文表述是否…
category: 通用
source: huangwb8/ChineseResearchLaTeX
---
# nsfc-ref-alignment
## 什么时候使用
- 把通用方向的常用动作沉淀成 Agent 可调用的技能 适合处理通用任务拆解、检查、交付和复盘，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的步骤；通常不需要额外…
- 面向通用任务拆解、检查和交付，优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「与 bensz-collect-bugs 的协作约定 / 适用场景 / 不适用」组织步骤，不把推断写成作者事实。
- 读取文件、写入/修改文件；主要在本地完成；通常不需要额外 API Key。
- 先跑小样例，确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown，不编造命令、平台或依赖。 证据边界与执行链路
作者原文负责流程事实；仓库文件负责来源和命令；流狐只补充适用场景、限制和质量判断。
skill "nsfc-ref-alignment" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> 与 bensz-collect-bugs 的协作约定 / 适用场景 / 不适用
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件 | 主要在本地完成
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
}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/；用户可指定其他目录）：
NSFC-REF-ALIGNMENT-vYYYYMMDDHHMMSS.md（如同秒重复运行，脚本会追加-2/-3/...避免覆盖）
该报告必须是“只读审查报告”，不得直接修改标书正文或 .bib。
工作流（推荐）
步骤 1：预检与定位
- 确认
project_root存在且包含main_tex。 - 自动解析
main_tex的\input{}/\include{}依赖树，收集所有涉及的.tex文件。 - 自动发现
\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 后，逐条核查：
真实性/存在性（P0）
- bibkey 缺失：正文引用了不存在的条目
- DOI/URL 明显无效或在线核验失败且元信息严重不一致
语义不匹配风险（P0/P1）
- P0：句子对文献作出了“强断言”，但从元信息看高度不可能（如年份矛盾、领域完全不相关、明显张冠李戴）
- P1：可疑但证据不足（元信息不足、缺少 DOI/缺少 title/作者信息不全）
过度主张/弱支撑（P1）
- 例如“首次/唯一/最优/显著优于”但缺乏足够支撑或疑似需要更强引用
证据优先级（强制）： 在线核验结果（若开启） > BibTeX 的 title/abstract > 仅从句子推断（最低优先级）。
步骤 4：生成最终报告（只读）
在 report_dir 写入最终报告 NSFC-REF-ALIGNMENT-vYYYYMMDDHHMMSS.md，必须包含：
- Summary：总引用数、唯一 bibkey 数、缺失条目数、重复条目数、P0/P1 数
- P0（必须处理）：缺失 bibkey、明显伪造/错误元信息、严重语义错配
- P1（建议处理）：字段不全（缺 DOI/缺 year）、弱支撑/过度主张、需要人工复核
- 附录：逐条引用明细（至少包含 file/line、原句、bib 条目关键字段、风险判断与理由）
修改边界（强制）
- 默认不修改任何标书内容与配置：
- 禁止修改：
**/*.tex、**/*.bib、**/*.cls、**/*.sty
- 禁止修改：
- 允许写入：
{project_root}/.nsfc-ref-alignment/**（中间产物）./references/**（最终报告；可由用户改到别处）
- 若用户明确要求“修复引用/修复 bib”，必须先在报告里给出修改计划与影响面，再执行最小化修改（默认不做）。
与 check-review-alignment 的关系（经验复用）
- 共同点：脚本只做确定性抽取；“语义是否匹配”的判断由宿主 AI 完成；输出可追溯的结构化输入与报告。
- 不同点：本 skill 面向标书项目（多文件
\input{}结构），且默认不做任何自动改写（只输出审查报告）。
验证清单（静态自检）
{project_root}/.nsfc-ref-alignment/run_{timestamp}/存在且包含 4 个核心产物（json/md/csv/json）。- 最终报告写入
report_dir，且没有任何.tex/.bib文件被修改。 - 报告对每个 P0/P1 给出：定位（file/line）+ 原句 + 依据 + 建议动作。
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核