技能中心（Skills）

Skills 是把提示词指令、运行脚本、依赖声明和执行约定封装在一起的可复用能力包。与单一 HTTP / 数据库工具不同，Skill 既可以只提供 Agent 需要遵循的详细规约（指令型），也可以在隔离沙箱里运行脚本并产出文件（脚本型）。

平台入口是能力 > Skills（/app/capabilities?tab=skills）；平台管理员还可以在管理后台 > 能力 > Skills（/capabilities?tab=skills）统一查看系统级与团队级 Skill，并从这里导入。

查看 Skill 需要技能查看权限，导入与维护需要技能管理权限，沙箱测试需要沙箱执行权限。普通成员通常只有查看权限：可以在 Agent 编排里选用已安装的 Skill，但不能导入或修改。权限由平台管理员在角色中授予，见角色与权限。

Skill 包结构

每个 Skill 是包里的一个目录，目录根下必须有 SKILL.md（UTF-8 编码）：

my-skill/
├── SKILL.md              # 必须：元数据与提示词指令
├── scripts/
│   └── run.py            # 可选：脚本型 Skill 执行的脚本
└── assets/               # 可选：模板、规则或静态资源

SKILL.md 由 YAML 前置元数据与 Markdown 正文组成：

---
name: text-summarizer
display_name: 文本摘要增强器
description: 提供长文本结构化摘要、要点提炼与多语言对照
version: 1.0.0
category: productivity
icon: FileText
x-clouisle:
  execution:
    mode: instructions
  input_schema:
    type: object
    properties:
      text:
        type: string
        description: 待摘要的原始文本
    required:
      - text
---

你是一个专业的长文本提炼专家。当用户提供长篇文档时，请按以下步骤处理：
1. 提取 3-5 条核心结论；
2. 输出要点表格；
3. 保留关键数据并给出事实溯源。

必填：name（小写字母、数字、下划线或中划线）与 description。可选：display_name（界面展示名，缺省用 name）、version、category、icon，以及 x-clouisle 下的执行模式与输入参数结构。正文就是 Agent 会读到的指令。

执行模式

模式	运行方式	适用场景
指令型（默认）	不执行代码。`SKILL.md` 正文会作为规约注入 Agent 上下文，指导模型按固定流程工作。	写作规范、分析流程、代码审查准则、行业 SOP
脚本型	在隔离沙箱里运行包内声明的脚本（Python / Node.js），返回标准输出、错误与生成的文件（产物）。	复杂计算、数据统计、图表绘制、批量文件转换

Skill 卡片与详情页会标明来源（Zip、Git 或旧版）；旧版表示由迁移前的沙箱 Skill 配置转为技能包。执行模式写在 SKILL.md 里，导入后不能在界面单独修改。

包限制与校验

ZIP 上传：只接受 .zip，单文件上限 50 MB，解压后总大小上限 50 MB，最多 500 个文件，单个解压文件上限 10 MB。
禁止危险内容：包内不能有符号链接、嵌套压缩包或 ../ 这类跨目录路径。
Git 仓库：必须是公开的 HTTPS 仓库，可指定分支、标签或提交；拉取超时 180 秒。
缺少 SKILL.md、元数据格式错误或名称不合法的包会在预览里标为无效，不会安装。

导入 Skill 包

Skill 只能通过导入创建

平台没有「新建 Skill」的手动入口，创建 Skill 的唯一方式是导入 ZIP 或 Git 仓库。导入后只能调整元数据（显示名、描述、图标、分类、启用状态、默认配置）；要改 SKILL.md 正文或脚本内容，必须重新导入。

前往能力页（/app/capabilities），切到 Skills 标签。
点击右上角导入 Skills。
选择来源：
- 上传 Zip：选择包含一个或多个 Skill 目录的 .zip。
- Git 仓库：填写公开 HTTPS 仓库地址，可选填分支、标签或提交（如 main、v1.0.0）。
点击扫描预览。预览表为每个 SKILL.md 目录列出一行：
- 包路径与 Skill（展示名 + 描述）。
- 状态：有效、冲突（团队里已有同名 Skill）、名称重复（同一来源里出现多次）。
- 操作：安装、更新、跳过。
无冲突项默认勾选；冲突项默认不勾选，需要覆盖时手动勾选并选择更新（会用新包覆盖同名 Skill，名称与归属不变）。同一来源里重名的包默认只安装第一个。
确认后点击安装选中项，列表随即出现新 Skill，状态为已启用。