用途
ov-add-paper 用于把一篇研究论文整理成 OpenViking 可用的结构化资源，并在完成后通过 ov add-resource 完成入库。按资料描述，任务只有在生成的 artifact 目录经过校验并提交到 OpenViking 之后才算完成。
主要能力
- 将论文转换为 ARA 风格的结构化 artifact 目录。
- 配套生成规定清单内的产物文件与证据文件。
- 对 artifact 执行确定性校验，并修复校验失败项（除非用户明确接受错误）。
- 通过 OpenViking CLI 将校验通过的目录入库，并验证入库结果。
输入
必需输入：论文来源，通常是本地 PDF 路径或论文 URL。若论文来源缺失或无法访问，需先向用户索取后再开始。
可选输入：输出目录、OpenViking 目标 URI、领域说明、相关仓库/源码文件、是否等待 OV 处理完成。
工作流程
- 完整阅读论文，包括附录以及所有带编号的图与表。
- 依据 references/ara-compiler-profile.md 编译 ARA 风格的 artifact 目录。
- 使用 scripts/validate_ara.py 校验 artifact。
- 修复校验失败项，除非用户明确接受这些错误。
- 用 ov add-resource 直接入库校验通过的 artifact 目录。
- 用 ov stat / ov tree 确认目标，并返回 artifact 路径、OV 目标/根 URI、校验结果、入库结果以及尚未解决的缺口。
输出契约
生成的 artifact 需包含：PAPER.md；logic/problem.md、logic/claims.md、logic/concepts.md、logic/experiments.md、logic/related_work.md；logic/solution/constraints.md；src/environment.md；trace/exploration_tree.yaml；evidence/README.md；以及针对每个已归档编号表格和图的 Markdown 与 PNG 证据文件。最终回复必须包含 ov add-resource 的命令结果，或证明目标已落地的恢复性检查结果（针对 --wait 异常），或阻止入库的确切阻塞原因。
验证与入库命令
验证方式（在本技能目录下运行，或使用校验器的绝对路径）：
python3 scripts/validate_ara.py <artifact-dir>
入库命令：
ov add-resource <artifact-dir> --to viking://resources/papers/<slug> --wait --timeout 300
入库前可用 ov -o json stat <target-uri> 检查目标是否已存在。入库后用 ov -o json stat <target-uri> 与 ov tree <target-uri> 进行验证。
权限与边界
- 当用户要求添加或入库论文时，允许写入新的 OpenViking 资源。
- 若要刻意复用可能覆盖或替换已有资源的目标 URI，需先询问用户。
- 只有在用户明确接受所列校验错误时，才可使用 --skip-validation。
- 不要使用 ov add-skill；本技能创建的是论文资源，不是 OV 技能。
- 不得静默跳过 ov add-resource；若入库失败，需报告命令、错误与恢复路径。
- 若 ov add-resource --wait 在创建目标后以连接错误退出，不要立即用同一 URI 重试；应运行 ov stat、ov wait --timeout <seconds>、ov observer queue、ov tree 判断入库是否已完成。
- 不得编造论断、证据、来源引用、代码、数字或研究历史。
- 除非用户要求该目标，不得覆盖已明确存在的 OV 目标。
- 对不支持或不可读的内容应标记为不可用，而不是自行填充。
运行资源
- 编译 artifact 前加载 references/ara-compiler-profile.md。
- 运行 OV 入库或排查入库失败前加载 references/openviking-ingest.md。
- 使用 scripts/validate_ara.py 做确定性检查。
适用场景
适用于用户要求将研究论文或 PDF 添加、导入、编译或摄取进 OpenViking，尤其是提到 ov-add-paper、ARA、claims 等关键词的场景。
限制
资料未提供该技能的具体价格、收费方式、支持平台范围或效果数据，暂未提供。