SuperAPI AI 工具集

evidence-draft

写作与研究

查看项目

更新于 10-16 04:38

技能介绍

Evidence Draft 是一个面向研究写作流水线的技能,用于生成按小节划分的证据包(evidence packs)。其核心目标是为后续写作提供结构化、可追溯的证据材料,而不产出面向读者的叙述性文字。

用途 该技能从研究简报(subsection briefs)、论文笔记(paper notes)和引用库(ref.bib)出发,构建确定性的证据草稿文件 outline/evidence_drafts.jsonl。它服务于需要系统整理可引用事实、候选论点、具体对比和评估协议的研究写作流程。

主要能力

  • 生成候选论点(claim candidates),且必须来源于证据片段(snippet-derived)。
  • 生成具体对比(concrete comparisons),要求真正双向;若某一聚类缺少可用亮点,则丢弃该卡片并在上游暴露证据稀疏问题,而非虚构 A 与 B 的对比。
  • 整理评估协议、局限性说明以及带引用来源的证据片段。
  • 通过策略驱动的机制物化 blocking_missing、downgrade_signals、verify_fields 等字段。
  • 支持片段采样保持聚类感知(cluster-aware),避免因某一路径摘要中结果句更醒目而将证据选择坍缩到单一方向。
  • 证据稀疏时以显式阻塞项、降级信号或待验证字段呈现,而非用填充条目掩盖。
  • 引用键必须限定在 citations/ref.bib 范围内。

使用方式 该技能通过脚本运行: 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*>

输入要求: 必需: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 仅用于跨简报、笔记、证据库与绑定关系的确定性连接,片段提取与来源组装,策略驱动的字段物化,以及证据包校验与 Markdown 镜像生成。它不应用于生成填充条目、不可检查的稀疏证据判断或面向读者的叙述性文字。

加载顺序:始终读取 references/overview.md 和 references/evidence_quality_policy.md;按任务读取 references/block_vs_downgrade.md、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。

适用场景 适用于需要从文献中系统整理证据、构建候选论点与对比、并保持引用可追溯的研究写作流水线,尤其是需要区分证据充分与证据稀疏情形、并对薄弱证据进行降级处理的场景。

限制 该技能不产出叙述性文字,不生成填充内容,不虚构对比。证据稀疏时不会用通用谨慎性文字填充。脚本不负责隐藏的稀疏证据判断。具体功能、收费、价格、平台或效果等事实在现有资料中暂未提供。