🚀

Skill 技能封装技术标准

全球开发者共建智能体生态 🌍
按标准封装技能，共享到平台，下载量越高，奖励越多！💰

🤖 AI 生成技能 📖 了解技术标准 ⚡ 快速开始 🎯 提交技能

📐 Skill 技能封装技术标准

我们制定了统一的技能封装标准，让全球开发者能够轻松创建、共享和使用AI技能

📦

统一的技能描述格式

每个技能必须包含标准化的元数据描述，包括名称、类别、描述、标签、提供商信息等。

  • 统一的 JSON Schema
  • 多语言支持（中文/英文）
  • 版本控制机制
  • 依赖声明规范
🔌

标准化的 API 接口

技能必须通过标准化的 API 接口暴露功能，确保与各种 AI 应用无缝集成。

  • RESTful API 设计
  • OpenAI 兼容接口
  • 统一的认证机制
  • 错误处理规范
📄

完整的文档规范

每个技能必须提供完整的文档，包括使用说明、示例代码、参数说明等。

  • README 模板
  • API 文档自动生成
  • 使用示例代码
  • 常见问题解答
🧪

测试与验证标准

所有技能必须通过自动化测试，确保功能正确、性能稳定、安全可靠。

  • 单元测试规范
  • 集成测试框架
  • 性能基准测试
  • 安全漏洞扫描
🔒

安全与隐私保护

技能必须遵循严格的安全和隐私保护标准，保护用户数据和系统安全。

  • 数据加密传输
  • 权限最小化原则
  • 隐私数据脱敏
  • 安全审计日志
🌐

国际化与本地化

技能应该支持多语言和本地化，让全球用户都能方便使用。

  • i18n 国际化支持
  • 多语言文档
  • 时区与日期处理
  • 文化适应性设计

📄 SKILL.md 标准格式模板

每个技能必须包含一个 SKILL.md 文件，这是技能的核心描述文件：

---
name: "蛋白质结构预测助手"
description: "基于 AlphaFold2 的蛋白质3D结构预测"
category: "科学研究"
tags: [生物信息, 蛋白质, 结构预测]
version: "1.0.0"
author: "086云开发者"
license: "MIT"
model: ["gpt-4o", "claude-3-opus"]
---

# 技能名称

## 功能概述
简要描述技能的核心功能（不超过3句话）。

## 使用前提条件
- **前置依赖**：列出使用该技能前需要满足的条件
- **兼容客户端**：GPT-4o / Claude-3.5 / 本地模型

## 操作步骤
1. 步骤一：[具体操作说明]
2. 步骤二：[具体操作说明]

## API 调用示例
\`\`\`bash
curl -X POST https://api.086yun.com/v1/skills/xxx \
  -H "Authorization: Bearer TOKEN"
\`\`\`

## 参数说明
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|

## 注意事项 & 更新日志
- v1.0.0 (2025-01-15): 首次发布

⚙️ skill.json 配置文件格式

skill.json 是技能的配置元数据文件：

{
  "name": "蛋白质结构预测助手",
  "id": "protein-predict-v1",
  "version": "1.0.0",
  "description": "基于 AlphaFold2 的预测技能",
  "category": "科学研究",
  "tags": ["生物信息", "蛋白质"],
  "author": {
    "name": "开发者名称",
    "email": "dev@example.com",
    "url": "https://example.com"
  },
  "isFree": false,
  "price": 0.05,
  "currency": "USD",
  "model": ["gpt-4o"],
  "apiEndpoint": "/v1/skills/xxx",
  "method": "POST",
  "inputs": {
    "sequence": {"type":"string","required":true}
  },
  "outputs": {
    "result_url": {"type":"string"}
  },
  "createdAt": "2025-01-15T00:00:00Z"
}

📋 技能封装步骤指南

按照以下 6 个步骤完成技能的封装、测试和发布：

1

创建目录

在 /skills/技能名/ 下创建：SKILL.md + skill.json + prompts/

2

编写 SKILL.md

按上方模板填写 Front Matter 和正文，确保含完整使用方法和参数说明

3

配置 skill.json

填写元数据：API端点、输入输出参数、价格等。确保 id 全局唯一

4

本地测试

用 AI 客户端（WorkBuddy/悟空）导入 .md 文件测试功能是否正常

5

提交审核

在开发者中心填写信息并上传文件，等待管理员审核（3-5个工作日）

6

发布上线

审核通过后自动发布到平台技能市场，全球用户均可发现和使用

📁 标准技能文件结构

一个完整的技能封装包应包含以下文件和目录：

your-skill-name/
├── SKILL.md            # 技能说明文档（必须）
├── skill.json          # 技能配置元数据（必须）
├── README.md           # 用户使用指南（推荐）
├── prompts/
│   └── system.md      # 系统提示词模板
├── references/
│   ├── context.md     # 背景知识资料
│   └── examples.md    # 使用示例集
├── assets/
│   └── preview.png    # 技能预览图（推荐）
└── test/
    └── test-cases.json # 测试用例（推荐）
💡 提示：实际提交时，将整个技能内容打包为单个 .md 文件上传即可（平台支持 markdown 作为技能封装格式），或分别上传 SKILL.md 和 skill.json 两个核心文件。

🤖 AI 辅助生成技能

不知道如何封装技能？只需用自然语言描述你的需求，AI 将自动生成符合技术标准的技能包！

✨

描述你想要的技能

用自然语言告诉我，你想创建什么样的技能？比如："我需要一个能够帮助医生诊断疾病的AI助手，它可以分析医学影像、解读检验报告、提供诊断建议..."

试试这些例子：

⚡ 快速开始

只需 5 步，即可按标准封装你的第一个 Skill 技能

1

下载技能模板

获取我们的官方技能模板，包含所有必要的文件和目录结构。

# 克隆技能模板仓库 git clone https://github.com/086yun/skill-template.git my-skill cd my-skill
2

填写技能描述文件

编辑 skill.json 文件，填写你的技能信息。

// skill.json 示例 { "id": "my-awesome-skill", "name": "我的 awesome 技能", "category": "productivity", "description": "这是一个很棒的技能...", "tags": ["效率", "自动化"], "isFree": true }
3

实现技能逻辑

在 index.js 或 main.py 中实现你的技能逻辑。

# Python 示例 from skill_framework import SkillBase class MySkill(SkillBase): def execute(self, params): # 实现你的技能逻辑 result = self.process(params) return result
4

编写测试用例

编写单元测试和集成测试，确保技能质量。

# test_skill.py import unittest from my_skill import MySkill class TestMySkill(unittest.TestCase): def test_execute(self): skill = MySkill() result = skill.execute({"input": "test"}) self.assertEqual(result["status"], "success")
5

提交技能到平台

通过我们的开发者门户提交你的技能，等待审核通过后即可上架！

# 打包技能 python build.py --skill-dir ./my-skill # 提交到平台（通过后自动上架） python submit.py --package my-skill-v1.0.0.skill

🎁 奖励机制 - 让分享更有价值

我们为优质技能提供者提供丰厚的奖励，下载量越高，奖励越多！

🥉

新手奖励

首次提交技能并通过审核

50 API Token
  • 一次性奖励
  • 可用于 API 调用
  • 无使用期限
🥈

人气奖励

技能下载量达到 100 次

200 API Token
  • 按下载量阶梯奖励
  • 每月结算一次
  • 可叠加获得
🥇

明星奖励

技能下载量达到 1,000 次

1000 API Token
  • 额外现金奖励 ¥500
  • 首页推荐位 7 天
  • 专属徽章标识
💎

传奇奖励

技能下载量达到 10,000 次

5000 API Token
  • 额外现金奖励 ¥5000
  • 永久首页推荐
  • 平台收入分成 5%

审核通过的技能奖励将直接打入你的账户余额，支持随时提现到支付宝或银行卡。

🎯 提交你的技能

填写以下信息并提交你的技能包，审核通过后将上架到平台

❓ 常见问题

关于技能封装和提交的常见疑问

什么是技能封装？ ▼

技能封装是指按照平台规范，将 AI 功能（如 API 调用、提示词模板、工具链等）打包为一个标准化的技能包。封装后的技能可以发布到技能市场，供全球用户发现和使用。一个完整的技能包通常包含 SKILL.md（技能说明文档）和 skill.json（配置元数据）两个核心文件。

如何编写 SKILL.md？ ▼

SKILL.md 采用 Markdown 格式编写，顶部使用 YAML Front Matter 声明元数据（名称、版本、作者、分类等），正文部分详细描述技能的功能、使用方法、参数说明、示例和注意事项。建议参考上方的"SKILL.md 标准格式模板"进行编写。

skill.json 配置文件是必须的吗？ ▼

是的，skill.json 是技能包的必需文件。它包含了技能的元数据信息，如 ID、名称、版本、API 端点、输入输出参数、定价等。这些信息被平台用于技能的发现、安装和调用。建议使用上方的"skill.json 配置文件格式"模板进行填写。

提交审核后一般需要多长时间？ ▼

通常情况下，审核周期为 3-5 个工作日。我们会在审核完成后通过您提供的联系方式通知结果。如果审核未通过，我们会附上具体原因和改进建议，您可以根据反馈修改后重新提交。

技能发布后可以更新吗？ ▼

可以。技能发布后，您可以在开发者中心提交更新申请。更新内容同样需要经过审核流程，但通常会比首次审核更快。建议在每次重大更新时同步更新版本号。

我的技能可以设置收费吗？ ▼

可以的。在 skill.json 配置文件中，您可以通过 pricing 字段设置技能的价格策略。平台支持按次计费、按月订阅、按量计费等多种模式。免费技能同样受欢迎，它们能帮助您快速积累用户和口碑。