跳到主要内容

技能体系

Skill 是 AgenticHub 里可复用的能力单元,常见用途包括简历筛选、知识库查询、文本处理等,也是搭建专用智能体时的重要积木。你可以按习惯任选一种方式演进 Skill:用官方 skill-creator 把自然语言变成可测初版;在技能仓库里用标准文件在线维护;或把公开 Skill 克隆到本地,用 Git 做版本化开发后再推回仓库。界面与菜单以线上为准。

术语与对象

  • Skill:可挂载到智能体或对话流程中的能力模块,一般需约定输入、输出与业务规则。
  • skill-creator:面向少写配置、偏好描述式创建的用户,用自然语言驱动生成与迭代。
  • 技能仓库:Skill 的集中存放与分发入口,既可新建自有仓库,也可检索他人共享内容并获取 Git 地址。

操作界面截图

通过 skill-creator 用自然语言生成 Skill

适合想快速验证想法、尽量少碰底层文件的用户。 登录与入口说明见 账号与环境

操作概要

  1. 在主导航或技能相关入口进入 skill-creator。
  2. 在输入框写清 Skill 的输入、输出与核心逻辑;描述太空时,系统会通过问答帮你把需求收窄。
  3. 初版生成后,在页面下方技能栏等区域能看到对应条目。
  4. 按提示填写调用地址或示例参数,发送测试用例查看结果;不满意时继续用自然语言改需求,或转到下一节的在线文件编辑做精细调整。
  5. 调通后在 Skill 设置里补全名称、说明、可见范围等,再决定自用或发布。

注意事项

  • 尽量写清数据格式与边界,少用笼统词。
  • 对外发布或挂到生产实例前,用多组样例回归,避免逻辑错误影响业务。

在技能仓库里在线编辑配置

适合熟悉 JSON、YAML、XML 等格式、希望完全掌控目录与接口定义的用户。

操作概要

  1. 进入技能管理中的技能仓库,使用右上角新建。
  2. 填写仓库名称,建议英文以便与 Git 习惯一致,选择 License 等元数据后创建仓库并进入编辑器。
  3. 按平台规范维护 Skill 定义与脚本;每次保存会留下提交历史,便于对比与回滚。

前置能力建议

  • 先把入参、出参、错误码与超时策略想清楚再落笔,减少无效保存。
  • 保存前用编辑器插件或校验工具检查语法。

用 Git 克隆并本地开发再推送

适合在他人或社区 Skill 基础上二次开发、并习惯用本地 IDE 与分支协作的团队。

环境与前提

  • 本机安装 Git,建议版本不低于 2.20,配置好用户名与邮箱,并与平台绑定的 Git 身份一致。
  • 在技能仓库中检索目标公开 Skill,在详情页通过下载 skill 或等价入口复制 HTTPS 或 SSH 地址。

操作概要

  1. 在本地目录执行 git clone
  2. 在仓库中编辑核心配置,常见文件名为 skill_config.jsonskill.yaml,以实际仓库为准;同步更新版本号与说明。
  3. 本地验证语法与最小用例后,使用 git addcommitpush 推回远程,提交信息写清业务含义,便于评审。

在线编辑与 Git 开发如何搭配

  • 在线编辑适合轻量改动与快速留痕;Git 工作流适合多人协作、复杂分支与本地自动化测试。团队可择一为主,或在不同阶段组合使用。

挂载、组合与运维习惯

  • 为智能体挂载 Skill 时,先满足主业务路径,再按需叠加增强类 Skill,出现冲突时逐项禁用定位原因。
  • 同一实例上多个 Skill 的调用顺序与依赖关系应在团队文档中写明,避免上线后互相覆盖输出。
  • 技能负责稳定步骤与可重复逻辑,Prompt 负责语境与风格,工具负责外部事实与动作,三者边界清晰时更易排障。
  • 对无人维护或长期未使用的 Skill 定期下线或替换,降低供应链风险。

发布、分享与安全

  • 公开发布或写入技能仓库前,完成安全评审与脱敏检查,附使用说明与示例输入输出。
  • 可见范围、审核与下架规则以产品当前策略为准;涉及密钥或鉴权的 Skill 不得把敏感信息写进公开描述或示例。