技能概述
技能是可复用的专业流程包,定义任务的触发条件、操作方法和交付结果。例如,“会议纪要整理”可以反复处理不同会议的记录,按约定生成决定、待办和待确认项;每次上传的会议记录属于对话输入。
技能内容
每个技能包包含 SKILL.md,还可包含脚本、长期参考资料、模板和其他辅助文件。同一技能可以挂载到多个助手,助手发布时固定所用的技能版本。
运行配置声明说明技能需要什么参数或凭据,实际值由使用者在运行配置中提供。真实密钥应保存在运行配置中,禁止写入技能文件。
技能来源与源码访问
技能按创建或导入时的空间归属:
- 个人技能:属于个人,在个人空间使用和维护。
- 企业技能:属于创建或导入时所在的企业,通过资源权限开放给成员。
- 平台技能:由平台维护,按平台供应范围开放。内置技能随产品提供,适用范围见内置技能。
企业技能的使用权允许使用已发布能力;更新权允许查看源码、编辑和发布;管理权包含前两项,并允许管理授权和归档。“我创建”只表示创建记录,具体操作以有效权限为准。企业技能不能跨企业挂载。
历史分享和采纳记录仅作为审计历史保留,待处理请求已作废,不再提供新的分享或采纳入口。
技能库可用范围
「智能编排 → 技能」中显示的结果已经过空间、状态和权限过滤。来源标签说明谁维护技能;页面能否打开源码或工坊,由资源权限决定。
- 在左下角确认当前空间,进入「智能编排 → 技能」。
- 在「已添加」中搜索名称或用途,按来源、标签缩小范围。企业空间显示「企业」「平台」,个人空间显示「个人」「平台」。
- 检查卡片中的「未发布」「已发布」「有未发布修改」状态。有源码访问权限时,点击卡片打开文件详情。
- 维护技能时,在详情中编辑文件并保存草稿;需要正式生效时,按技能生命周期生成发布预览并确认。
未获得更新权时,技能可能可使用,但不能打开源码详情。企业技能的管理者可在卡片「权限」中授权成员、用户组或企业全员,并验证成员最终权限。完整规则见资源权限与访问控制。
添加第三方技能
- 在技能页切换到「第三方」,选择来源并搜索技能。现有来源为 SkillHub。
- 打开候选技能,检查来源、说明、所需外部配置和预检结果。
- 预检通过后,点击「添加到企业技能」或「添加到个人技能」。按钮名称取决于当前空间。
- 添加成功后返回「已添加」,检查导入技能的文件、发布状态和运行配置要求,再通过任务样例验证。
第三方导入会规范化技能包并校验结构,导入不会自动提供外部密钥或开放额外工具。来源不可用或预检失败时,按页面错误处理后重试。
技能可用条件
草稿 ──发布──▶ 可挂载版本 ──归档──▶ 从当前入口移除
└─冻结──▶ 只在治理入口处理
助手引用的技能归档后,系统跳过已归档技能并显示「能力不完整」状态;助手及其他依赖正常时,其余能力继续运行。技能被冻结或不存在,或固定发布版本被撤回、缺失、校验失败时,会阻止该次运行。具体处理见技能生命周期。
正式使用需要已发布版本,草稿只供维护。挂载后需发布助手并通过新对话验证,操作见给助手挂载技能。开发或测试文件的方法见技能工坊。
维护运行配置声明
具有更新权时,在技能详情点击「运行配置」,声明参数名称、用途、必填或选填、敏感性和提供方式。修改写入 SKILL.md,保存并发布后才进入正式运行版本。
此处维护配置项声明。实际配置值由使用者在对话配置卡或运行配置中心填写,操作见助手运行配置。
从本地项目更新草稿
桌面客户端的技能详情提供本地项目绑定,需要更新权和可用的本地连接:
- 点击「绑定本地」,选择「绑定本地项目」,确认要维护的目录。
- 本地文件修改后,选择「从本地更新草稿」。
- 在「同步变更」中核对新增、修改、删除文件和检查结果,再确认同步。
- 同步成功后,云端草稿处于待发布状态。需要正式生效时,再生成发布预览并确认。
本地目录的变化通过显式同步进入草稿,正式内容由发布控制。「解除本地绑定」只解除关联,技能库内容保持不变。发布记录与草稿备份还支持「导出到新目录」;本地连接未就绪时,按客户端提示处理。