技能工作室
技能工作室(Skill Studio)是平台的在线技能开发环境。你可以在浏览器里创建技能、与一个开发引擎对话让它生成/修改技能文件、实时调试、校验打包,并一键发布到能力中心走审核流程——无需本地搭建开发环境。
入口
在左侧导航栏单击技能开发(位于「智能体模版」下方的一级菜单),进入技能工作区列表页。
创建技能工作区
- 在技能工作室列表页,单击右上角创建技能。
- 填写工作区名称(如「图表绘制技能」)和简要描述,单击创建并开发。
进入工作区详情页后,开发引擎会自动启动。
工作台布局
详情页由顶部操作栏加对话、文件两个工作区组成:
- 顶部操作栏:返回列表、工作区名称与引擎状态,以及编辑配置、打包、发布、重启实例等操作按钮。单击编辑配置打开技能配置弹窗,可在线编辑技能元数据(manifest 需含
type: "skill")。 - 中栏 · 对话:与开发引擎对话。顶部「开发 / 调试」两个 Tab:
- 开发:用于让引擎帮你创建/修改技能文件(具备读写、bash 等工具)。
- 调试:用你编写的
SKILL.md作为技能,验证技能行为(只读工具,不会改文件)。
- 右栏 · 文件:工作区文件树。工具改动过的文件会标 🟢新增 / 🟡修改。
让引擎开发技能
在「开发」Tab 的输入框描述需求,例如「创建一个图表绘制技能,包含 SKILL.md 和 manifest.json」。引擎会调用工具(write/edit/bash/grep 等)生成文件,工具调用以可折叠卡片形式显示在回复中:
- write:展示路径 + 写入内容
- edit:展示路径 + 改动 diff(增删行着色)
- bash:展示命令 + 输出
- ls / read / grep:展示路径或匹配结果
文件改动后,右侧文件树自动刷新。
在线编辑文件
在右栏文件树单击文件,会打开预览/编辑大弹窗,用内置代码编辑器(支持 Markdown / JSON 等语法高亮)直接查看和编辑:
- 修改后保存按钮高亮,单击保存写入工作区并关闭弹窗。
- 关闭弹窗时有未保存改动会提示确认。
- 文件树顶部新建文件 / 上传文件按钮可添加文件。
- 文件节点的 ⋮ 菜单(或右键)支持重命名 / 下载 / 删除。
编辑 SKILL.md / manifest.json 后,切到「调试」Tab 单击重载技能让调试引擎重新加载技能定义(无需重启)。
打包、发布
详情页顶部的打包、发布按钮:
- 打包:把工作区打成 zip 下载(自动排除引擎内部目录)。
- 发布:先自动校验
SKILL.mdfrontmatter(name/description)与manifest.json(name/version/author/description/engine/type=skill)是否完整合规,不合规会提示缺失字段并中止;校验通过后打包上传到能力中心,自动安全扫描后创建草稿版本。发布弹窗显示:- 风险等级(低/中/高/阻断)与发现项列表
- 阻断级风险需在能力中心处理后方可发布
发布成功后,能力中心会出现该技能的草稿版本,你在能力中心走「提交审核 → 批准 → 发布」流程即可让其他用户订阅。
绑定 MCP 服务
技能配置弹窗(单击顶部编辑配置打开)底部的「MCP 绑定」区块,可为调试会话启用平台已接入的 MCP Server。绑定只对调试会话生效:
- 在工作区详情页顶部单击编辑配置,打开技能配置弹窗。
- 在「MCP 绑定」区块打开目标服务的开关,绑定即时保存;切到调试 Tab 后单击顶部重启实例(或离开再进入该工作区)后生效。
- 列表为空说明平台尚未接入 MCP Server,可单击前往 MCP 服务跳转到 MCP 服务页完成接入后再回来绑定。
调试技能
切到「调试」Tab:
- (可选)编辑
SKILL.md后单击重载技能让其生效。 - 在输入框发送消息,调试引擎会用你的技能定义回复。
- 调试引擎只有只读工具,不会修改技能文件,可安全验证技能行为。
预期结果
- 创建工作区后,开发引擎自动就绪(状态标签
ready)。 - 发送消息后,回复逐字流式渲染,工具调用以卡片展示。
- 重载页面后,历史对话(含工具调用)完整保留。
- 发布后,能力中心出现该技能草稿,扫描结果显示风险等级。