evidence-draft

证据草稿

触发条件与路由

• 触发条件：证据草稿、证据包、候选主张、具体对比、证据片段、溯源、证据草稿、证据包、可引用事实。

根据简报、笔记和可选的证据绑定，生成确定性的 outline/evidence_drafts.jsonl 数据包。

当前启用兼容模式：此次迁移会保留现有 JSONL 契约，同时将证据质量策略、稀疏证据路由和评估锚点规则移至 references/ 和 assets/。

加载顺序

始终阅读：

• references/overview.md
• references/evidence_quality_policy.md

根据任务阅读：

• 在判断薄弱证据应阻止起草，还是仅降低主张强度时，阅读 references/block_vs_downgrade.md
• 评估 token、协议上下文或数值主张较弱时，阅读 references/evaluation_anchor_rules.md
• 校准证据稀少的数据包时，阅读 references/examples_sparse_evidence.md
• 论文自我叙述或通用结果包装文本混入数据包片段／候选主张时，阅读 references/source_text_hygiene.md

机器可读资源：

• assets/evidence_pack_schema.json
• assets/evidence_policy.json
• assets/source_text_hygiene.json
• 全仓库通用的 assets/limitation-signals.json — 共享极性规则，确保已解决的问题和正向改进不会进入局限性字段

输入

必需：

• outline/subsection_briefs.jsonl
• papers/paper_notes.jsonl
• citations/ref.bib

可选但建议提供：

• papers/evidence_bank.jsonl
• outline/evidence_bindings.jsonl

输出

保持当前输出契约：

• outline/evidence_drafts.jsonl
• 可选：在 outline/evidence_drafts/ 下生成便于阅读的镜像文件

脚本边界

仅将 scripts/run.py 用于：

• 对简报／笔记／证据库／绑定进行确定性关联
• 提取片段并整理溯源信息
• 按策略生成 blocking_missing／downgrade_signals／verify_fields
• 验证数据包并生成 Markdown 镜像文件

不要将 run.py 用于：

• 添加填充条目，让证据稀少的内容看起来完整
• 隐藏无法通过 references/／assets/ 检查的稀疏证据判断
• 撰写面向读者的叙述性文本

输出格式规则

保持以下内容稳定：

• 保留下游综述流程已使用的现有顶层数据包字段
• claim_candidates 必须源自片段
• concrete_comparisons 必须确实呈现双边对比；如果某个聚类没有可用的重点内容，就删除该对比卡片，并在上游标明证据稀少，而不是编造 A 与 B 的对比
• 片段采样应考虑聚类：当某个小节有明确的聚类时，证据选择应避免仅因某条路线的摘要包含更醒目的结果句，就只聚焦于该路线
• 稀疏证据应作为明确的阻断项／降级信号／待核实字段呈现，而不是用填充条目补足
• 引用键必须限定在 citations/ref.bib 中

兼容性说明

当前模式以参考文件为先，并采用确定性兼容策略：

• assets/evidence_policy.json 定义数据包阈值和稀疏证据路由
• assets/evidence_pack_schema.json 记录并验证稳定的数据包格式
• assets/source_text_hygiene.json 负责清理此 Skill 中的包装文本；全仓库通用的 assets/limitation-signals.json 则负责统一 paper-notes、evidence-draft 和 writer-context-pack 中的局限性极性
• scripts/run.py 仍会生成现有 JSONL 和 Markdown 输出，但不再用通用的谨慎措辞填充证据稀少的部分

快速开始

• uv run python .codex/skills/evidence-draft/scripts/run.py --workspace <workspace>

执行说明

在兼容模式下运行时，scripts/run.py 当前会读取：

• outline/subsection_briefs.jsonl
• papers/paper_notes.jsonl
• citations/ref.bib
• 可选的 papers/evidence_bank.jsonl 和 outline/evidence_bindings.jsonl
• assets/evidence_policy.json 和 assets/evidence_pack_schema.json

脚本

快速开始

• uv run python .codex/skills/evidence-draft/scripts/run.py --workspace <workspace>

所有选项

• --workspace <dir>
• --unit-id <id>
• --inputs <path1;path2>
• --outputs <path1;path2>
• --checkpoint <C*>

示例

• uv run python .codex/skills/evidence-draft/scripts/run.py --workspace <workspace>

故障排除

• 如果证据薄弱但证据包看起来完整，请先检查 assets/evidence_policy.json 和 references/block_vs_downgrade.md，再修改 Python。
• 如果评估要点过于笼统，请检查 references/evaluation_anchor_rules.md 和策略资源文件。
• 如果论断很强，但证据过于抽象或仅有标题，请通过 downgrade_signals 和 verify_fields 降级，而不是添加叙述性保留说明。