---
title: 制作业务资源包
description: 将岗位、技能、资料和模板打包为可导入内容。
lastVerified: 2026-09-23
---

# 6.3 制作业务资源包

当前业务资源清单格式为 `teloa.business-package/v2`。先从[通用研究示例包](https://docs.teloa.ai/examples/general-research.zip)学习完整结构，再减少到自己的必要资源。

## 包结构

```text
research/
  teloa.json
  skills/研究简报/SKILL.md
  roles/研究分析员.json
  knowledge/通用研究方法.md
  workflows/资料研究.json
  plans/每日资料核对.json
```

## 一份最小清单

下例只声明一个技能。与它一起打包前一篇的 `skills/research-brief/SKILL.md`：

```json
{
  "format": "teloa.business-package/v2",
  "id": "research-starter",
  "title": "研究入门",
  "version": "1.0.0",
  "domain": "general",
  "description": "根据授权资料生成带来源的研究简报。",
  "resources": [{
    "id": "research-brief",
    "kind": "skill",
    "title": "研究简报",
    "version": "1.0.0",
    "required": true,
    "source": {"kind": "local", "path": "skills/research-brief/SKILL.md"}
  }],
  "relations": [],
  "entrypoints": ["research-brief"]
}
```

## 关键校验

- 资源 ID 唯一；关联必须指向包中存在且类型匹配的资源。
- 版本使用固定的三段版本号，不能使用 `latest`。
- 本地路径是包内相对路径，不能包含绝对路径、`..` 或反斜杠。
- `required: true` 的本地资源必须实际存在。
- `scope` 可选，省略时使用 `domain`；范围标识为 1–64 位字母、数字、下划线或连字符。
- 入口只能指向技能或任务模板；资源声明和授权是两回事。

## 验证导入

先在隔离实例导入，检查预览中的内容和关联。确认后逐一打开岗位、技能和模板，完成一项小任务；对缺文件、错误版本和不匹配的关联，再分别验证会被拒绝。

内容导入限制当前为 1–500 个文件、单文件最多 2 MiB、总内容最多 20 MiB；界面或上传层可能还有额外限制。发布到公共目录需要更多发布元数据，不等于完整公开发布服务已开放。

格式细节见[资源格式与内部接口](https://docs.teloa.ai/markdown/develop/formats.md)。