# oneskills

**Repository Path**: onescience-ai/oneskills

## Basic Information

- **Project Name**: oneskills
- **Description**: OneSkills 是基于 OneScience 构建的一个开源知识与 Skills（能力）库，旨在为智能体（Agents）开发提供可复用、可组合、可扩展的能力模块，优化多种智能体AI4S领域代码生成效果。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-03-24
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# <div align="center"><strong>oneskills</strong></div>

### <div align="center">OneScience Skills Library for AI-native Scientific Research</div>

> 🚀 OneSkills = Knowledge × Skills × Agents

---

## 📖 项目简介

OneSkills 是基于 OneScience 构建的开源知识与能力库（Skills Library），专为智能体（Agents）开发设计，提供可复用、可组合、可扩展的能力模块，聚焦 AI4S（AI for Science）科学智能科研领域，实现从数据处理、模型训练到实验分析的全流程自动化科研能力，显著提升科学研究效率与代码生成效果。

在智能体时代，单一模型能力已无法满足复杂科学计算任务需求。OneSkills 通过结构化知识库与可执行能力模块，帮助开发者构建专业级 AI-native 科学研究系统。

### 核心特性

- 📚 **结构化知识库**：基于 OneScience 的科学知识与模型组件文档
- 🧠 **可执行能力模块**：标准化的 Skills 定义与工作流
- 🔗 **Agent-ready 接口**：专为 Claude Code、Trae 等智能体设计
- 🌐 **多领域覆盖**：气象、生信、材料、流体等科学领域

---

## 🔗 与 OneScience 的关系

| 项目 | 定位 | 用途 |
|------|------|------|
| **OneScience** | 科学知识与智能体基础框架 | 代码运行环境、模型训练与推理 |
| **OneSkills** | 能力层（Skills & Knowledge） | 用户开发环境、智能体能力扩展 |

**关系说明**：
- OneScience 提供底层科学计算框架与模型实现
- OneSkills 基于 OneScience 构建，提供能力模块与开发指导
- 两者协同工作，实现从模型训练到智能体开发的完整链路


### 目录结构

**核心 Skills**：

| 目录 | 作用 |
|------|------|
| **onescience-auto-research/** | 自主研究编排，管理 AI 研究全生命周期 |
| **onescience-coder/** | 代码生成与改造，支持模型、组件、数据管道 |
| **onescience-data-processing/** | 数据处理与分析，提供数据卡和处理工具 |
| **onescience-installer/** | 环境安装与配置助手 |
| **onescience-model-scaling/** | 模型扩展与优化，支持模型规模调整，暂未开放 |
| **onescience-planner/** | 研究计划与实验方案生成 |
| **onescience-runtime/** | 运行时环境管理与作业提交 |
| **onescience-skill/** | 技能管理与创建工具 |
| **onescience-test/** | 测试工具与验证框架 |
| **onescience-training/** | 模型训练与评估工具 |

**完整项目结构**：

```
oneskills/
├── skills/                    # 核心 Skills 目录
│   ├── onescience-auto-research/  # 自主研究编排
│   ├── onescience-coder/          # 代码生成与改造
│   ├── onescience-data-processing/ # 数据处理与分析
│   ├── onescience-installer/      # 环境安装与配置
│   ├── onescience-model-scaling/  # 模型扩展与优化
│   ├── onescience-planner/        # 研究计划生成
│   ├── onescience-runtime/        # 运行时环境管理
│   ├── onescience-skill/          # 技能管理与创建
│   ├── onescience-test/           # 测试工具与验证
│   ├── onescience-training/       # 模型训练与评估
│   └── onescience.json            # 运行时配置文件
├── models/                    # 模型卡（Model Cards）
├── contracts/                 # 组件契约（Component Contracts）
├── datapipes/                 # 数据卡（DataPipe Cards）
└── self_skills/               # 用户自定义 Skills 目录
```

---

## ⚙️ 快速开始

### 安装使用

OneSkills 是嵌入式开发工具库，无需独立安装。为获得更完整的功能支持，处理复杂任务时建议配合 **OneScience** 使用。 将两者克隆到同一项目目录后，复制 skills 到对应智能体的配置目录:

```bash
git clone https://github.com/onescience-ai/onescience.git # 可选
git clone https://github.com/onescience-ai/oneskills.git

# 复制 skills 到你的项目（选择你使用的工具）
cp -r oneskills/skills /your/project/.claude/skills      # Claude Code
cp -r oneskills/skills /your/project/.cursor/skills      # Cursor
cp -r oneskills/skills /your/project/.codex/skills       # Codex CLI
cp -r oneskills/skills /your/project/.kiro/steering      # Kiro
cp -r oneskills/skills /your/project/skills/custom       # DeerFlow 2.0
cp -r oneskills/skills /your/project/.trae/skills         # Trae
cp -r oneskills/skills /your/project/.antigravity        # Antigravity
cp -r oneskills/skills /your/project/.github/superpowers # VS Code (Copilot)
cp -r oneskills/skills /your/project/skills              # OpenClaw
cp -r oneskills/skills /your/project/.windsurf/skills   # Windsurf
cp -r oneskills/skills /your/project/.gemini/skills     # Gemini CLI
cp -r oneskills/skills /your/project/.aider/skills      # Aider
cp -r oneskills/skills /your/project/.opencode/skills   # OpenCode
cp -r oneskills/skills /your/project/.qwen/skills       # Qwen Code
```

### Trae 远程连接 SSH 配置

在 Trae 中配置远程连接 SSH 的步骤如下：

1. **打开 Trae IDE**，点击左侧边栏的 "远程连接" 图标
2. **添加新连接**，在scnet下载ssh-key登录，配置ssh远程连接
3. **测试连接**，确保能够成功连接到远程服务器
4. **配置工作目录**，设置为你的项目路径

### Trae 中配置 onescience-agent.md

`onescience-agent.md` 是 OneScience 科研智能体的配置文件，用于定义智能体的能力、行为和工作流程。在 Trae 中配置使用方法如下：

#### 配置步骤

**方式一：通过浏览器链接导入（推荐）**

1. **打开浏览器**，访问链接：https://s.trae.com.cn/a/6e4491?region=cn
2. **选择导入智能体**：在页面中选择 "导入智能体" 选项
3. **配置智能体**：将以下配置内容复制到智能体配置编辑器中
4. **保存并使用**：保存配置后，即可在对话界面中选择该智能体进行使用

**方式二：在 Trae IDE 中导入**

1. **打开 Trae IDE**，点击左侧边栏的 "设置" 图标
2. **选择智能体**：在智能体设置页面，点击 "新建智能体" 或 "导入智能体"
3. **配置智能体**：将以下配置内容复制到智能体配置编辑器中
4. **保存并使用**：保存配置后，即可在对话界面中选择该智能体进行使用



#### 使用方法

1. **启动智能体**：在 Trae 中选择 `OneScience科研智能体` 智能体
2. **提交任务**：使用自然语言描述你的科学计算任务
3. **监控执行**：查看智能体的执行过程和结果
4. **获取结果**：智能体完成任务后，获取处理结果和生成的代码

### 配置文件说明

#### onescience.json

`onescience.json` 是 OneScience 的运行时配置文件，用于定义作业提交的参数和环境设置。需要复制到用户当前工程的根目录。

**主要配置项**：
- `runtime.mode`：运行模式，支持 `slurm` 等
- `runtime.cluster`：集群配置，包括分区、节点数、GPU 数量等
- `runtime.modules`：需要加载的环境模块
- `runtime.conda`：conda 环境配置
- `runtime.script`：作业脚本配置

**示例配置**：
```json
{
  "runtime": {
    "mode": "slurm",
    "cluster": {
      "partition": "hpctest02",
      "nodes": 1,
      "gpus_per_node": 1,
      "cpus_per_task": 8,
      "memory": "64GB",
      "time_limit": "02:00:00",
      "gpu_type": "dcu",
      "ntasks_per_node": 1
    },
    "modules": [
      "sghpc-mpi-gcc/26.3",
      "sghpcdas/25.6"
    ],
    "conda": {
      "enabled": true,
      "env_name": "onescience311",
      "activate_script": "source ~/.bashrc && conda activate onescience311"
    },
    "script": {
      "path": "slurm_submit.sh",
      "generate": true,
      "template": "default",
      "job_name": "era5_dataloader",
      "code_path": "era5_reader.py",
      "env_vars": {
        "ONESCIENCE_DATASETS_DIR": "/public/share/sugonhpcapp01/onestore/onedatasets/",
        "ONESCIENCE_MODELS_DIR": "/public/share/sugonhpcapp01/onestore/onemodels/"
      },
      "work_dir": "."
    }
  }
}
```

#### tpl.slurm

`tpl.slurm` 是 Slurm 作业提交模板文件，用于生成实际的作业提交脚本。需要复制到用户当前工程的根目录。

**主要功能**：
- 定义作业的资源需求（CPU、GPU、内存等）
- 配置环境变量和模块加载
- 设置 Conda 环境激活
- 执行用户指定的代码

**使用方法**：
1. 将 `tpl.slurm` 复制到项目根目录
2. 根据需要修改 `onescience.json` 中的配置
3. 运行 `onescience-skill` 相关的 Skill 生成并提交作业

### 智能体配置文件说明

| 工具 | 配置文件 | 路径 | 说明 |
|------|----------|------|------|
| **Claude Code** | `CLAUDE.md` | 项目根目录 | - |
| **Kiro** | `.kiro/steering/*.md` | 项目根目录 | 支持 always/globs/手动三种模式 |
| **DeerFlow 2.0** | `skills/custom/*/SKILL.md` | 项目根目录 | 字节跳动开源 SuperAgent，自动发现自定义 skills |
| **Trae** | `.trae/skills/*/*.md` | 项目级规则 | - |
| **Antigravity** | `GEMINI.md` 或 `AGENTS.md` | 项目根目录 | - |
| **VS Code** | `.github/copilot-instructions.md` | 项目根目录 | Copilot 自定义指令 |
| **Cursor** | `.cursor/rules/*.md` | 项目级规则目录 | - |
| **OpenClaw** | `skills/*/SKILL.md` | 工作区级 skills 目录 | 自动发现 |
| **Windsurf** | `.windsurf/skills/*/SKILL.md` | 项目级 skills 目录 | - |
| **Gemini CLI** | `.gemini/skills/*/SKILL.md` | 项目级 skills 目录 | - |
| **Aider** | `.aider/skills/*/SKILL.md` | 项目级 skills 目录 | - |
| **OpenCode** | `.opencode/skills/*/SKILL.md` | 项目级 skills 目录 | - |
| **Qwen Code** | `.qwen/skills/*/SKILL.md` | 项目级 skills 目录 | - |

### 使用 Skills

Skills 通过自然语言提示词触发。以下是一个数据读取分析任务示例：

```
使用onescience-skill技能，在当前目录生成读取部分ERA5数据集代码， 并使用slurm提交运行

```

将上述提示提交到支持 Skills 的智能体（如 Trae）对话框，即可自动生成代码，并提交运行。



### 开发 Skills

当标准 Skills 无法满足需求时，可创建自定义 Skills：

**Skills 文件结构**（YAML 元数据 + Markdown 正文）：

```markdown
---
name: skill_name
description: 技能描述，简明扼要
tags:
  - 领域标签
  - 功能标签
---

# 技能标题

## 1. 技能目标
## 2. 适用场景
## 3. 输入与输出
## 4. 实现逻辑
## 5. 验证与测试
```

**完整示例**：参考 `./skills/` 目录下的现有 Skills 文件。

---

## 🌍 应用场景

| 场景 | 描述 | 示例 |
|------|------|------|
| 📊 **数据分析助手** | 科学数据处理与可视化 | 气象数据读取、网格插值、结果可视化 |
| 🧑‍💻 **开发辅助 Agent** | 模型代码生成与改造 | 模块替换、特征融合、架构优化 |
| 🧠 **AI Copilot 系统** | 交互式智能开发 | 自然语言编程、错误诊断、性能优化 |
| 🔬 **科研工作流** | 复杂科学计算任务 | 多模型组合、跨领域适配、自动化流程 |

---

## 🤝 社区与贡献

欢迎加入 OneSkills 社区，共同构建 AI-native 科学研究生态：

### 参与方式

- **提交 Issue**：报告问题、提出功能需求
- **发起 PR**：贡献新 Skills、修复 Bug、优化文档
- **分享 Skill**：分享您的自定义 Skills 至社区

### 贡献指南

1. Fork 项目并创建分支
2. 添加/修改 Skills 文件
3. 确保符合项目规范与格式
4. 提交 Pull Request 并描述变更

### 社区交流

- GitHub Issues：[issues](https://github.com/onescience-ai/oneskills/issues)
- Discussion：[discussions](https://github.com/onescience-ai/oneskills/discussions)

---

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。

---

## ⭐ Star History

如果这个项目对你有帮助，欢迎 ⭐️ 支持！

---

<div align="center">
  <strong>Built with OneScience for AI-native Scientific Research</strong>
</div>