# Bundle Skill 文本与版本

直接创建 Skill 纯文本不可变版本，保留稳定身份和精确版本，再纳入 Bundle。

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

## 创建首个版本

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

```bash
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 身份并指定新版本：

```bash
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 清单。查询目录后选择精确版本：

```bash
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.skills`。Bundle 清单仍按 Bundle 的版本创建流程
审查差异、提交并推送 Git，再创建 Bundle 版本；Skill 文本本身由 Skill Owner 保存。

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

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

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