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 ` )
15152 . ** ` bailian-protocol ` 是共享协议 skill** ,业务 skill 执行前应 Read 它
16163 . ** 不要** 在 frontmatter 写 ` companions ` ,也不要对外说「companions = 安装器硬依赖」
17174 . 子集安装:` 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
2223bailian-protocol ← 共享协议(consent / 鉴权 / 版本 / 错误上报)
23- ▲ 靠 `bl skill add --name all ` 与业务 skill 同装;非安装器强制 companions
24+ ▲ 靠 `bl skill init ` 与业务 skill 同装;非安装器强制 companions
2425 │
2526┌───────┴────────┬────────────────┬──────────────────┐
2627bailian-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
6263pnpm 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。
0 commit comments