外观
你需要准备什么
- 一个手机号：注册收短信验证码用；也可以用邮箱注册。
- 一台 Mac 或 Linux 电脑：Windows 请用 WSL（Windows 自带的 Linux 子系统）。
- 一个浏览器：注册、登录、看技能广场都用它。
- 一个终端：Mac 是「终端」，Windows 是 WSL 窗口——命令都往这里粘贴。
不需要懂编程，命令复制粘贴即可。本指南里的每条命令都能整行复制、原样回车；只有 SKILL.md 里的名字、简介这类字段需要你自己改。
什么时候该用 CLI
发布技能有两条路：网页和命令行（CLI）。按你的场景挑：
| 场景 | 推荐方式 | 说明 |
|---|---|---|
| 一次性发布 | 网页 | 网页发布入口在建设中；现阶段请用 CLI，步骤见下文，效果一致。 |
| 频繁迭代 | CLI | 改完就发、发完再改，命令行比来回点网页快。 |
| 接 CI（持续集成） | CLI | 让流水线自动执行 csb publish，不需要有人点页面。 |
| 团队协作 | CLI | 发布命令能写进仓库文档，谁执行都是同一套步骤。 |
下面五步按 CLI 路径写。想先看一眼长什么样，可以直接跳到第五步。
第一步：注册账号
01
打开登录页
02
注册
两种都行：手机号 + 短信验证码（推荐），或邮箱注册。手机号收一条短信、填进去即注册成功；邮箱注册按页面提示填邮箱与口令。
03
看到什么算成功
登录成功后页面进入已登录状态：页面上出现你的账号名（而不是「登录 / 注册」按钮）。记下你注册用的手机号或邮箱，后面步骤都用这个账号。
第二步：创建 API Token
Token 是让命令行替你操作的一串口令，只属于你的账号。目标入口是控制台的「设置 → API 密钥」，在这里创建、查看与吊销。
入口在建设中，现阶段请联系管理员发放。控制台的「设置 → API 密钥」还没上线，别按不存在的按钮找。现在要 Token，就走联系我们说明用途（发布技能），由管理员发放。入口上线后本页会更新成自助创建步骤。
拿到 Token 后注意三条：
- Token 只在你本机保存，不进代码仓库、不发群、不贴到网页上。
- 只显示一次的话当场存好；丢了不用找回，重建一个再登录即可。
- Token 对应你的账号权限：谁拿到它就能以你的名义发布。
第三步：安装 CLI
命令行工具的包名是 @chensibo/cli，装完得到 csb 命令。需要 Node.js 18 或更高版本，终端里执行：
先确认 Node 版本：node -v，显示 v18 或更高即可。没有 Node 就先到 nodejs.org 装 LTS 版，装完重开一个终端窗口再继续。
bash
npm install -g @chensibo/cli本指南只写 npm 装法：curl 一键安装脚本尚未上线，上线前不写、不用。
看到什么算成功：终端执行
bash
csb --version能打出版本号就装好了。打不出来见常见问题的 command not found。
第四步：登录
把上一步拿到的 Token 接到 CLI 上（<token> 换成你的真 Token）：
bash
csb login --key <token> --host https://chensibo.cn再确认登录的是不是你：
bash
csb auth whoami看到什么算成功：csb auth whoami 打出你的账号信息（与注册的手机号或邮箱一致）。它读的是服务端接口 /api/cli/whoami，返回 401 就是 Token 不对，见常见问题。
凭据只落在你本机的配置目录里（~/.config/chensibo），不会写进项目目录。换电脑、重装系统后重新 csb login 即可。
第五步：发布第一个 Skill
一个 Skill 就是一个文件夹，核心是里面的 SKILL.md。先建目录：
bash
mkdir -p my-skill然后在 my-skill 里新建 SKILL.md，开头一段是「名片」（frontmatter），字段照填：
markdown
---
slug: my-skill
version: 0.1.0
summary: 一句话说清这个技能替 Agent 做什么
license: MIT
displayName: 我的第一个技能
---
# 正文
这里写给 Agent 看的步骤、约定与示例，可以继续用 Markdown 分小节。| 字段 | 必填 | 写什么 |
|---|---|---|
slug | 必填 | 技能的英文标识，全站不重名；别人安装时就用它（csb install <slug>）。小写字母、数字与连字符。 |
version | 必填 | 版本号，语义化形如 0.1.0；每次更新都往上加。 |
summary | 必填 | 一句话简介，会显示在技能广场列表里。 |
license | 必填 | 许可证标识，如 MIT；按你选的许可证分发。 |
displayName | 可选 | 展示名（中文名）。不填就用 slug 展示。 |
写完先自检，不上传：
bash
csb publish ./my-skill --dry-run看到什么算成功：命令打印出校验通过的摘要（slug、version 等）且没有报错。--dry-run 只检查不发布，改错的机会在这里。
自检过了再正式发布：
bash
csb publish ./my-skill --changelog "首次发布"--changelog 后面引号里写这次改了什么，会留在版本记录里。发布走服务端接口 /api/cli/skills。
更新 Skill
改完内容后两步走：把 SKILL.md 里的 version 往上加（如 0.1.0 → 0.1.1），再发布一次：
bash
csb publish ./my-skill --changelog "修了什么、加了什么"同一个 slug 下发新版本，不用换名字；换新 slug 会被当成新技能。
通过 Agent 自然对话发布
用 Cursor、Claude Code 这类开发助手时，把下面这段整段复制给它（my-skill 换成你的目录名），它会照本页流程走：
我要发布一个 Skill。请先读 https://chensibo.cn/skills/guide.html 的使用指南，然后按指南帮我完成发布： 1. 检查 ./my-skill/SKILL.md 的 frontmatter（必填 slug / version / summary / license，displayName 可选）； 2. 执行 csb publish ./my-skill --dry-run 自检，把报错修掉； 3. 自检通过后执行 csb publish ./my-skill --changelog "本次改动说明"，并告诉我发布结果。 不要编造技能字段值；我已在本机执行过 csb login。
Agent 走的命令与你手敲的完全一致，规范也以本指南为准。
装别人的技能（顺手一提）
你也是技能的使用者。三条常用命令，口径与发布侧一致：
csb search <关键词>搜技能（服务端接口 /api/skills）csb info <slug>看技能详情（版本、简介、许可证）csb install <slug>安装到你的 Agent 工作目录csb auth whoami看当前登录的账号（接口 /api/cli/whoami）常见问题
执行 csb 报 command not found
三种可能，按顺序试：
① 装完没重开终端——关掉终端窗口重开一个再试。
② Node 的全局命令目录不在 PATH：执行 npm prefix -g 看输出的路径，把它的 bin 目录加进 PATH，或直接用 npx @chensibo/cli 顶一下确认包装上了。
③ 当初没装成：重跑 npm install -g @chensibo/cli，看有没有报错（权限不够就按报错提示加 sudo 或改 npm 目录）。
登录或发布报 401
401 = Token 无效或已过期。回第二步重新拿一个 Token（现阶段联系管理员发放），然后重新登录：
csb login --key <新token> --host https://chensibo.cn
再用 csb auth whoami 确认。注意 <token> 两边的尖括号要去掉、不要带空格。
发布报 409：slug 冲突
409 = 这个 slug 已被占用。两个选择：
① 你在发新版本：确认 slug 就是自己之前发的那个，把 version 往上加后重发。
② 你在发新技能：换一个没被占用的 slug。占用关系以服务端为准，换名重试即可。
发布报 429：被限频
429 = 短时间内请求太频繁，被限频了。这不是错误内容，稍等片刻再试就行；连续脚本发布记得在命令之间加间隔。
发布成功了，但技能广场详情页看不到
命令与接口速查
csb login --key <token> --host <url>登录并保存凭据（host 用 https://chensibo.cn）csb auth whoami看当前账号（GET /api/cli/whoami）csb publish <dir> [--dry-run] [--changelog "..."]发布技能目录（POST /api/cli/skills）csb install <slug>安装技能csb search <q>搜技能（GET /api/skills?q=）csb info <slug>看技能详情命令与接口口径以上表为准；字段与参数细节以接口注释为准。未上线入口（控制台「设置 → API 密钥」自助创建、网页发布、curl 一键安装脚本）标注「建设中」，不写成已有。技能展示见技能广场，平台能力见开放能力，账号与 Token 问题走联系我们。
本页讨论
0 条评论还没有评论，来说第一句。