跳到主要内容

技能体系

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

术语与对象​

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

操作界面截图​

在对话底部输入条点击 技能，可搜索、选择个人或官方 Skill，并通过 管理技能 进入维护入口；界面与文案以线上为准。

AgenticHub：底部输入条打开技能列表与管理入口

在输入框中也可使用 /skills-use/<技能名> 等形式触发指定 Skill，并结合自然语言说明本次任务；以下为示例会话与进度展示。

AgenticHub：通过 /skills-use 调用 Skill 的会话示例

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

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

操作概要

  1. 在主导航或技能相关入口进入 skill-creator。

    在技能菜单中选择 skill-creator 进入创建流程

  2. 在输入框写清 Skill 的输入、输出与核心逻辑；描述太空时，系统会通过问答帮你把需求收窄。

    Agentic 小助手通过多轮问答收窄 Skill 需求

  3. 初版生成后，在页面下方技能栏等区域能看到对应条目。

    初版生成完成后的技能信息与测试结果示例

  4. 按提示填写调用地址或示例参数，发送测试用例查看结果；不满意时继续用自然语言改需求，或转到下一节的在线文件编辑做精细调整。

  5. 调通后在 Skill 设置里补全名称、说明、可见范围等，再决定自用或发布。

    技能列表中出现新建 Skill，便于挂载或继续配置

注意事项

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

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

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

操作概要

  1. 进入技能管理中的技能仓库，使用右上角新建。

    技能仓库列表与右上角「新建」入口

  2. 填写仓库名称，建议英文以便与 Git 习惯一致，选择 License 等元数据后创建仓库并进入编辑器。

    新建技能仓库：所有者、英文名称、License、可见性等

    进入仓库后的在线编辑器，维护 SKILL.md 等定义

  3. 按平台规范维护 Skill 定义与脚本；每次保存会留下提交历史，便于对比与回滚。

    仓库「文件」页与提交历史列表

    变更对比视图，查看单次保存的增删内容

前置能力建议

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

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

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

环境与前提

1. 安装 Git

  • Windows：前往 Git 官网 下载安装包，按向导完成安装；建议勾选「将 Git 添加到系统 PATH」或同类选项，以便在终端中直接使用 git。
  • Mac：打开终端，执行 brew install git（需已安装 Homebrew）。
  • Linux：Ubuntu / Debian 可执行 sudo apt-get install git；CentOS 等可执行 sudo yum install git（发行版不同命令可能略有差异）。

安装完成后在终端执行 git --version，确认版本不低于 2.20（与上文建议一致）。

2. 配置 Git 账号

打开终端或命令提示符，配置全局用户名与邮箱，须与 AgenticHub（OpenCSG）上绑定的 Git 身份一致，否则克隆或推送时可能失败：

git config --global user.name "你的 Git 用户名"
git config --global user.email "你的 Git 绑定邮箱"

配置后可执行 git config --list 核对是否生效。

3. 获取仓库克隆地址

在技能仓库中检索目标公开 Skill，进入详情页后通过 下载 skill 或等价入口，复制 HTTPS 或 SSH 地址，供本地 git clone 使用。

Git 安装与账号配置说明（示意）

操作概要

  1. 在本地目录执行 git clone。

    技能仓库详情页「下载 skill」：HTTPS 与 git clone 命令示例

  2. 在仓库中编辑核心配置，常见文件名为 skill_config.json 或 skill.yaml，以实际仓库为准；同步更新版本号与说明。

    本地 IDE 中编辑 SKILL.md 等技能定义示例

  3. 本地验证语法与最小用例后，使用 git add、commit、push 推回远程，提交信息写清业务含义，便于评审。

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

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

挂载、组合与运维习惯​

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

发布、分享与安全​

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