Bundle Skill 文本与版本

Skill 是一段纯文本指令，可以使用 Markdown 编写。创建 Skill 版本不需要创建项目或提交 Git， 也不上传 ZIP、脚本和附件。文本可以包含供读者参考的链接；链接指向的内容不会自动随 Skill 打包。

创建首个版本

在本地编写 UTF-8 文本文件，例如 SKILL.md，然后在所属 Bundle 中创建版本：

baijimu bundle resource skill version create <bundle> --workspace-id <workspaceId> \
  --resource-key review-guidance --name "Review guidance" --content @SKILL.md --version 1.0.0

首次创建的 --name、--content、--version 和 --resource-key 必填，可用 --description 补充展示说明。 --content 接受直接文本或 @文件路径；内容不能为空，UTF-8 编码后最多 1 MiB。

首次请求省略 --skill-id，使用必填的 --resource-key 指定作者 key。Owner 保存 key 和纯文本不可变版本， 返回相同的资源身份与精确版本。后续版本使用 --skill-id 指定已有 key，不再传 --resource-key。名称、文件路径和版本号都不是 Skill 身份。

创建后续版本

修改文本后，沿用返回的 Skill 身份并指定新版本：

baijimu bundle resource skill version create <bundle> --workspace-id <workspaceId> \
  --skill-id <skillKey> --name "Review guidance" \
  --content @SKILL.md --version 1.0.1

Skill 仍然需要版本。版本必须是完整的 SemVer，例如 1.0.0，不能使用 latest、范围或缺段版本。 同一个 Skill 的已有不可变版本不能覆盖。创建 1.0.1 不会改变 1.0.0 的文本， 也不会自动升级引用旧版本的 Bundle。

选择版本并纳入 Bundle

Skill 版本创建成功不表示已安装，也不自动更新 Bundle 清单。查询目录后选择精确版本：

baijimu bundle definition read <bundle> --workspace-id <workspaceId> --json
# 将 data.definition 保存为 definition.json，编辑 resources 并保留其余内容。
baijimu bundle definition update <bundle> --workspace-id <workspaceId> \
  --expected-revision <readRevision> --definition @definition.json

将所选精确版本写入数据库定义的 resources（resourceType: SKILL）。按统一定义流程审查并更新数据库，再以准确修订创建 Bundle 版本；Skill 文本由 Skill Owner 保存。

查看 Skill 的展示版本和文本：

baijimu bundle resource object get <bundle> skill --workspace-id <workspaceId> --object-id <skillKey>

如果首次创建请求结果不明，先查询目录核实是否成功，避免重复创建对象。 旧的 --project-id、--git-commit-id 及项目/GitHub 包导入参数已移除；请升级 CLI 后使用纯文本版本创建命令。