RKT 协议 — ROLEOS

Manifest 结构

bundle-manifest.json

每个 Bundle 的核心是一个 manifest.json 文件，遵循 RKT v1.0 规范。

字段	类型	必须	说明
`rktVersion`	string	必填	协议版本（当前 "1.0"）
`id`	string	必填	唯一标识符（kebab-case）
`version`	string	必填	Bundle 版本（语义化版本）
`name`	string	必填	显示名称
`summary`	string	必填	一句话描述
`targetUser`	string	必填	目标用户
`roles`	Role[]	必填	角色定义数组
`kits`	Kit[]	可选	能力包数组
`teams`	Team[]	可选	协作团队定义
`mode`	enum	可选	solo \| team
`activationScope`	enum	可选	session \| agent \| workspace \| global
`assertions`	Assertion[]	可选	契约测试声明

四大对象

Role 角色

{
  "id": "analyst",
  "label": "数据分析师",
  "purpose": "负责数据采集与趋势分析",
  "isEntry": true,
  "responsibilities": ["数据清洗", "趋势分析"],
  "boundaries": ["不执行写操作"],
  "thinkingLevel": "deep"
}

Kit 能力包

{
  "id": "web-search",
  "label": "全网搜索",
  "capabilities": ["信息检索", "摘要提取"],
  "entryPoint": "search.js",
  "runtimeRequirement": "mcp-server"
}

Team 团队

{
  "id": "research-team",
  "members": ["analyst", "writer", "reviewer"],
  "topology": "hierarchical",
  "coordinator": "analyst",
  "handoffPolicy": "explicit",
  "terminationCondition": "coordinator-approved"
}

质量守门

6 层 Validator

包体结构

manifest.json 是否存在、JSON 是否合法

语义对象

Role/Kit/Team 字段是否完整、类型是否正确

依赖兼容

rktVersion 版本兼容性、Kit 依赖是否满足

Skills Mirror

Kit 声明的能力在 Skills Registry 中是否有对应实现

冲突检测

与已安装 Bundle 的 Role/Kit ID 是否冲突

安全审计

敏感权限检查、网络访问范围、数据边界

RKT Protocol v1.0