bot/docs/zh-CN/tools/creating-skills.md

title, x-i18n

title	x-i18n
创建 Skills	generated_at model provider source_hash source_path workflow 2026-02-03T10:10:19Z claude-opus-4-5 pi ad801da34fe361ffa584ded47f775d1c104a471a3f7b7f930652255e98945c3a tools/creating-skills.md 15

创建自定义 Skills 🛠

Hanzo Bot 被设计为易于扩展。"Skills"是为你的助手添加新功能的主要方式。

什么是 Skill？

Skill 是一个包含 SKILL.md 文件（为 LLM 提供指令和工具定义）的目录，可选包含一些脚本或资源。

分步指南：你的第一个 Skill

1. 创建目录

Skills 位于你的工作区中，通常是 ~/.hanzo/bot/workspace/skills/。为你的 Skill 创建一个新文件夹：

mkdir -p ~/.hanzo/bot/workspace/skills/hello-world

2. 定义 SKILL.md

在该目录中创建一个 SKILL.md 文件。此文件使用 YAML frontmatter 作为元数据，使用 Markdown 作为指令。

---
name: hello_world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say "Hello from your custom skill!".

3. 添加工具（可选）

你可以在 frontmatter 中定义自定义工具，或指示智能体使用现有的系统工具（如 bash 或 browser）。

4. 刷新 Hanzo Bot

让你的智能体"刷新 skills"或重启 Gateway 网关。Hanzo Bot 将发现新目录并索引 SKILL.md。

最佳实践

• 简洁明了：指示模型做什么，而不是如何成为一个 AI。
• 安全第一：如果你的 Skill 使用 bash，确保提示词不允许来自不受信任用户输入的任意命令注入。
• 本地测试：使用 hanzo-bot agent --message "use my new skill" 进行测试。

共享 Skills

你也可以在 Hanzo Skills Hub 上浏览和贡献 Skills。