Skip to content

Commit 9ae5dc9

Browse files
committed
docs(cli): update skill installation command from add --name all to init
- Replace `bl skill add --name all` with `bl skill init` across documentation - Update installation instructions in README, INSTALL, and agent skill guides - Modify code references in update checker and UI components - Adjust documentation links and cross-references accordingly - Revise command examples in protocol and asset files - Update versioning and setup instructions to reflect new command - Modify HTML UI rendering for skill installation guidance - Change internal command constants and execution calls
1 parent d6cb075 commit 9ae5dc9

24 files changed

Lines changed: 58 additions & 57 deletions

File tree

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ packages/core/src/auth/ # apiKey / console credential 解析与落盘
3535
packages/core/src/client/ # HTTP client / endpoints / console gateway
3636
```
3737

38-
Skill / 命令手册随 `skills/bailian-*/``bl skill add --name all` 安装(整包装齐,含共享协议 `bailian-protocol`)。业务 skill(`bailian-cli` / `bailian-gen` / `bailian-finetune` / `bailian-managed-agent`)执行前读 `skills/bailian-protocol/`;不要依赖 frontmatter `companions`(安装器不强制)。`tools/generate-reference.ts`**`packages/cli/src/commands.ts`** 按一级命令归属表分流写入各 `skills/<skill>/reference/`(纳入 git);`tools/sync-skill-metadata.ts``packages/cli/package.json` 同步各 `skills/*/SKILL.md``metadata.version`。两者由根脚本 `pnpm run sync:skill-assets``.vite-hooks/pre-commit` 执行。hub `bailian-cli` 的路由表不复述领域命令明细;SKILL 文案 / 安装约定 / hand-off 见 [docs/agents/skill-change.md](docs/agents/skill-change.md)
38+
Skill / 命令手册随 `skills/bailian-*/``bl skill init` 安装(装齐 registry 中全部 `bailian-*`,含共享协议 `bailian-protocol`)。业务 skill(`bailian-cli` / `bailian-gen` / `bailian-finetune` / `bailian-managed-agent`)执行前读 `skills/bailian-protocol/`;不要依赖 frontmatter `companions`(安装器不强制)。`tools/generate-reference.ts`**`packages/cli/src/commands.ts`** 按一级命令归属表分流写入各 `skills/<skill>/reference/`(纳入 git);`tools/sync-skill-metadata.ts``packages/cli/package.json` 同步各 `skills/*/SKILL.md``metadata.version`。两者由根脚本 `pnpm run sync:skill-assets``.vite-hooks/pre-commit` 执行。hub `bailian-cli` 的路由表不复述领域命令明细;SKILL 文案 / 安装约定 / hand-off 见 [docs/agents/skill-change.md](docs/agents/skill-change.md)
3939

4040
约定:
4141

INSTALL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,10 +54,10 @@ npm install -g bailian-cli
5454
安装 skills(CLI 内置,无需 Git / npx skills):
5555

5656
```bash
57-
bl skill add --name all
57+
bl skill init
5858
```
5959

60-
**Supported:** `--name all` 一次装齐整套 `bailian-*`(含共享协议 `bailian-protocol`)。
60+
**Supported:** `bl skill init` 一次装齐 registry 中全部 `bailian-*`(含共享协议 `bailian-protocol`)。
6161

6262
**Advanced / 按需子集:**
6363

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ Please read https://bailian.aliyun.com/cli/install.md and install the Aliyun Mod
8686

8787
```bash
8888
npm install -g bailian-cli
89-
npx skills add modelstudioai/cli --all -g
89+
bl skill init
9090
```
9191

9292
> Requires Node.js >= 18.17.

README.zh.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ _专为 AI Agent 打造,每个命令均可作为结构化工具调用。_
8585

8686
```bash
8787
npm install -g bailian-cli
88-
npx skills add modelstudioai/cli --all -g
88+
bl skill init
8989
```
9090

9191
> 需要预先安装 Node.js >= 18.17。

docs/agents/skill-change.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,17 @@
1111

1212
## 统一口径(安装)
1313

14-
1. **Supported install:** `bl skill add --name all`(整包装齐,含 `bailian-protocol`
14+
1. **Supported install:** `bl skill init`(装齐 registry 中全部 `bailian-*`,含 `bailian-protocol`
1515
2. **`bailian-protocol` 是共享协议 skill**,业务 skill 执行前应 Read 它
1616
3. **不要**在 frontmatter 写 `companions`,也不要对外说「companions = 安装器硬依赖」
1717
4. 子集安装:`bl skill add --name bailian-protocol,<skill>`;漏装 protocol 会导致相对路径 Read 失败
18+
5. **`bl skill add --all`** 安装 registry 全量(含 `spark-video` 等非 bailian 技能);一键安装 / `bl update``skill init`,不要用 `--all`
1819

1920
## 概念图
2021

2122
```text
2223
bailian-protocol ← 共享协议(consent / 鉴权 / 版本 / 错误上报)
23-
▲ 靠 `bl skill add --name all` 与业务 skill 同装;非安装器强制 companions
24+
▲ 靠 `bl skill init` 与业务 skill 同装;非安装器强制 companions
2425
2526
┌───────┴────────┬────────────────┬──────────────────┐
2627
bailian-gen bailian-finetune bailian-managed-agent
@@ -37,18 +38,18 @@ bailian-gen bailian-finetune bailian-managed-agent
3738

3839
### A. 分层边界
3940

40-
- [ ] **整包装齐**:安装/升级文案主推 `bl skill add --name all`;业务 skill ****声明 `companions`
41-
- [ ] **协议读取**:CRITICAL / references 可链 `../bailian-protocol/…`;若读不到 → 停止执行 `bl`,提示 `bl skill add --name all`
41+
- [ ] **整包装齐**:安装/升级文案主推 `bl skill init`;业务 skill ****声明 `companions`
42+
- [ ] **协议读取**:CRITICAL / references 可链 `../bailian-protocol/…`;若读不到 → 停止执行 `bl`,提示 `bl skill init`
4243
- [ ] **软 hand-off**:兄弟业务 skill **只写 skill 名**;已安装则 Read,未安装则 `bl … --help` 或提示整包安装;**不要**`../bailian-gen/…` 等写成执行前提
4344
- [ ] **Hub vs 领域**`bailian-cli` 的「When to use which command」只列 hub 拥有的意图;媒体 / 精调 / managed-agent 各留 hand-off 行,**不抄**领域默认模型与子命令明细
4445
- [ ] **渐进披露**:SKILL 写意图路由与领域硬规则;flags / usage / examples 以 `reference/``bl <command> --help` 为准,表后保留「勿猜 flag」指向句
4546

4647
### B. 文案与落款一致性
4748

4849
- [ ] 领域 skill(gen / finetune / managed-agent)路由或命令表后有指向 `reference/` 的句;文末 `## references`(protocol + reference)与家族对齐
49-
- [ ] description 含 WHAT + WHEN + 反触发;安装说明指向 `bl skill add --name all`,不写 companions 必装
50+
- [ ] description 含 WHAT + WHEN + 反触发;安装说明指向 `bl skill init`,不写 companions 必装
5051
- [ ] Quick examples 只演示本 skill 职责(hub 不示范 `bl image` / `bl video` 等)
51-
- [ ] 若改了安装方式:同步 `README.md` / `README.zh.md` / `INSTALL.md` / `skills/*/README*` / `skills/bailian-protocol/assets/setup.md` 中的 `bl skill add …` 示例(改 `INSTALL.md` 时按 [install-doc-change.md](install-doc-change.md) 同步静态页)
52+
- [ ] 若改了安装方式:同步 `README.md` / `README.zh.md` / `INSTALL.md` / `skills/*/README*` / `skills/bailian-protocol/assets/setup.md` 中的 `bl skill init` / `bl skill add …` 示例(改 `INSTALL.md` 时按 [install-doc-change.md](install-doc-change.md) 同步静态页)
5253

5354
### C. 归属与生成
5455

@@ -61,7 +62,7 @@ bailian-gen bailian-finetune bailian-managed-agent
6162
```sh
6263
pnpm run sync:skill-assets
6364
# 已发布版本试装
64-
bl skill add --name all
65+
bl skill init
6566
```
6667

6768
抽查:打开 `skills/bailian-cli/SKILL.md` 确认无领域子命令明细表、无 `companions`;打开对应领域 skill 确认有「勿猜 flag」与 hand-off。

packages/cli/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ Please read https://bailian.aliyun.com/cli/install.md and install the Aliyun Mod
8686

8787
```bash
8888
npm install -g bailian-cli
89-
npx skills add modelstudioai/cli --all -g
89+
bl skill init
9090
```
9191

9292
> Requires Node.js >= 18.17.

packages/cli/README.zh.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ _专为 AI Agent 打造,每个命令均可作为结构化工具调用。_
8585

8686
```bash
8787
npm install -g bailian-cli
88-
npx skills add modelstudioai/cli --all -g
88+
bl skill init
8989
```
9090

9191
> 需要预先安装 Node.js >= 18.17。

packages/commands/src/commands/config/inventory.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -128,8 +128,8 @@ function countFiles(dir: string, budget = 500): number {
128128
}
129129

130130
/**
131-
* Skill directories to scan, keyed by the module that owns them. `bl skill
132-
* add --name all` fans skills out into each installed agent, so the same skill can
131+
* Skill directories to scan, keyed by the module that owns them. `bl skill init` /
132+
* `bl skill add` fans skills out into each installed agent, so the same skill can
133133
* live in several of these roots at once.
134134
*/
135135
function skillRoots(home: string): Array<{ source: string; dir: string }> {

packages/commands/src/commands/config/ui-html.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1444,7 +1444,7 @@ export const PAGE_HTML = `<!doctype html>
14441444
function renderSkills() {
14451445
var body = document.getElementById('skillsBody');
14461446
var pager = document.getElementById('skillsPager');
1447-
if (!SKILLS.length) { pager.innerHTML = ''; renderEmpty(body, 'No skills installed.', 'Install with <code>bl skill add --name all</code>'); return; }
1447+
if (!SKILLS.length) { pager.innerHTML = ''; renderEmpty(body, 'No skills installed.', 'Install with <code>bl skill init</code>'); return; }
14481448
var list = SKILLS.filter(function (s) { return skillMatches(s, SKILL_Q); });
14491449
if (!list.length) { pager.innerHTML = ''; renderEmpty(body, 'No skills match "' + SKILL_Q + '".', ''); return; }
14501450
var info = pageSlice(list, SKILL_PAGE, getPageSize('skills')); SKILL_PAGE = info.page;

packages/commands/src/commands/update.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ import {
2020
type AnsiStyles,
2121
} from "bailian-cli-runtime";
2222

23-
const SKILL_INSTALL_CMD = "bl skill add --name all";
23+
const SKILL_INSTALL_CMD = "bl skill init";
2424

2525
function updateAgentSkill(color: AnsiStyles): void {
2626
process.stderr.write("\nUpdating agent skill...\n");

0 commit comments

Comments
 (0)