SuperAPI AI 工具集

evidence-binder

通用与其它

查看项目

更新于 10-16 06:52

技能介绍

用途:将论文级证据池转换为子章节可寻址的证据计划,作为“证据库”到“写作”之间的桥梁,使写作者只使用绑定到当前子章节的证据 ID。触发词包括 evidence binder、evidence plan、section->evidence mapping、证据绑定、evidence_id;适用于 papers/evidence_bank.jsonl 已存在、希望写作者与审计者使用子章节范围证据项的场景。

输入:outline/subsection_briefs.jsonl、outline/mapping.tsv、papers/evidence_bank.jsonl;可选 citations/ref.bib 用于校验引用键。输出:outline/evidence_bindings.jsonl(每个子章节一条记录)与 outline/evidence_binding_report.md(含缺口与标签分布摘要)。绑定记录字段包括 sub_id、title、paper_ids、mapped_bibkeys、bibkeys、evidence_ids、evidence_counts、binding_rationale、binding_gaps。

密度契约:默认以 queries.md:per_subsection 为宽度契约(A150++ 默认 28),要求 mapped_bibkeys 不少于该值,evidence_ids 不少于该值减 4(A150++ 为不少于 24),所选 bibkeys 不少于 20;course_paper 档位为 8 个映射 bibkey、至少 6 个所选 bibkey、至少 6 个证据 ID 且来自至少 4 篇论文。绑定策略默认子章节优先,允许同 H2 章节内有限复用,但每个 H3 保留至少 3 个子章节专属引用,避免跨章节复用。

用法:运行 uv run python .codex/skills/evidence-binder/scripts/run.py --help 查看帮助;uv run python .codex/skills/evidence-binder/scripts/run.py --workspace <workspace> 执行绑定。可选参数 --unit-id、--inputs、--outputs、--checkpoint。若 outline/evidence_bindings.refined.ok 存在,脚本不会覆盖输出文件。

限制与排错:证据 ID 过少时,可增强证据库或扩大映射论文集后重跑;binding_gaps 非空表示子章节所需证据字段未被覆盖,应优先补充证据库或调整映射,必要时修改子章节简报中的 required_evidence_fields。标记 refined 前需检查报告,确认各 H3 的标签与 claim_type 分布存在差异,避免机械雷同。