跳转到主要内容

概述

Skill 是一个可复用的能力包。一个 Skill 由两部分组成:
  • 一段 SKILL.md 说明文档,告诉 Agent“什么场景下用、怎么用、按什么步骤做”;
  • 该 Skill 声明的允许使用的工具,以及可选的参考资源文件(脚本、模板、子文档等)。
Skill 被打包成归档(扩展名 .zip / .skill / .tar.gz / .tgz)上传到 AI SRE。归档的根目录必须包含一个 SKILL.md 文件,其余资源文件可放在归档内任意位置,Agent 可在执行时按需读取。 启用后,该 Skill 即在会话中对 Agent 可见、可被调用。Agent 既可以自主判断何时调用某个 Skill,您也可以在对话框里用 /<skill-name>(如 /skill-creator)来显式触发它。 显式触发时还可以追加参数:/<skill-name> 参数1 参数2。SKILL.md 正文可以用 $1…$9 引用按空白拆分的位置参数,用 $ARGUMENTS 引用参数串的完整原文;这些占位符会在该轮对话发送前被替换为实际值。 如果只是想在消息里提到 /skill-name(比如问“\/skill-name 是做什么的?”)而不想触发它,可以在消息开头加一个反斜杠转义:以 \/ 开头的消息会被去掉这个反斜杠、按普通文本发送,不会被解析为命令。
团队同名 Skill 与 @ 限定语法。 Skill 名在同一团队内必须唯一,但不同团队可以各自拥有同名 Skill。当两个团队都启用了同名 Skill 且都在当前会话的可见范围内时,裸 /<skill-name> 无法确定指向哪一个,会被拒绝并提示可用的限定形式。此时需要使用 /<skill-name>@<team_id> 来消除歧义(例如 /deploy@5)。因此 @ 字符在 Skill 名中被保留,不能使用。
Skill 与 MCP 的区别见 MCP。

内置 Skill

AI SRE 运行时内置了以下 Skill,无需安装即可使用: 此外还有 init、insight、artifact-design、alert-governance、channel-noise 和 monit-query 等。monit-query 仅在账户里有已启用的 Monitors 数据源时才会加载。某条会话里实际可用的 Skill,直接问 Agent 即可。

channel-noise:只从降噪页进入,且会写配置

只能从协作空间的降噪处理页面进入。 在 协作空间详情 → 降噪处理 → 告警聚合 或 抖动检测 页面点击 让 AI 帮我配置降噪,会打开 AI SRE 面板,把该协作空间作为引用带入对话并预填 /channel-noise 提问,您发送后才启动。IM、自动化规则、Open API 里输入 /channel-noise 会被拒绝,提示 /channel-noise can only be started from its entry in the console.。它也不在 Agent 自行选用的 Skill 之列,用自然语言让 Agent“看看这个空间的告警噪音”不会触发它。 它会写配置。 它读取该协作空间自己的告警历史(默认近 30 天),先定位噪音来源,再估算若干组告警聚合与抖动检测候选设置并给出推荐;只有您明确确认后,才会写入该空间并回读复核。改动仅限告警聚合与抖动检测,事件聚合、静默、抑制、丢弃等其他降噪设置只给出建议,由您自行调整。在该页面上使用时,它把推荐值填入表单,由您点击 保存 后生效,见操作控制台页面。

从市场安装

Skill 市场位于 自定义 → 插件 → 概览 的插件目录中,归在 Skill 类别下,可按名称或描述搜索。
1

找到要安装的模板

在 自定义 → 插件 → 概览 的 Skill 类别里找到目标模板,每行展示模板名称与简介。
2

确认安装

点击模板行或其右侧的 +,确认后即可安装。市场安装的 Skill 固定为共享范围(账户内所有成员可用),会作为普通 Skill 复制到您的账户,并标注来源模板与版本。
3

管理已安装项

已安装的模板行不再显示 +,而是显示 已启用。安装后的管理与更新都在 自定义 → 插件 → Skill 的 Skill 列表里进行,见下文“管理与检视”与“自动更新与手动更新”。
新账户会自动预装一组官方 Marketplace 模板:browser-automation(浏览器自动化 CLI,用于操作网站/仪表盘/监控 UI)、mcp-builder(指导创建 MCP 服务器)与 skill-creator(见下文“在对话中添加”)。这些预装 Skill 与手动安装的 Skill 完全一样,可以在下方“管理与检视”中启用/禁用、卸载或更新到最新版本。
同名冲突:若账户里已存在同名 Skill,且它不是从同一模板安装的(例如您手工上传的自定义 Skill),安装会被拒绝——市场安装不会覆盖或接管这类 Skill,即使选择覆盖更新也一样。此时请先删除该自定义 Skill,再安装同名市场模板。

自动更新与手动更新

当市场中的模板发布了更高版本时,对应 Skill 行会出现 有更新 标记。是否自动更新取决于该 Skill 是否被本地改动过:

纯净 Skill(未改动)

安装后未做任何本地修改的 Skill,会在列表加载时自动拉取市场最新版本并覆盖,无需手动操作;更新成功后会有提示。

已改动 Skill

被本地编辑或重新上传过的 Skill,自动更新会跳过,避免覆盖您的改动。它会保留“有更新”标记,需您手动点击更新并确认覆盖。
对已改动 Skill 执行更新,会用市场最新版本覆盖您的本地改动且无法恢复。界面会弹出“覆盖更新”确认框,请谨慎操作。重新安装市场版本后,本地改动标记会被清除,该 Skill 恢复为纯净状态、重新参与自动更新。

自定义 Skill

除了从市场安装,您也可以上传自己的 Skill 包。Skill 列表页的工具栏提供两个入口:
  • 从插件目录添加:跳到 自定义 → 插件 → 概览 的 Skill 类别(即上文“从市场安装”的插件目录),挑选并安装预置的 Skill 模板,安装后出现在本列表中。需要上传 Skill 的权限。
  • 上传 Skill:打开上传表单,在表单中填写:
上传时系统会自动校验:归档是合法 zip、根目录存在 SKILL.md、frontmatter 可解析、name 符合命名规则(字母开头,仅含字母、数字、-、_,长度 1–64)、声明的工具有效(内置工具存在、MCP 服务存在)。同一团队内Skill 名不能重复,重名会被拒绝并提示换名;不同团队可以各自拥有同名 Skill。
Skill 名以外的元数据(描述、版本、标签、作者、工具等)都从 SKILL.md 的 frontmatter 解析得到,无需在表单中重复填写。
列表为空且没有在搜索时,页面显示“插件目录里有 N 个预置 Skill,安装后即可在会话中使用。”,并在有上传权限时给出 浏览预置 Skill 按钮直接跳转;插件目录为空或正在搜索时,仍显示“暂无 Skill”的原提示。

覆盖上传(Replace)

默认情况下,上传与已有 Skill 同名的归档会被拒绝。要用新版本替换已有 Skill,在检视面板选择“替换”,或在上传同名 Skill 时确认弹出的“替换”对话框。替换后 SkillID 不变,/<skill-name> 等引用继续有效;目标 Skill 不存在时不会新建。 通过 API 上传时,携带 replace=true 按 SKILL.md 中的 name 匹配并覆盖;再指定 skill_id 则按 ID 覆盖(适合 Skill 已重命名的情况),目标不存在时返回 404。

在对话中添加(skill-creator)

除了上传 zip,您还可以直接在 AI SRE 会话里创建和打磨 Skill。skill-creator 是 Flashduty 在 Marketplace 提供、并默认预置到账户的一个 Skill,专门用来“造 Skill”。在任意会话里用 /skill-creator 触发,或直接用自然语言提出需求即可:
  • 从零创建:说“帮我创建一个用于排查 X 的 Skill”,或在一次排障结束后说“把刚才这套流程固化成一个 Skill”。skill-creator 会与您澄清意图、起草 SKILL.md、(可选)建立测试用例并据此迭代,满意后一键保存为账户里的 Skill。
  • 安装现成的:点击 Skill 列表页右上角的 在对话中添加,选择装现成的。Agent 先查插件目录,没有再联网搜索候选;您选定后由它完成安装。(只有在能确定写入范围时——您有账户级权限,或当前只选中了一个您所属的团队——才显示此按钮。)
  • 改写与优化:在某个 Skill 的检视面板点击 “在聊天中编辑”,会以 skill-creator 改写该 Skill;它也能帮您打磨 description,提升被正确触发的准确度。
Agent 完成起草后可一键把内容保存为 Skill;与已有 Skill 重名时,保存前会弹出“替换”确认对话框。
Skill 归档大小有上限:通过对话中 Agent 打包保存的归档上限为 10 MB,通过网页表单或会话内呈现文件上传的归档上限为 100 MB。

管理与检视

Skill 列表显示每个 Skill 的名称、范围(共享或团队)、版本和启用状态,并标注来源模板、有更新 和 仅本地 Runner。声明了 venues: [byoc] 的 Skill 标为 仅本地 Runner,只能在绑定本地 Runner 的会话中使用,云沙箱会话中不可用;市场模板上也有同样的标记,便于安装前确认。可以按范围(全部 / 账户 / 团队)筛选,并按名称、描述或作者搜索。
用列表或检视面板上的开关切换。只有已启用的 Skill 才会对 Agent 可见;禁用后 Agent 看不到、也无法调用它。
点击编辑按钮可更新描述与归属(作用域)。市场安装的 Skill 归属固定为账户,编辑表单中作用域不可改。如需修改 Skill 内容,请下载 zip、编辑后重新上传(这会创建新版本,并把该 Skill 标记为已改动)。
在检视面板选择“替换”,用一个新的 zip 覆盖当前 Skill 内容;SkillID 保持不变,对它的引用(如 /<skill-name> 触发)依然有效。
下载完整 zip 包(含 SKILL.md 和所有资源文件),便于离线编辑或备份。
将 Skill 从当前范围移除。正在使用它的活跃会话会持续失败,直到重新安装。此操作有确认提示。

检视面板

在列表中点击任意一行,打开 Skill检视面板:
  • 左侧:Skill 包的文件树(SKILL.md、README.md 等会优先作为默认预览文件)。
  • 右侧:选中文件的内容预览,顶部显示 Skill 描述。
  • 标题区:Skill 名与短引用(如 skill-xxxxxx)、范围、来源模板版本、有更新 标记、作者、version 与完整 SkillID。
  • 操作:在聊天中试用(向新会话注入 /<skill-name>)、更新到最新版本、在聊天中编辑、替换、下载、卸载。
  • 试试这样问:如果 SKILL.md 的 frontmatter 声明了 examples,可以展开查看最多 2 条示例问题;点击其中一条会新建一条预填该 Skill 和问题的对话,确认后再发送。
Skill 包过大无法预览时,检视面板会提示体积并建议改用“下载”查看。

作用域

Skill 与其他自定义资源共用同一套作用域与权限规则,见作用域与权限。Skill 特有的几点:
  • 从市场安装固定为共享范围,任何成员都可以安装,安装时不能选团队。
  • 少量早期遗留的团队级市场 Skill,可在检视面板用“设为共享”提升为账户级,仅限账户所有者或管理员。
  • 对话框 / 自动补全只列出共享范围的 Skill 和您所属团队的 Skill,手动输入的斜杠命令遵循同样的范围。团队会话中调用其他团队的 Skill 会被拒绝并说明原因。
  • 无编辑权限时,列表对应行显示为只读。

SKILL.md 格式

SKILL.md 由 YAML frontmatter(元数据)和正文(Agent 可读的说明)两部分组成,以 --- 分隔:
frontmatter 字段如下:
venues 用于那些结构上离不开某类环境的 Skill——例如需要访问运行环境所在主机的本地二进制、本地文件或内网服务的 Skill,在云端 Sandbox 中无法工作。声明 venues: [byoc] 后,在云端 Sandbox 会话中,该 Skill 不出现在 Agent 的可用 Skill 清单里,也无法通过 /<skill-name> 触发;只有绑定了自托管 Runner 的会话才能看到并调用它。
工具的写法有两种:
  • 内置工具:直接写工具名。可用的内置工具包括 read、write、edit、bash、grep、glob、skill、mcp、todo、time、webfetch、web_search、session_transcript 等。
  • MCP 工具:写成 mcp:服务名/工具名(如 mcp:my-server/query)。上传时只校验该 MCP 服务是否存在,具体工具名在会话中加载 MCP 时才会被验证。

相关页面

管理知识

用 DUTY.md 与知识为 Agent 提供团队上下文与排障经验。

MCP(外部工具)

接入外部工具,让 Skill 在 SKILL.md 中以 mcp:服务名/工具名 调用它们。

Agent

用 Agent 扩展 AI SRE 的协作与分工能力。

控制台对话

在会话中用 /<skill-name> 显式触发 Skill,或让 Agent 自主调用。

概述

了解 AI SRE 的整体能力与定位。