在同时使用多个 AI 编程助手的团队里，"技能配置"长期处于无人治理的状态：每个工程师的各套工具各存一份拷贝，版本不一致、来源不可考、离职或换工具时无法回收。本文以阿里云百炼 CLI（bl）的 skill 命令组为对象，分析其存储模型，并评估它在团队治理场景下的实际价值与边界。全部结论基于本机实测（bl 1.22.0）。
一、问题背景：技能资产的三个治理缺口
过去一年，"agent 技能"（skill）作为可复用的能力说明文件，在开源社区快速普及。趋势榜上同一题材占据近三分之二的席位，也出现了维护者每周向多个宿主工具发布同一技能的实践。
但落到工程实践，多数实现是每个宿主各存一份拷贝，由此产生三个治理缺口：
- 版本一致性缺口：更新需遍历 N 个位置，遗漏任一即造成同团队不同行为
- 回收缺口：卸载无清单，只能按目录名推断，存在误删手工资产的风险
- 来源可核缺口：无内容指纹，"本地这份是否等于发布那份"无法验证
这三个缺口在个人场景下是麻烦，在团队场景下是合规与审计问题。
二、百炼 CLI 的 skill 命令组
bl 是阿里云百炼平台的命令行工具，命令总量 209 条，按鉴权分为三层：API Key 149 条、No Auth 40 条、Console 15 条。skill 命令组全部落在 No Auth 层，即查看、安装、更新、卸载均不需要密钥：
| 命令 | 作用 | 鉴权 | |
|---|---|---|---|
bl skill list |
注册表与本机 diff | No Auth | |
bl skill add --name <名字,...> |
安装指定技能（逗号分隔批量） | No Auth | |
bl skill add --all |
安装注册表全部技能 | No Auth | |
bl skill init |
安装全部 bailian- 前缀技能 |
No Auth | |
bl skill update |
更新至注册表最新版本 | No Auth | |
| `bl skill remove --name <名字\ | all>` | 卸载本地技能 | No Auth |
三、环境配置
npm install -g bailian-cli
bl --version
查看与安装类操作无需任何配置。仅当真实调用模型能力（如图像生成）时需要 API Key，可在百炼控制台领取。
四、存储模型：canonical copy + symlink fan-out
安装后检查各宿主工具的 skills 目录，条目均为符号链接：
lrwxr-xr-x bailian-gen -> /Users/xxx/.bailian/skills/bailian-gen
对三个被探测到的宿主（实测为 github-copilot、qoder、qwen-code）分别 readlink，目标完全相同，均指向 ~/.bailian/skills/ 下的唯一实体副本。
该模型对三个治理缺口的回应：
| 治理缺口 | per-host copy | canonical + symlink |
|---|---|---|
| 版本一致性 | 遍历更新，遗漏即漂移 | 单点更新，全宿主经链接生效 |
| 回收 | 按目录名推断 | 按锁文件 links 清单回收 |
| 来源可核 | 无 | 锁文件记录 sha256 内容指纹 |
更新一致性已实测：bl skill update 返回 10 条全部 up-to-date，无逐宿主遍历行为。
五、锁文件：治理所需的四个字段
~/.bailian/skills/skill-lock.json 为每个已装技能维护一条记录：
{
"contentHash": "sha256:d56618ed7fbd14cc4a22830f6df364566c5b725c614faf99c5bbd5a209961044",
"publishedAt": "2026-09-17T14:04:49+08:00",
"installedAt": "2026-09-17T07:22:38.894Z",
"sourceType": "oss",
"links": [
"/Users/xxx/.copilot/skills/bailian-docs-llm-wiki",
"/Users/xxx/.qoder/skills/bailian-docs-llm-wiki",
"/Users/xxx/.qwen/skills/bailian-docs-llm-wiki"
]
}
逐字段的治理含义：
contentHash（sha256）：内容指纹。使"本地副本 == 发布副本"成为可验证命题，而非信任假设。sourceType: "oss"：来源标识为官方对象存储上的注册表，区别于个人仓库分发。publishedAt/installedAt双时间戳：版本滞后判定为一次比较操作，可纳入巡检脚本。links绝对路径清单：回收的依据。卸载返回的removedLinks: 3即该清单长度的确认。
需要说明的是：开源社区当前流传若干技能安全审计的百分比数据，因来自不同扫描与不同语料、横向不可比，本文不予引用。上述四字段的价值在于结构可复现、可逐条核对，与统计数字无关。
六、一个必须写入运维手册的行为偏差
bl --help 将 --dry-run 列为全局参数（描述 "Dry run mode"），未注明命令组级别的例外。
实测：
bl skill add --name spark-video --dry-run
返回体状态为 "status": "installed"，且 canonical 目录与三个宿主目录均被真实写入；执行前四处均不存在。
结论：--dry-run 对 skill 命令组不生效。 在变更管理流程中，不得将该参数作为"预演不落地"的保证。零副作用的查看手段是 bl skill list；--dry-run 返回体中的 agents 字段（宿主探测结果）仍可用于评估影响面。
回收路径已验证可用且作用域受控：
bl skill remove --name spark-video
# {"skills":[{"name":"spark-video","status":"removed","removedLinks":3}]}
实测确认四处路径清除完毕，且未触及非注册表管理的本地目录。卸载作用域严格限定于锁文件管辖范围，这一点对手工资产较多的团队尤为重要。
七、能力面与成本边界
bl skill init 安装的 bailian-gen 技能，其注册表描述点名五组命令：bl image、bl video、bl speech、bl vision describe、bl omni，覆盖图像生成、视频生成、语音合成、语音识别、图像与视频理解。即一次分发即可为多宿主接入百炼的多模态能力栈。
能力落地验证（该步起才产生模型调用与额度消耗）：
bl image generate --prompt "一张竖版中文活动海报，主标题分两行写：技能装一次、工具随便换" --model qwen-image-3.0 --size 3:4 --watermark false --out-dir ./out --out-prefix demo
实测 14 秒返回，中文文字渲染完整：
成本边界需向团队明确：skill 组五条命令本身免鉴权、零费用；额度消耗始于真实模型调用。额度余量的查询命令属于 Console 鉴权层，需一次浏览器登录控制台，因此本文不给出具体的余量数字，以各账号控制台的额度页为准。
版本边界：注册表中的 bailian-sandbox 技能指向 bl sandbox 命令组，实测环境 CLI 1.22.0 不含该组。安装不报错、调用时才暴露缺失。建议将 CLI 版本纳入环境基线管理。
八、适用性判断：哪类技能值得纳入统一分发
社区中存在"删除技能"的实践，理由是基座模型能力提升后，部分技能会被原生能力覆盖。该判断需要分类讨论：
- 替模型思考的技能（提示词、工作流编排、输出格式）：随模型升级可被覆盖，纳入统一分发的收益有限
- 给模型接能力的技能（调用图像/语音/检索等接口）：能力位于接口而非权重，删除即永久失去，是统一分发的主要受益对象
可操作判据：安装后宿主获得的是"一段提示词"还是"一组命令"。前者可随版本演进淘汰，后者应纳入资产清单管理。
九、小结与建议
bl skill 以"单实体 + 符号链接 + 带内容指纹的锁文件"实现了技能在多宿主间的统一分发、单点更新与清单化回收，且管理面全程免鉴权，适合作为多工具团队技能治理的起点。落地时建议：
- 将
bl skill list --output json纳入环境巡检，监控outdated与untracked - 在变更手册中注明
--dry-run对该命令组不生效 - 将 CLI 版本纳入基线，规避技能指向的命令组缺失
- 额度与费用以控制台为准，管理命令本身不产生费用
CLI 安装与产品入口：百炼 CLI 安装页；模型调用所需的 API Key 在控制台领取；平台整体能力可从百炼首页了解。
