Skip to content

技能工作室

技能工作室(Skill Studio)是平台的在线技能开发环境。你可以在浏览器里创建技能、与一个开发引擎对话让它生成/修改技能文件、实时调试、校验打包,并一键发布到能力中心走审核流程——无需本地搭建开发环境。

入口

在左侧导航栏单击技能开发(位于「智能体模版」下方的一级菜单),进入技能工作区列表页。

创建技能工作区

  1. 在技能工作室列表页,单击右上角创建技能
  2. 填写工作区名称(如「图表绘制技能」)和简要描述,单击创建并开发

进入工作区详情页后,开发引擎会自动启动。

工作台布局

详情页由顶部操作栏加对话、文件两个工作区组成:

  • 顶部操作栏:返回列表、工作区名称与引擎状态,以及编辑配置打包发布重启实例等操作按钮。单击编辑配置打开技能配置弹窗,可在线编辑技能元数据(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 单击重载技能让调试引擎重新加载技能定义(无需重启)。

打包、发布

详情页顶部的打包发布按钮:

  1. 打包:把工作区打成 zip 下载(自动排除引擎内部目录)。
  2. 发布:先自动校验 SKILL.md frontmatter(name/description)与 manifest.json(name/version/author/description/engine/type=skill)是否完整合规,不合规会提示缺失字段并中止;校验通过后打包上传到能力中心,自动安全扫描后创建草稿版本。发布弹窗显示:
    • 风险等级(低/中/高/阻断)与发现项列表
    • 阻断级风险需在能力中心处理后方可发布

发布成功后,能力中心会出现该技能的草稿版本,你在能力中心走「提交审核 → 批准 → 发布」流程即可让其他用户订阅。

绑定 MCP 服务

技能配置弹窗(单击顶部编辑配置打开)底部的「MCP 绑定」区块,可为调试会话启用平台已接入的 MCP Server。绑定只对调试会话生效:

  1. 在工作区详情页顶部单击编辑配置,打开技能配置弹窗。
  2. 在「MCP 绑定」区块打开目标服务的开关,绑定即时保存;切到调试 Tab 后单击顶部重启实例(或离开再进入该工作区)后生效。
  3. 列表为空说明平台尚未接入 MCP Server,可单击前往 MCP 服务跳转到 MCP 服务页完成接入后再回来绑定。

调试技能

切到「调试」Tab:

  1. (可选)编辑 SKILL.md 后单击重载技能让其生效。
  2. 在输入框发送消息,调试引擎会用你的技能定义回复。
  3. 调试引擎只有只读工具,不会修改技能文件,可安全验证技能行为。

预期结果

  • 创建工作区后,开发引擎自动就绪(状态标签 ready)。
  • 发送消息后,回复逐字流式渲染,工具调用以卡片展示。
  • 重载页面后,历史对话(含工具调用)完整保留。
  • 发布后,能力中心出现该技能草稿,扫描结果显示风险等级。

基于内网部署的企业级 AI 智能体平台