Skill 开发实战

Skill 是注入到 AI 员工系统提示词（System Prompt）中的专业知识片段，用于增强 AI 在特定领域的能力。本文档介绍如何创建、打包和发布 Skill。

什么是 Skill

Skill 的本质是一段结构化文本，在 AI 员工开始工作时注入到其系统提示词中。通过 Skill，你可以：

• 定义 AI 的工作流程和规范
• 注入领域知识和最佳实践
• 提供模板和示例
• 约束 AI 的行为方式

两种形式

创建文本 Skill

通过 Web 面板创建

1. 进入 扩展市场 -> Skill 管理
2. 点击 创建 Skill
3. 填写名称、描述、类型
4. 在编辑器中编写 Skill 内容
5. 保存

内容编写技巧

• 明确角色：开头说明 AI 应扮演的角色
• 分步骤：将复杂流程拆分为清晰的步骤
• 给示例：提供输入输出示例，比抽象描述更有效
• 设边界：明确说明什么该做、什么不该做
• 控长度：Skill 内容建议控制在 2000 字以内，过长会占用上下文窗口

创建 Bundle Skill

Bundle Skill 适合包含多个文件的复杂场景。

目录结构

my-skill/
  SKILL.md          # Skill main content (required)
  manifest.json     # Metadata (required)
  README.md         # Documentation (optional)
  templates/        # Template files (optional)
    report.md
    checklist.md
  examples/         # Example files (optional)
    good-example.md
    bad-example.md

manifest.json 格式

{
  "name": "my-skill",
  "version": "1.0.0",
  "display_name": "My Custom Skill",
  "description": "A skill that does something useful",
  "type": "workflow",
  "author": "your-name",
  "tags": ["development", "workflow"]
}

SKILL.md 编写

SKILL.md 是 Skill 的核心内容，会被注入到 AI 的系统提示词中。内容使用 Markdown 格式，可以引用 templates/ 和 examples/ 中的文件。

打包

cd my-skill
zip -r my-skill.zip .

发布到扩展市场

通过 CLI 发布

openvort marketplace publish skill ./my-skill.zip

通过 Web 面板发布

1. 进入 扩展市场 -> Skill 管理
2. 点击 上传 Skill
3. 选择打包好的 zip 文件
4. 确认元数据信息
5. 发布

绑定 Skill 到 AI 员工

Skill 创建后需要绑定到 AI 员工才能生效：

• 按岗位自动绑定：在 Skill 配置中关联岗位，该岗位的所有 AI 员工自动获得此 Skill
• 手动添加：在 AI 员工配置页面手动选择需要的 Skill
• 扩展市场安装：从扩展市场浏览并安装社区共享的 Skill

三种 Skill 类型

选择合适的类型有助于组织和检索 Skill，但类型本身不影响 Skill 的注入行为。