Skills 与插件
Skills
Skill 是什么、装在哪、同名谁生效。
Skill 是什么
Skill 是一段打包好的工作流说明（SKILL.md 加参考资料）。装上之后，Agent 在对应场景会自动调用它——比如「发版检查清单」「SQL 评审流程」这类约定，不必每次写进提示词。
浏览 Skills 市场可以看到平台上发布的技能：名称、简介、发布者与发布时间。
SKILL.md 的规则
每条 Skill 就是一个目录，里面一个 SKILL.md：
---
name: my-skill
description: 做什么、什么时候该用它
---
正文：步骤、清单、约定。| 约束 | 值 | 说明 |
|---|---|---|
| name | ^[a-z0-9][a-z0-9-]{0,63}$ | 缺省取目录名；frontmatter 写了就和目录名一致，不一致出诊断并以 name 为准 |
| description | 必填，≤ 1024 字符 | 渐进披露里它是模型唯一的判断依据，缺了整条作废 |
| 文件大小 | ≤ 256 KB | 正文超过 64 KB 会被截断 |
| 可选字段 | category、model、allowed-tools | category 缺省「未分类」 |
扫描上限 200 条；坏文件不会拖垮整轮扫描，只会进诊断。
装在哪儿
| 作用域 | 位置 | 优先级 |
|---|---|---|
| 项目 | <项目根>/.next-cowork/skills/<name>/ | 最高，同名时覆盖全局 |
| 全局 | ~/.next-cowork/skills/<name>/ | 中 |
| 插件携带 | 插件包内 skills/<name>/ | 最低（合理默认，用户自己写的永远说了算） |
登录了平台账户时，以上路径都在 ~/.next-cowork/config-profiles/<账户>/ 下，CLI 会自动跟随当前登录作用域。
同名冲突的两条规则：
- 项目 / 全局同名：项目胜出。
- 两个插件贡献同名：按插件 id 排序先来的赢，并在诊断里说明另一条被跳过。
插件携带的 Skills
插件可以在包里自带 Skill（清单的 contributes.skills）。客户端原生支持：
- 插件启用时，包内的 Skill 出现在模型的技能列表里；
- 禁用或卸载时，这些 Skill 即时撤回（下一轮扫描就不在了）；
- Skill 的名字与描述来自各自
SKILL.md的 frontmatter，清单里不重复声明。
机制与约定（优先级的来由、市场页的展示）见插件 Skill。
SSH 工作区的特殊行为
工作区在 SSH 远端时，全局与插件 Skill 若除了 SKILL.md 还带了其他文件（脚本、参考资料），会被标记 client-assets：文件在用户笔记本上、命令却跑在服务器上，模型照着正文跑脚本只会报「找不到文件」。只带正文的 Skill 不受影响。
安装方式
见安装方式。