技能广场与技能管理：把一次做成的工作变成可复用的方法

第一次整理工单周报时，你可能需要反复告诉智能体怎样分类、怎样计算、输出什么格式。如果把已经验证的方法整理成Skill，下次就可以让智能体按同样的方法工作。Skill是一组说明和附属文件，可以包含脚本、模板和参考资料；它既不是一段固定回答，也不会自动授予业务系统权限。

“技能广场”适合找出现在可以使用的技能并试用。“个人设置”中的“系统技能”“我的技能”“技能市场”用于管理来源、启停、文件和共享版本。本章先说明怎样使用，再说明怎样把自己的方法留下来。

1.先分清技能从哪里来

市场中有新版本，不会自动替换你正在使用的版本。自己的个人Skill改了，也不会改掉已经共享给其他人的版本。把这两点分清，才能知道修改会影响谁。

业务范围决定此刻能用哪些技能

工作台左上角的业务范围和个人设置中显示的当前业务范围，用于决定当前可用技能。“综合”可使用通用技能，以及至少有一个你已获授权系统与之匹配的技能；选择某个业务系统后，可使用通用技能和适用于该系统的技能。

“全部技能”只是便于管理本人全部技能的展示方式，不会扩大权限。在“全部技能”里看见某个Skill，不代表它能在当前业务范围中试用。失去某个系统资格后，原来限定该系统的Skill也不会自动变成通用。

2.从技能广场找一个可用技能

点击工作台侧栏“技能广场”。这里汇集当前范围内已启用的系统技能、已完善且启用的个人技能，以及安装完整可用的市场技能；尚未安装的市场版本和个人草稿不在这里展示。

1. 先确认左上角业务范围，避免在错误的系统范围中找技能。
2. 在“搜索名称、描述或标签”中输入工作关键词，例如“工单”或“周报”。
3. 按需要点击标签；标签超过10个时点击“更多标签”，点击“收起”恢复简短显示。
4. 在来源下拉框选择“系统提供”“我创建的”“市场安装”，或保留“全部来源”。
5. 点击技能卡片主体，查看用途、适用系统、技能标识、版本或个人目录，以及样例提示词。

找不到结果时可以“清除筛选”。页面提示“部分来源暂时无法加载”时，只说明某些来源读取失败，不能据此判断你的技能被删除；点击“重新加载”取得完整目录。

试用会做什么

在卡片点击“试用”，或在详情点击“试用技能”。蜂巢会打开新对话，把样例提示词放进输入框，并选中这项技能；不会替你发送。检查样例中的日期、项目和对象，按自己的需求修改后再发送。

缺少样例提示词时，“试用”不可用。系统技能需要管理员补充样例；个人Skill可在“我的技能”完善。试用开始的是一次真实任务，会使用模型和工具，也可能修改文件或访问业务系统，不能把它当作只读演示。首次验证时选用合适的测试资料，并明确希望智能体只查询、只起草还是实际执行。

3.管理管理员分配的系统技能

打开左下角账号菜单中的“个人设置”，在“技能与工具”中选择“系统技能”。页面按适用范围分组展示已经分配给你的企业Skill。

1. 在左侧选择适用范围分组。
2. 搜索技能名称、描述或标签，也可点击标签筛选。
3. 点击卡片“查看详情”，阅读完整介绍、标签、版本和样例提示词。
4. 不希望智能体继续使用某项技能时点击“停用”，需要时点击“启用”；核对卡片上的“已启用”或“已停用”与操作提示。
5. 已启用、具有样例且适用当前业务范围时，点击“试用”。

启停只管理自己的使用选择，不会替其他员工停用，也不删除管理员分配。系统技能本身是否发布、是否停用、适用哪些系统和是否分配给你，由管理员管理。员工页面没有上传新版、编辑企业文件或删除系统技能的按钮。

这里不要求你先填写业务密码才能查看技能。不过，真正执行业务任务时，仍要满足业务系统资格、账号关联和具体业务权限。相关入口见业务系统、工具与消息渠道。

4.从技能市场安装，并决定何时切换版本

在“个人设置→技能与工具”选择“技能市场”。每张卡片显示名称、发布者、用途、适用系统、样例及版本选择。同名Skill的多个版本汇集在一个卡片中；“选择版本”决定当前正在查看哪一次共享内容。

安装第一个版本

1. 阅读用途、发布者、适用系统和样例，判断它是否适合你的工作。
2. 在“选择版本”中选定版本，点击“安装”。
3. 等待完成，确认卡片显示“已安装”或“当前正在使用”。
4. 到“我的技能→我安装的”核对安装版本；符合当前范围且有样例时可“试用”。

不能安装自己的市场发布版本；自己的原件仍在“我创建的”中。当前技能市场没有全文文件预览或直接编辑市场原件的入口，不能把卡片介绍当作已经检查过全部脚本。

升级或切换到另一个版本

1. 在技能市场找到同一Skill，展开“选择版本”。
2. 选中希望使用的版本，核对用途和样例。
3. 点击“切换到版本号”，例如“切换到1.1.0”。
4. 等待成功，确认新版本标为“当前使用”，再用具体任务验证。

你决定切换时才替换当前安装，其他员工不受影响。切换后不要只看下拉框的选择值，应确认“当前使用”和“我安装的”中的版本都已更新。系统会检查内容和业务范围；当前版本存在未确定的安装、卸载或停用操作时，先处理该操作，再切换版本。

5.维护已经安装的市场技能

在“个人设置→我的技能”选择“我安装的”。这里围绕自己当前的安装副本管理，而不是围绕市场所有版本管理。

卸载和异常状态

不用某项技能时点击“卸载”，阅读提示后点击“确认卸载”。成功后智能体不再发现这个市场安装版本；正在运行的任务可能继续使用已经加载的内容。卸载不会撤回已经发生的文件修改或业务操作，也不会删除另外复制出的个人Skill。

市场安装没有普通“停用/启用”开关。如果只是暂时不想指定这项技能，可以在聊天时选择其它技能；若要让它不再被发现，使用卸载。个人Skill和系统技能才有本章所述的个人启停入口。

管理员“下架”或发布者“停止共享”只阻止新增安装，已有安装可以继续保留；管理员紧急停用会进一步处理受管理的安装副本。个人复制件和已经运行的任务不会因此自动撤回。

想按自己的需要修改：先复制为个人Skill

市场安装副本是固定版本，适合保持来源可核对。要修改步骤、模板或脚本，使用独立的个人副本。

1. 找到安装内容完整可用的Skill，点击“复制为个人Skill”。
2. 阅读影响，填写“个人Skill目录名称”，例如workorder-report-personal。
3. 点击“确认复制”。
4. 成功后会切到“我创建的”并打开资料编辑，核对中文名称、样例、标签和适用业务系统。

复制出的Skill可以单独修改，不再跟随市场版本变化。原市场安装、升级和卸载状态保持原样，所以复制后两份可能同时存在；根据实际需要管理启用和卸载，避免误把旧版当成自己的新版。

6.创建或导入自己的Skill

当前“我的技能”页面提供“上传Skill”，没有一个从空白正文开始的“新建Skill”编辑器。你可以通过对话整理新Skill，也可以准备ZIP导入，或在自己的工作空间中维护Skill文件。

把刚完成的对话整理成Skill

当普通对话最近一次任务正常完成、有可用回答且对话仍可继续时，回答下方可能出现“创建我的Skill”。只读结果、面板编辑等场景不提供这个入口。

1. 在已经完成目标工作的对话中点击“创建我的Skill”。
2. 查看输入框新加入的创建要求。它会请智能体把处理方法整理成可复用说明，并放到一个新的个人目录。
3. 补充应该保留的方法、需要改成可调整输入的条件，以及不应写入的真实数据，然后自己发送。
4. 等任务结束，查看“正在检查Skill”“Skill还需要完善”等检查结果。
5. 成功生成草稿时点击“完善并启用”，到“我的技能”补齐资料；已可用时可“查看我的Skill”。

点击“创建我的Skill”本身只是准备提示词，不会立即创建文件。任务失败或目录没找到时，页面提供“重新检查”；可以先继续对话修正文件，再检查。智能体声称已经创建也不等于检查通过，应以指定目录中的文件和实际检查状态为准。

从ZIP导入

ZIP需要包含一个明确的Skill目录及SKILL.md，也可以把SKILL.md放在ZIP根目录。不要把多个Skill放进同一个包；包中路径应正常，不含越界路径或链接。当前上传入口只接受ZIP，不能直接选单独的Markdown文件。解压后单文件最多2MiB、总量最多10MiB、最多512项。

1. 在“个人设置→我的技能→我创建的”点击“上传Skill”。
2. 点击选择区，或拖入ZIP文件，文件不能超过15MiB。
3. 核对文件名，点击“上传”。
4. 上传成功后，页面会打开“编辑Skill信息”，提示Skill已上传为草稿。
5. 完善资料并启用，按下一节检查。

SKILL.md顶部至少应有稳定名称和用途，例如：

---
name: workorder-report
description: 按项目整理工单完成情况
metadata:
  display_name: 工单周报
  example_prompt: 请整理本周工单，按项目列出完成情况和待跟进事项。
  tags: [工单, 周报]
  business_system_keys: [workorder]
---

name是程序使用的稳定标识，使用小写英文字母、数字、点、下划线或连字符，首位是字母或数字，最长128个字符，不能以public-开头。description说明用途；正文应继续写实际操作方法。business_system_keys填写系统标识数组，空数组表示通用，不要凭系统显示名称猜标识，也不要把它写成逗号拼接的字符串。

已有同名目标目录时，上传不能用作覆盖更新。先确认已有文件，按下面的文件更新步骤处理，或为确实不同的技能使用另一个名称。

完善信息并启用

1. 在个人Skill卡片点击“完善并启用”“完善资料”或“编辑信息”。
2. 填写“中文名称”，最多128个字符，需包含汉字。
3. 填写具体“样例提示词”，最多2000个字符。
4. 填写至少一个“标签”，多个可用逗号、顿号或换行分隔，最多20个，每个不超过32个字符。
5. 核对“适用业务系统”。留空表示通用；可以选择最多20个系统，选择多个时，在任一匹配且有资格的范围中可用。
6. 尚未完善时可以“保存草稿”；资料完整后点击“保存并启用”或“保存”，再核对卡片状态。原本已停用的Skill完善后，仍需按卡片状态点击“启用”。

信息会写回个人SKILL.md。适用范围格式无效时，先修正原文件或使用“重新设置范围”；不可用系统的原声明会保留，需由你明确移除或替换，不会自动放宽为通用。资料完整、文件可解析、已启用且适用当前范围时，才可试用并进入技能广场。

修改文件后为什么还要刷新

Skill管理页中的“编辑信息”只改展示资料和范围，不提供完整脚本或正文编辑器。要改方法、脚本和模板，可让智能体修改自己的Skill目录，或通过工作空间文件工具编辑。不要直接修改企业原件或受管理的市场安装副本。

修改完成后，在“我创建的”点击“刷新工作空间技能”。系统重新扫描目录，检查文件并更新列表。看到“需检查”时阅读解析错误；看到草稿时补齐信息再启用。提示“Skill文件已变化”时，先刷新核对，再重新执行刚才的保存或共享。

需要备份或带走个人Skill时，点击卡片“下载”，浏览器取得该目录的ZIP。停用后仍可以下载；下载不会自动共享。

7.把个人Skill共享给同事

共享前，先用实际任务验证方法，并检查目录中每一个文件，移除业务原始数据、密码、Token、私人记录等内容。共享的是当次目录内容的固定版本，企业内其他员工可以安装使用，不只是看到一段介绍。

1. 在“我创建的”找到已完善、启用且文件解析正常的Skill，点击“共享到市场”。
2. 核对中文名称和样例。修改它们会先保存到个人SKILL.md，随后才发布；即使共享失败，已经保存的资料也会保留。
3. 核对“适用业务系统”。本次版本会固定此范围；要改范围，应取消并返回“编辑信息”处理。
4. 填写版本，例如1.0.0，以及清楚的用途说明。
5. 如需访问外部系统，在“外部访问声明”填写名称，多个用英文逗号分隔。它只是风险说明，不代替管理员接入和业务授权。
6. 阅读共享影响和敏感信息提示，点击“共享”。当前界面没有另一个风险复选框，点击即表示确认。
7. 看到“已共享到技能市场。”后，到“技能市场”核对发布者、版本、说明和范围。

以后要发布改进内容，先更新个人文件、刷新并核对，再用新的版本号再次共享。已共享版本不会随着个人文件修改自动更新，也不能原地改写；其他员工自行决定何时切换。

停止共享一个版本

1. 打开“技能市场”，在自己的Skill卡片选择要停止共享的版本。
2. 点击“停止共享此版本”。
3. 填写原因，点击“确认停止”。
4. 核对“已停止这个版本的新安装，现有安装不会被删除。”的提示。

停止共享只阻止新增安装，不能收回同事已有副本、复制出的个人Skill或运行中的任务。当前员工页面没有恢复已撤回版本的按钮；需要继续分享修正版时，准备并发布合适的新版本。

8.停用和删除个人Skill有什么不同

已完善的个人Skill可在卡片点击“停用”，成功后显示“已停用”；需要时“启用”。它保留文件和资料，只改变后续发现和使用。运行中的任务可能已经加载旧内容，不要把停用当作任务取消。

“删除”会删除个人工作空间中的整个Skill目录。确认名称后点击“删除→确认删除”；无法依靠此页的撤销按钮找回。需要保留时先下载或按工作空间备份流程保存。删除个人原件不会删除已经共享到市场的版本，需要另行停止共享；删除也不会替你卸载另外一份市场安装。

9.遇到问题先核对什么