概述
Skill 是一个可复用的能力包。一个 Skill 由两部分组成:- 一段 SKILL.md 说明文档,告诉 Agent“什么场景下用、怎么用、按什么步骤做”;
- 该 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
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:打开上传表单,在表单中填写:
上传时系统会自动校验:归档是合法 zip、根目录存在
SKILL.md、frontmatter 可解析、name 符合命名规则(字母开头,仅含字母、数字、-、_,长度 1–64)、声明的工具有效(内置工具存在、MCP 服务存在)。同一团队内Skill 名不能重复,重名会被拒绝并提示换名;不同团队可以各自拥有同名 Skill。
Skill 名以外的元数据(描述、版本、标签、作者、工具等)都从
SKILL.md 的 frontmatter 解析得到,无需在表单中重复填写。覆盖上传(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,提升被正确触发的准确度。
管理与检视
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.md 格式
SKILL.md 由 YAML frontmatter(元数据)和正文(Agent 可读的说明)两部分组成,以 --- 分隔:
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 的整体能力与定位。