用途：按 v3 描述符创作新的 Docker sandbox kit。kit 是一个 OCI 镜像，其层是内容，manifest 注解携带描述符，说明 kit 提供什么、以类型化能力请求向宿主索取什么、以及依赖哪些其他 kit；不读取该注解的引擎会把它当普通镜像运行。若要把已有 v2 spec.yaml 迁移到 v3，应改用 migrate-kit-to-v3 技能。
主要能力：先决定 kind。workload 拥有 agent 运行环境，层是根文件系统，每个组合中恰好一个，拥有 entrypoint、env、user、workdir 及旧式 context profile，必须有内容。mixin 为他人环境添加工具、凭据或策略，层是叠加在 workload 上的 overlay，每个组合零个或多个，拥有 env、labels、ports、volumes 等可合并字段，可仅声明而无内容。mixin 不能设置 ENTRYPOINT、CMD、USER、WORKDIR 并生效；env、labels、ports、volumes 会合并，PATH 为追加。静态环境优先用 ENV，因为 sbx@1 通过 BASH_ENV 以 bash 启动 agent，profile.d 只对用户打开的终端生效。
使用方式：默认创作形式是按文件名主干配对的伴生文件：<kit>.yaml 描述符（首行 # syntax=docker/sandbox-kit:3）、<kit>.dockerfile 内容配方（仅声明的 mixin 可省略）、<kit>-context.md 与 README.md，无需 dockerfile 字段。另有内联 build 块、Dockerfile 内 # kit: 注释描述符、kind: set 列表三种形式。键为 lowerCamelCase，解码严格，未知键即报错。能力是宿主应答的类型化请求，optional: true 表示可降级，默认必需。常用类型包括 network-policy@1/@2、credential@1、ssh-agent@1、lifecycle@1、volume@1、host-mount@1、agent-context@1、long-running@1、git-identity@1、sbx@1、agent-skill@1、agent-skills@1、acp@1、agent-sessions@1、agent-interactive-sessions@1、port@1、resources@1、privileged@1。
限制：不要凭猜测声明能力；privileged@1 是最大权限放宽。版本应固定并让构建校验，未版本化的 provide 会按回退规则解析，无 version 时构建失败。宿主共享与 volume@1 是不同授权。同一路径两个宿主挂载或宿主挂载与卷冲突。块卷数据属于沙箱实例，删除实例会删除其卷。捆绑技能用 agent-skill@1 打包，源路径发布后须为字面量。ACP 适配器需验证权限姿态、stdin EOF 与 SIGTERM 取消、会话可恢复及五秒内退出。具体配置细节以各能力类型页面为准。