OneSkills 实战：用 Skills 把智能体打造成 AI4S 科研专家

1. 科研任务为什么总卡在“最后一公里”我接触过不少做计算材料、气象预测、生物信息的朋友大家聊起来几乎都有一个共同感受真正花在“科学思考”上的时间远少于花在“把流程跑通”上的时间。一个看起来简单的科研目标比如“复现某篇论文里的混合天气预报模型”拆开之后往往横跨工程规划、数据接入、模型改造、环境安装、任务提交、结果评测六七个环节。每个环节单独看都不算难但串起来就是一条又长又脆的链路任何一环报错整条链路就得停下来排查。这就是 AI4SAI for Science落地时最真实的痛点。通用智能体本身很聪明能写代码、能解释概念但它不知道你们实验室的 GPU 集群怎么提交任务不知道某个气象模型需要哪些配置文件更不知道论文里那张表对应的数据管线长什么样。换句话说它缺的不是智力而是领域技能。OneSkills 想解决的正是这个问题。它把科研流程里那些反复出现的能力——资源召回、任务拆解、环境安装、代码实现、结果检查——沉淀成可复用、可组合的 Skills让通用智能体在科研场景下具备“专家级”的操作能力。你可以把它理解成给智能体装了一套科研工具箱主控技能负责编排资源类技能负责找模型和数据专家类技能负责规划执行类技能负责真正把任务跑起来。这篇文章面向的是需要文献理解、实验设计与数据分析的科研场景。我会给出可复制的 Skills 配置示例并完整走一遍从任务描述到结果校验的端到端流程帮你判断这套方案是否适配你自己的科研工作流。核心检索词就三个OneSkills、AI4S、科研智能体下面所有操作都围绕它们展开。2. OneSkills 前置准备智能体接入与 Skills 机制解析在动手之前得先把 OneSkills 的定位讲清楚否则你很容易把它当成一个普通的插件市场。OneSkills 是面向 AI4S 领域的科研智能体技能库它适配了多种主流智能体平台包括 Claude Code、Codex、Trae、OpenCode 等。它的核心不是“再做一个模型”而是把科研经验封装成 Skill让智能体在接到科研任务时能按领域专家的方式去思考和执行。Skills 机制的关键在于组合。单个 Skill 只做一件事比如检索某个领域的模型资源或者生成数据构建脚本。但科研任务从来不是单点问题它需要多个 Skill 协同。OneSkills 用 onescience-orchestrator 作为主控协同 resource、expert、executor 三类技能完成意图识别、资源召回、专家规划、计划融合、执行调度和状态更新。这套编排逻辑是它区别于普通代码助手的地方。安装方式按平台区分我直接把命令列出来你可以对照自己的环境操作。Claude Code 用户执行两条命令/plugin marketplace add https://github.com/onescience-ai/oneskills /plugin install oneskillsoneskillsCodex 用户执行npx codex-marketplace add https://github.com/onescience-ai/oneskills --skillsTrae 用户走图形界面打开“扩展 → 更多 → 从 VSIX 安装”从 Gitee Releases 下载onescience-copilot*.vsix并导入。OpenCode 用户直接粘贴提示词让智能体按仓库说明安装请获取并按照 https://github.com/onescience-ai/oneskills/blob/master/.opencode/INSTALL.md 中的说明从当前仓库检出并为 OpenCode 安装 OneSkills。安装完成后使用方式非常直接在指令中加上 OneScience 关键词并说明你的科研目标。比如你想融合不同模型的特点可以这样描述使用OneScience技能实现任务结合FourCastNet的全局感受野优势和Pangu-Weather的局地精细建模能力构建一个混合天气预报模型。需要复现论文时直接给地址使用OneScience复现 https://arxiv.org/abs/2406.01465 论文。需要运行实验并处理故障时把提交和诊断放在同一个任务里使用OneScience技能将这个训练任务提交到远端GPU集群并诊断运行失败的原因。这里有个前置条件容易被忽略如果你用的是需要 API 接入的智能体平台得先准备好可用的模型服务。TaoToken 提供了兼容主流接口的模型服务你可以通过 TaoToken API 获取接入地址在 API Keys 页面 生成密钥。具体配置我会在下一节给出可复制的片段。3. 可复制配置把 OneSkills 接进你的智能体工作流这一节是全文最“硬”的部分我会给出可直接复制的配置片段。不同平台的配置文件路径和字段名不一样我按平台分开写你找到自己用的那个照抄即可。所有配置的核心三件套都是Base URL、API Key、Model ID。这三个字段缺一不可写错任何一个都会导致请求失败。先看 Claude Code 的配置。它的 settings 文件通常放在用户目录下的.claude/settings.json如果你用的是项目级配置则放在项目根目录的.claude/settings.json。内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }注意ANTHROPIC_BASE_URL填的是https://taotoken.net/api不要多加路径也不要带 UTM 参数。ANTHROPIC_MODEL填你实际要用的模型 ID不同模型 ID 对应的能力不同科研任务建议选长上下文版本方便处理论文和长代码。再看 Codex 的配置。Codex 使用auth.json管理认证信息路径一般在~/.codex/auth.json。内容结构如下{ OPENAI_API_KEY: sk-你的密钥, OPENAI_BASE_URL: https://taotoken.net/api, model: gpt-4.1 }如果你用的是 Cline 这类支持 MCP 的编辑器插件配置会写在 MCP 的 settings 里。Cline MCP 的配置片段如下{ mcpServers: { oneskills: { command: npx, args: [-y, oneskills-mcp], env: { BASE_URL: https://taotoken.net/api, API_KEY: sk-你的密钥, MODEL_ID: claude-sonnet-4-20250514 } } } }这里要特别提醒Cline MCP 的三件套是 Base URL、API Key、Model ID分别对应BASE_URL、API_KEY、MODEL_ID。很多人只填了前两个忘了 Model ID结果智能体一直报“model not found”。另外MCP 直连生产数据库是禁止的科研场景里如果你要接数据库务必用只读账号或测试库。如果你用的是 CC Switch 来管理多个模型配置它的配置文件通常是 TOML 格式路径在~/.cc-switch/config.toml。片段如下[[providers]] name taotoken base_url https://taotoken.net/api api_key sk-你的密钥 model claude-sonnet-4-20250514配置写完后建议先做一次最小验证确认链路是通的。验证方法很简单在智能体里发一句“你好请回复当前使用的模型名称”。如果它能正常回复说明 Base URL 和 Key 都没问题。如果报 401说明 Key 错了如果报 local proxy failed说明 Base URL 写错了或者网络层有问题如果报 reading choices 相关错误通常是返回格式不匹配检查 Model ID 是否填对。配置这一步看起来琐碎但它是后面所有科研任务的基础。我见过太多人跳过验证直接跑复杂任务结果报错时根本分不清是配置问题还是任务问题。花五分钟做一次最小验证能省下后面半小时的排查时间。4. 端到端验证从任务描述到结果校验的完整流程配置通了之后我们来做一次完整的端到端验证。我选一个科研场景里比较典型的任务复现一篇论文并对结果做校验。这个任务能同时覆盖文献理解、代码实现、环境安装和结果检查几个环节正好检验 OneSkills 的组合能力。第一步是任务描述。你不需要把每个步骤都写清楚只需要把科研目标说清楚剩下的交给 OneSkills 编排。指令如下使用OneScience复现 https://arxiv.org/abs/2406.01465 论文并在完成后检查复现结果与论文报告指标的差异。发出指令后OneSkills 的主控技能会先做意图识别判断这是一个“论文复现”类任务然后调用 resource 类技能去召回论文相关的模型、数据集和配置资源。接着 expert 类技能会做任务拆解把复现过程拆成数据接入、模型改造、配置补全、训练运行、结果评测几个子任务。最后 executor 类技能负责真正执行包括生成代码、安装依赖、提交任务。这个过程里你能在智能体的输出里看到它的规划步骤。我实测下来它通常会先输出一个任务计划表列出每个子任务的目标和依赖关系。这一步很关键因为你可以在这里介入检查它的拆解是否符合你的预期。如果发现它漏了某个环节比如没考虑数据预处理你可以直接补充说明它会重新规划。第二步是环境安装。论文复现最烦的就是环境依赖不同版本的 PyTorch、CUDA、科学计算库经常打架。OneSkills 的 onescience-runtime 和 onescience-installer 会识别远程环境自动安装依赖。如果安装失败它会诊断故障原因比如某个包版本冲突然后给出修复建议。这一步的输出通常是一串安装日志你可以看到它实际执行了哪些命令。第三步是代码实现与运行。OneSkills 会生成数据任务代码和模型改造代码。根据官方数据数据类任务代码生成通过率达到 70%模型构建代码通过率达到 87.5%。这个数字意味着大部分情况下代码能直接跑通但仍有部分需要人工介入。我的建议是不要完全放手在它生成代码后快速扫一眼关键部分比如数据加载路径、模型超参数、损失函数定义。这些地方最容易出现和论文不一致的情况。第四步是结果校验。任务跑完后OneSkills 会检查测试结果并和论文报告的指标做对比。如果差异较大它会尝试分析原因比如数据划分方式不同、随机种子未固定、评估指标计算方式有差异等。这一步的输出是一份对比报告你可以据此判断复现是否成功。整个流程走下来我的感受是OneSkills 把科研任务里那些“必须做但不需要创造性”的环节自动化了让你能把精力集中在科学问题上。但它不是全自动的关键节点仍需要你把关。把它当成一个高效的科研助理而不是一个替代你的科学家。5. 常见报错排查401、local proxy failed 与 reading choices这一节我整理了几个高频报错都是我在配置和使用过程中真实遇到过的。每个报错我都给出原因和解决方法你可以对照自己的情况排查。报错一401 Unauthorized这是最常见的报错意思是认证失败。原因通常有三个API Key 填错了、Key 过期了、或者 Key 和 Base URL 不匹配。排查方法是先确认 Key 是否复制完整注意不要有多余空格。然后确认 Base URL 填的是https://taotoken.net/api没有多加斜杠或路径。如果都没问题去 API Keys 页面 重新生成一个 Key 试试。报错二local proxy failed这个报错通常出现在 Base URL 配置错误或者网络层不通的情况下。先检查 Base URL 是否写成了https://taotoken.net/api/这种带尾斜杠的形式有些客户端对尾斜杠敏感。然后检查你的网络环境是否能正常访问该地址。如果用的是公司内网可能需要配置网络白名单。注意这里不要尝试任何非正规的网络访问方式直接用标准 HTTPS 请求即可。报错三reading choices 相关错误这个报错一般出现在模型返回格式和客户端预期不一致时。常见原因是 Model ID 填错了比如填了一个不存在的模型名或者填了一个不支持当前接口协议的模型。解决方法是核对 Model ID 是否在服务商支持的列表里。另外有些客户端要求返回 OpenAI 兼容格式如果你用的模型返回的是其他格式也会报这个错。这时候换一个兼容的 Model ID 即可。报错四OAuth 相关错误如果你用的是 Claude Code 并且走了 OAuth 登录流程可能会遇到 OAuth 报错。这通常是因为本地缓存的 token 失效了。解决方法是清除本地认证缓存重新走一遍登录流程。具体缓存路径因平台而异Claude Code 一般在~/.claude/目录下。清除后重新执行安装和配置命令。报错五Skill 未加载安装完 OneSkills 后如果智能体没有识别到 OneScience 关键词说明 Skill 没有正确加载。检查安装命令是否执行成功Claude Code 用户可以用/plugin list查看已安装插件。如果列表里没有 oneskills重新执行安装命令。Codex 用户检查npx codex-marketplace命令是否返回成功。排查报错的核心思路是先确认配置三件套Base URL、API Key、Model ID是否正确再确认网络是否通畅最后确认 Skill 是否加载。按这个顺序排查大部分问题都能定位到。6. 把 OneSkills 用进你的日常科研工作流走到这里你已经完成了从配置到验证的完整流程。最后我想聊聊怎么把它真正用起来而不是装完就放着。我的建议是从小任务开始。不要一上来就复现整篇论文先让它帮你做一件具体的事比如“检索材料化学领域可用的预训练模型”或者“为这个数据集生成一份质量检查脚本”。这类任务边界清晰容易验证结果能帮你快速建立对 OneSkills 能力的判断。等你熟悉了它的工作方式再逐步加大任务复杂度。比如把“文献理解 实验设计 数据分析”串成一个完整任务让它一次性输出方案和代码。这时候你会发现它的价值不在于替代你思考而在于把你从重复的工程劳动里解放出来。如果你在科研过程中沉淀了一些好用的流程也可以考虑把它封装成 Skill 贡献到 OneSkills 仓库。科研智能体的生态需要更多人参与你封装的一个小技能可能正好解决了另一个领域研究者的痛点。需要长期做编码和 Agent 任务的可以了解 Coding Plan想先验证模型效果的直接去 模型对话 试几句接入过程中遇到问题接入文档 里有更详细的字段说明。配置这件事一次做对后面就省心了。