用途
dym-arex-skill-creator-paper-to-skills 是 AREX-Skill 中 Creator 类别的一个技能，目标是把一篇论文转化为可复现、模块化且经过验证的 skill（技能模块），而不是仅仅产出一份论文摘要。它适合这样的场景：你手头有一篇需要复现的论文，希望最终得到的是可验证的模块化 skill，而非文字总结。
主要能力
该技能通过 Distiller（蒸馏器）流程工作，create-paper-skills 会把全部工作委托给 paper-skills-distiller，后者自动加载一系列辅助技能，完成以下环节：
- 解析论文来源（plan-paper-skill-modules 构建论文画像、模块计划与模块文档）；
- 生成并校验模块级 skill（create-paper-module-skill）；
- 准备有边界的运行时证据（prepare-paper-recovery-env：包、模型、数据、运行时）；
- 运行可行的最强复现实验，且不读取原始安装仓库（recover-paper-result）；
- 分析与论文目标的差距，给出 accept / refine / blocker 结论（analyze-paper-recovery）；
- 如有需要，在 iteration_budget 范围内进行精炼；
- 记录每次尝试的产物以及最终报告。
使用方式
1. 准备配置文件
仓库中有两个同 schema 的 TOML 文件：
- examples/creator/paper-to-skills/distiller-run-config.toml：带详细注释的起步模板，推荐使用；
- cli/packages/coding-agent/src/disco/skills/create-paper-skills/assets/distiller-run-config-template.toml：技能持有的规范模板。
从 AREX-Skill 检出根目录复制：
cp examples/creator/paper-to-skills/distiller-run-config.toml
/absolute/path/to/distiller-run-config.toml
2. 至少填写 3 个字段
schema_version = 1
[defaults] workspace_root = "/absolute/path/to/paper2skills-workspace" # ① 必须修改
[[runs]] paper_slug = "my_paper_slug" # ② 必须修改 paper_source = "/path/to/paper.pdf" # ③ 必须修改 original_repo_source = "unknown"
paper_source 接受：本地 PDF/文本路径、直接 PDF URL、arXiv URL 或编号、论文名称。 original_repo_source 接受：本地仓库路径、Git/GitHub URL、"none"、"unknown"。
要添加第二篇论文，就再加一个 [[runs]] 块。
3. 运行前应了解的配置项
| 字段 | 默认值 | 含义 |
|---|---|---|
| recovery_mode | "hard" | hard：reduced/proxy/toy/fallback 运行只记为诊断，不算复现成功；要接受它们必须显式选择 soft |
| ask_before_expensive_recovery | true | 消耗资源前先停下询问 |
| repo_discovery_mode | "ask" | ask 在寻找安装仓库前停下询问；auto 自动搜索 GitHub 并克隆第一个候选；disabled 从不自动搜索 |
| allow_title_top_hit | false | 用论文名检索时不自动采用第一个结果 |
| iteration_budget | 10 | 最大精炼轮数 |
| network_timeout_seconds | 120 | 网络超时 |
| command_timeout_seconds | 20 | 命令超时 |
| runtime_constraints | （字符串） | 起步模板默认禁止使用共享 conda 环境，要求使用隔离环境 |
| test_root / skills_root / generated_skills_root / distiller_skills_root / attempt_dir | "" | 留空则使用 workspace_root 下的默认布局 |
[defaults] 中的每个字段都可以在单个 [[runs]] 中覆盖；空字符串 "" 表示继承。数值/布尔覆盖必须取消注释才会生效。
4. 运行命令
disco --creator -p "/skill:create-paper-skills Use Distiller to generate and verify paper-replication skills for each run in this config. config_path: /absolute/path/to/distiller-run-config.toml"
简短形式（Creator 自动选择入口）：
disco --creator -p "Use Distiller to generate and verify paper-replication skills for each run in this config. config_path: /absolute/path/to/distiller_run_config.toml"
输出位置
<workspace_root>/<paper_slug>/skills/ # 生成的 skill —— STAGING <workspace_root>/<paper_slug>/distillation/reports/final/ # 最终报告
skills/ 目录树在被审核并导入之前一直处于 staging 状态。最终校验后，Creator 会为整个图提出一个部署范围，只有在你批准后才导入，然后为 Researcher 写交接文档。
注意事项
- recovery_mode = "hard" 是有意设置的默认值。如果报告写的是 "diagnostic" 而不是 "recovered"，这是正确行为，不是错误。
- 不要手动逐个调用 paper skill。一次正常运行只需一条 create-paper-skills 命令。
- workspace_root 必须是绝对路径且可写——所有证据、skill、产物都会写入其中。
- 传给 DisCo 的配置路径必须是绝对路径。
后续步骤
如果想在项目的 CI 中锁定库版本，可参考 07-tich-hop-ci.md。