Bundle Skill 文本与版本

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

创建首个版本

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

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

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

首次请求省略 --skill-id。Skill Owner 生成稳定身份，保存文本的不可变版本， 返回 object.skillKey 与精确版本。名称、文件路径和版本号都不是 Skill 身份。

创建后续版本

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

baijimu bundle skill version create <bundle> --workspace-id <workspaceId> \
  --skill-id <ownerReturnedSkillId> --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 manifest catalog <bundle> skill --workspace-id <workspaceId>
baijimu bundle manifest include <bundle> skill --workspace-id <workspaceId> \
  --file baijimu.bundle.json --object-id <ownerReturnedSkillId> --version 1.0.0

CLI 在线预检后写入作者清单的 definition.resources（resourceType: SKILL）。Bundle 清单仍按 Bundle 的版本创建流程 审查差异、提交并推送 Git，再创建 Bundle 版本；Skill 文本本身由 Skill Owner 保存。

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

baijimu bundle object get <bundle> skill --workspace-id <workspaceId> --object-id <ownerReturnedSkillId>

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