6.3 制作业务资源包

当前业务资源清单格式为 teloa.business-package/v2。先从通用研究示例包学习完整结构，再减少到自己的必要资源。

包结构

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

一份最小清单

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

{
  "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；界面或上传层可能还有额外限制。发布到公共目录需要更多发布元数据，不等于完整公开发布服务已开放。

格式细节见资源格式与内部接口。