1实现原理 · 为什么它能做到
纯 prompt 型 helper：整个 skill 只有 SKILL.md + 一份 reference + 一份 Codex 清单，无任何脚本或可执行代码；能力靠『何时用 / 何时不用 / 输入 / 输出』四张纪律清单约束模型行为。
skills/paper-context-resolver/SKILL.md
This skill is optional. - This skill is helper-tier and should usually be orchestrator-invoked. - It supplements README-first reproduction. - It does not replace the main orchestration flow. - It does not summarize the whole paper by default.
这里在做什么：用『明确边界』块把 skill 的职权范围钉死。因为 helper 会被主编排（ai-research-reproduction）在特定阶段调用，边界不清就会被拿来当通用论文摘要器——description 的 'Do not use for general paper summary' 是同一约束的自然语言版本。
触发纪律按『问题类型白名单』实现：只有 dataset version/split、preprocessing、evaluation protocol、checkpoint mapping、runtime assumption 五类具体问题才允许启动，并在 reference 里给出好/坏触发样例做对照。
skills/paper-context-resolver/references/paper-assisted-reproduction.md
## Allowed question types - dataset version or split - preprocessing or postprocessing details - evaluation protocol details - checkpoint or model variant mapping - critical runtime assumptions
同一文件的 Trigger discipline 段给出反例：Good trigger 是 'README is ambiguous about the evaluation split. Check the linked paper and record the conflict if needed.'，Bad trigger 是 'Summarize this paper.' / 'Find the paper for this repository title and explain it.' / 'Tell me everything the paper changed compared with prior work.'。这就是把『窄问题』从口号变成可判定的验收标准。
取源有优先级链，且只把 Google Scholar 当定位工具而非证据源：README 给的论文链接 > 官方项目页/官方论文页 > arXiv/OpenReview 一手记录 > Scholar（仅用于找到一手源）。
skills/paper-context-resolver/references/paper-assisted-reproduction.md
1. paper link explicitly provided by the README 2. official project page or official paper page 3. arXiv or OpenReview primary paper record 4. Google Scholar only to help locate the primary source
这里在做什么：压制『搜索引擎结果当证据』的常见劣化路径，强制结论落在可被人工复核的一手文献上；同时优先 README 自己的链接，避免把复现意图从仓库作者手上夺走。
冲突处置规则是硬约束：README 与论文不一致时禁止静默替换 README，必须记录冲突并说明两方各说了什么，最终报告保持 README-first。
skills/paper-context-resolver/references/paper-assisted-reproduction.md
If README and paper disagree: - do not silently replace README - record the conflict - explain which source says what - preserve the README-first policy in the final report
这是本 skill 唯一有实际后果的行为规则，也是它相对『让模型上网查论文』的差异点：不允许把外部文献升格为新的复现基线，只允许作为带标注的补充证据。
启动前提被写进 reference 第一句：必须先有 README/仓库检查产生的具体未答问题，才允许动用论文。
skills/paper-context-resolver/references/paper-assisted-reproduction.md
Only invoke this step after README and repo inspection already produced a concrete unanswered question.
与 SKILL.md 的 'When to apply' 第四条 'There is already a concrete reproduction question to answer.' 互为冗余双保险——防的是模型一上手就去读论文。
输出协议要求区分直接证据与推断，并在适用时显式给出 README–论文冲突说明。
skills/paper-context-resolver/SKILL.md
## Output expectations - narrowed source list - reproduction-relevant answer only - explicit README-paper conflict note when applicable - clear distinction between direct evidence and inference
『narrowed source list』要求交出实际用到的来源清单（而非全部搜到的），与仓库整体的 evidence-linked 叙事一致。
2核心能力
01复现关键缺口的窄化取证（只答 dataset split / 预处理 / 评测协议 / checkpoint 映射 / 运行时假设）
02论文取源的优先级解析（README 链接优先，Scholar 降级为定位工具）
03README–论文冲突的记录式处置（禁静默覆盖）
04触发纪律：好/坏样例对照，明确拒绝『总结论文』『按标题找论文并解释』类请求
05默认排除项清单（全文摘要/新颖性解释/相关工作讨论/无复现依据的『最佳设置』猜测）
06证据分级输出：直接证据 vs 推断分列，来源清单收窄
07主编排可寻址的 helper 阶段（可被 --include-paper-gap 编入技能链，缺问题/缺来源时记录为 blocked 阶段）
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| network | 一手论文站点（指令层依赖，非代码调用：由宿主模型的检索/阅读能力访问） |
4管控建议与判定依据
建议配套管控措施
面向 Agent
可自动加载
面向管理者
登记来源与版本
判定依据（文件路径与关键语句摘要）
- SKILL.md: 纯提示词指令与规则文本，无脚本执行与外部影响
审计说明： 。零脚本、零网络调用、零凭证读取、零本地写入（第二遍 token 扫描全目录 URL/curl/wget/subprocess/os.environ/open( 零命中，且目录内无任何代码文件）。它是一条说话规则：只规定『何时查论文、查到什么程度、冲突怎么写』。唯一需要使用者自己把关的是模型读到的论文文本可能夹带诱导内容（宿主级通用风险，非本 skill 引入），以及把 arXiv 结论与 README 结论混淆——后者恰是本 skill 用冲突规则显式防范的。
5第二遍独立确认
- [ok] skill 路径（任务书标『待定位』） — 实际相对路径 skills/paper-context-resolver（SKILL.md 在该目录根）。仓库内另无同名副本；.claude/skills 之类标准位置不存在于本仓库。
- [ok] 零脚本 / 零网络 / 零凭证 / 零写入 — 全目录 token 扫描零命中；文件清单三个文件全为 markdown/yaml；SKILL.md 全文无 bash 代码块、无工具调用指令。
- [ok] 『不静默覆盖 README』规则真实存在 — references/paper-assisted-reproduction.md 的 Conflict rule 段逐字含 'do not silently replace README' 与 'preserve the README-first policy in the final report'。
- [ok] 取源优先级链存在且 Scholar 被降级 — Source order 四行逐字核对无误；第 4 条限定词 'only to help locate the primary source' 明确排除把 Scholar 当证据。
- [ok] helper 定位与仓库机制一致（注册表 + 编排器） — skill-registry.json tier/lane='helper'、output_mode.kind='paper_gap'；orchestrate_repro.py plan_skill_chain() 在 include_paper_gap 时追加本 slug，并在缺参数时记 blocked 阶段（'A narrow paper question and authoritative paper source were not supplied.'）。
- [ok] 触发边界（不该被误触发的场景） — tests/trigger_cases.json 中本 slug 在数十条用例里出现在 forbidden 列表，仅两条用例把 'paper-context-resolver' 列为 expected_top；与 description 的 'Use only when…' 一致。
- [ok] Codex 清单无 policy.allow_implicit_invocation 字段 — agents/openai.yaml 仅有 interface 块（display_name/short_description/default_prompt），没有 policy 块——即 Codex 侧未关闭隐式调用；这与 grill-me 范式不同，属事实记录，非缺陷。
- [ok] README 帮助项定位 — README.md:160 'Two helpers support orchestration: `repo-intake-and-plan` and `paper-context-resolver`.'；README 顶部 badge 还把 paper-context-resolver 作为 Skillselion Top 100 展示项。
6结论
适合： 适合正在按 README 复现深度学习仓库、且卡在一个具体复现细节（split/预处理/评测协议/checkpoint 映射/运行时假设）上的研究者或 agent 编排流程；也适合作为更大型复现 agent 的一个可选阶段被调用（--include-paper-gap）。当目标仓库是论文官方实现、README 明确链接了论文时收益最大。
不适合： 不适合想快速读懂一篇论文的人（该用通用论文阅读/摘要工具，本 skill 的 Default exclusions 明确排除全文摘要与相关工作讨论）；不适合尚未做 README/仓库检查、只有一个论文标题的场景（reference: 'Only invoke this step after README and repo inspection already produced a concrete unanswered question.'）；不适合需要复现论文指标本身的任务（本 skill 明确不承担 paper-level reproduction 断言，编排器输出里写着 'this result alone does not establish paper-level reproduction'）；也不适合期望它下载/解析 PDF 或跑代码的场景。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload paper-context-resolver.tar.gz
sha256:
Option B · Copy Guide for Agente6d72d22dd174312…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit bd91195ad7.