创建技能

用于设置技能的展示名称。省略时，服务端使用 SKILL.md 中的 name。

使用 files 字段名上传技能文件。files[] 是兼容字段名，两者表示同一组技能文件。

files 与 files[] 至少传入一项。任选一种字段名即可；同时传入时，服务端会合并处理文件。

该字段支持以下上传方式：

• 单个 ZIP 文件。
• 单个 SKILL.md 文件。
• 重复传入该字段，上传保留相对路径的多个文件。

上传内容必须满足以下限制：

• 每次请求最多上传 500 个文件，所有上传文件的原始大小合计不超过 30 MiB。
• 上传 ZIP 文件时，解压后单个文件不超过 30 MiB，所有文件总大小不超过 120 MiB。
• ZIP 文件或多文件目录只能包含一个顶层目录，且该目录下必须直接包含且只能包含一个 SKILL.md。
• SKILL.md 的 YAML frontmatter 必须包含非空的 name 和 description。
• name 去除首尾空白后长度为 1～64 个字符，只能包含小写英文字母、数字和连字符（-），不能以连字符开头或结尾，也不能包含连续连字符。

files 的兼容字段名。上传方式和校验规则与 files 相同。

重复传入 files[] 时，每个文件的 filename 需要保留相对于技能目录的路径。同时传入两个字段时，服务端会合并处理文件。

用于控制是否为技能启用内容保护。

• true：方舟平台在运行技能时注入保护指令，降低技能内容被直接输出的风险。
• false：方舟平台不启用该保护。

技能创建时间，为 Unix 时间戳，单位为秒。

技能的展示名称。未配置时，服务端返回 SKILL.md 中的 name。

用于唯一标识新建的技能，值以 skill- 开头。后续查询、更新、删除技能和管理技能的不同版本时需要使用该 ID。

表示新建技能的版本号，固定为 1。

用于标识响应对象的资源类型，固定为 skill。

表示技能是否已启用内容保护。true 表示已启用，false 表示未启用。

表示技能来源，固定为 custom。该值表示当前账号上传的自定义技能。

技能最后更新时间，为 Unix 时间戳，单位为秒。创建技能时，该值与 created_at 相同。

表示方舟平台从 SKILL.md 中解析出的技能描述。

表示 SKILL.md 中定义的技能名称。