文档能力扩展
文档目录

Skills

左侧栏「MCP/Skills」按项目管理能力:每个 Skill 是一份带说明的操作手册,装上就能在会话里用 / 调用,也能编辑内容和资源文件。

更新于 2026年11月10日

Skill 把一套做法固化为文件:使用时机、执行步骤、依赖的脚本与模板。装好后 Agent 遇到匹配任务会自行调用,也可以在输入框用 / 指定。

入口与结构

左侧栏「MCP/Skills」打开的是一个整页视图。页头是页标题、数量与一句用途说明(Skills 页写「按用途分组管理这个项目的 Skill:启用、更新、导入,或进入详情编辑 SKILL.md。」),右侧是主操作「导入」和项目切换下拉「切换能力中心项目」;再下一行是 Skills / 企业 Skills / MCP 三个分段页签,搜索框在同一行右侧。

  • 企业 Skills 页签只在账号有企业权益时出现。
  • 三个页签的搜索框各自命名:「搜索 Skills」「搜索企业 Skills」「搜索 MCP 服务器」。

Skills 与 MCP 都是按项目安装的,换项目整页内容跟着换,切换后提示「已切换到项目「X」」。项目右键菜单里的「配置 MCP 与 Skills」会直接跳到这里。

没选项目时整页显示「未选择项目」和「请先在 Agent 模式下选择或创建一个项目,再来管理它的 Skills 与 MCP。」

列表

页头下方是一条「Proma Coach」横幅,标「内置核心 · 始终启用」,不占卡片位。

再往下是状态筛选:全部、已启用、已关闭、可更新、30 天未用,各带真实数量;筛选生效时右侧显示「n / total 个匹配」。

两个区块:

  • 我的 Skills:当前项目装的可增删改的 Skill。
  • PROMA 内置:随应用分发的 Skill,可以停用,不能删除。

区块内按分组折叠,没有分组的归到「未分组」;折叠状态按项目记住,未分组默认收起。搜索或筛选生效时,命中的分组强制展开,不会藏在收起的分组里。

卡片上能看到:

  • 左上角色块加名称首字母(SKILL.md 里写了 emoji 图标时优先显示它),角上是启用开关,关掉后整张卡变淡。
  • 名称下面一行等宽小字是 slug,再往下是两行能力摘要;底部脚注是来源、版本和用量,字号比正文小。
  • 用量写成「刚刚用过」「N 天前用过」「未使用」,悬停显示加载过的会话数和最近一次时间。
  • 来源写成「内置」「企业」或导入来源的项目名;本项目自己建的 Skill 没有来源标签。
  • 导入了更新的版本时,卡片标题旁出现蓝色「可更新」,点它同步来源最新版本;企业来源的可发布版本在悬停时露出「发布」或「推送」。

「我的 Skills」区块头有「AI 分类」,悬停提示「创建 Agent 会话,读取 SKILL.md 内容并补全 group」;没有 Skill 时入口不可用。

30 天未用

「30 天未用」筛的是适合退役的 Skill,判定只有一条规则:非内置,且从未在任何会话里被加载过,或距上次加载已经超过 30 天。

  • 命中的卡片按最久没用的排在每个分组最前。
  • 筛选上方有一行说明:「这 N 个 Skill 超过 30 天没有被加载过(不含 Proma 内置)。关掉后它们不再进入能力候选」,右侧是「关闭这 N 个」,一次关掉其中仍启用的那些。
  • 用量统计完成前不会把任何 Skill 判为闲置,所以刚进页面时这个数字可能是 0,稍等才出来。
  • 什么也没筛到时显示「没有闲置 Skill」,提示「最近 30 天用过的 Skill 不会出现在这里」。

详情页

顶部一行是返回按钮「Skills」、斜杠后的 slug,右侧是保存状态:「自动保存」「正在保存…」,失败时变成「重试保存」。下面是色块、名称、版本与来源标签,右侧一组动作:

  • 启用开关,附「已启用」或「已禁用」。
  • 更新到最新:从导入来源同步最新版,或从企业库重新拉取;没有新版时不出现。
  • 打开目录:用系统文件管理器打开这个 Skill 的目录。
  • 卸载:内置 Skill 没有这个按钮,也不能删。

正文是两个页签:

  • 说明:上面一张属性卡,名称和描述可以直接改,停止输入后自动保存,数据源和位置只读;下面是 SKILL.md 正文,点正文即可编辑,Cmd/Ctrl + S 立即保存。
  • 资源文件:标题旁是文件数。可以新建文件和目录、重命名、删除、打开编辑再保存;SKILL.md 本身不在这个树里。切到这个页签时正文区会放宽。

从详情返回列表时,列表回到原来的滚动位置。

导入与分类

  • 导入打开「从其他项目批量导入 Skill」:选来源项目,多选目标 Skill,确认按钮是「一键导入所选(N)」。同名的自动跳过,结果提示形如「已导入 N 个 Skill(跳过 a、失败 b)」。
  • AI 分类会新建一个会话并预填整理任务,提示「已创建 Skills 分类整理会话」;整理只改说明里的分组字段,不动正文。

会话中的使用

  • 在输入框输入 / 唤起候选,列表标题「调用 skill」,只列已启用的,空态「无匹配 Skill」。
  • 一轮里用过的 Skill 会在回复下方显示紫色小标签,提示「本轮已使用的 Skill,点击在右侧 Skills 中查看和修改」,点开直达详情。

注意

  • 装在 A 项目的 Skill 在 B 项目不可见,跨项目使用时通过「导入」迁移。
  • 没有「新建空白 Skill」的按钮。需要新建时,让 Agent 在会话里创建,或复制已有 Skill 后修改。
  • 同名冲突不会自动覆盖,启用或导入时会失败或跳过;先处理同名项。
  • 详情页和外部编辑器同时改 SKILL.md 时,外部改动会静默刷新进来,不要两边同时编辑。
  • 资源文件单个上限 10MB,超出会直接提示「文件过大(x MB),超过 10 MB 限制」。
  • 「30 天未用」只认会话里真实加载过的记录:刚装上还没用过的 Skill 也会被算作闲置,批量关闭前先确认列表。
本页内容