用途:让最终 PDF 中的每个数字都能超链接回产生它的确切代码行,实现论文数值与实验代码的反向可追溯。
主要能力:用 \hypertarget 在代码输出中标记数值,用 \hyperlink 在正文中引用,用 \num{公式} 在编译时计算派生值;脚本可扫描 hypertarget/hyperlink、列出孤立引用与未被引用的数值,并校验交叉引用完整性(比对论文文本与代码输出 results.txt 的数值是否一致)。
使用方式:输入为包含代码与 LaTeX 的论文项目目录($0)。扫描:python ~/.claude/skills/backward-traceability/scripts/ref_numeric_values.py --scan paper/main.tex --output report.json;校验:python ~/.claude/skills/backward-traceability/scripts/ref_numeric_values.py --verify paper/main.tex --code-output results.txt。工作流分五步:在代码输出加 hypertarget 标签(格式为 {前缀}{行号}{字母},如 R1a),正文用 hyperlink 引用,派生值用 \num,生成带锚点的附录代码清单,最后校验每个数字都有对应锚点、公式能正确求值、PDF 超链接跳转正确。
LaTeX 需要 hyperref 与 listings 包。规则包括:论文中每个数值必须可追溯到代码输出,不手动输入数字,派生值用 \num{},附录代码须与实际执行的代码一致。上游技能 experiment-code、data-analysis,下游 paper-compilation,另见 paper-assembly。
适用场景:需要严格复现与审计数值来源的实证类论文写作。限制:具体平台与价格信息暂未提供。