创建技能Skill create-skill

AI技能创建框架指南 - 用于构建、更新和结构化个人AI系统中的专业技能模块。提供标准化模板、工作流程和最佳实践,支持简单技能和复杂技能开发,包含触发条件、目录结构、文档编写和测试方法。关键词:AI技能开发,智能体能力扩展,技能创建框架,AI系统集成,工作流程标准化

AI智能体 0 次安装 0 次浏览 更新于 3/1/2026

name: 创建技能 description: 在KAI个人AI基础设施中创建新技能的指南。当用户想要创建、更新或构建一个扩展能力的新技能时使用,这些技能包含专业知识、工作流程或工具集成。遵循Anthropic技能标准和PAI特定模式。

创建技能 - 技能创建框架

何时激活此技能

  • “为X创建新技能”
  • “构建一个能做Y的技能”
  • “为Z添加技能”
  • “更新/改进现有技能”
  • “正确构建技能”
  • 用户想要扩展KAI的能力

核心技能创建工作流程

步骤1:理解目的

询问以下问题:

  • 这个技能做什么?(清晰、具体的目的)
  • 何时应该激活?(触发条件)
  • 使用什么工具/命令?(依赖项)
  • 是简单还是复杂?(决定结构)

步骤2:选择技能类型

简单技能仅SKILL.md):

  • 单一聚焦能力
  • 最小依赖项
  • 快速参考足够
  • 示例:fabric-patterns, youtube-extraction

复杂技能SKILL.md + CLAUDE.md + 支持文件):

  • 多步骤工作流程
  • 需要广泛上下文
  • 多个子组件
  • 示例:development, website, consulting

步骤3:创建目录结构

# 简单技能
${PAI_DIR}/skills/[技能名称]/
└── SKILL.md

# 复杂技能
${PAI_DIR}/skills/[技能名称]/
├── SKILL.md           # 快速参考
├── CLAUDE.md          # 完整上下文
└── [子目录]/          # 支持资源

步骤4:编写SKILL.md(必需)

使用此结构:

---
name: 技能名称
description: 清晰描述技能做什么以及何时使用。应与激活触发器匹配。
---

# 技能名称

## 何时激活此技能
- 触发条件1
- 触发条件2
- 用户短语示例

## [主要内容部分]
- 核心工作流程
- 关键命令
- 示例
- 最佳实践

## 补充资源
详细上下文:`read ${PAI_DIR}/skills/[技能名称]/CLAUDE.md`

步骤5:编写CLAUDE.md(如果复杂)

包括:

  • 综合方法论
  • 详细工作流程
  • 组件文档
  • 高级使用模式
  • 集成说明
  • 故障排除指南

步骤6:添加到全局上下文

更新${PAI_DIR}/global/KAI.md的available_skills部分以包含新技能,使其显示在系统提示中。

步骤7:测试技能

  1. 用自然语言触发
  2. 验证正确加载
  3. 检查所有引用是否有效
  4. 根据示例验证

技能命名约定

  • 小写带连字符create-skill, web-scraping
  • 描述性,非通用fabric-patterns而非text-processing
  • 动作或领域聚焦ai-image-generation, chrome-devtools

描述最佳实践

您的描述应:

  • 清晰说明技能做什么
  • 包含触发短语(例如"USE WHEN用户说…")
  • 提及使用的关键工具/方法
  • 简洁但完整(1-3句话)

良好示例:

  • “使用perplexity-researcher、claude-researcher和gemini-researcher代理进行多源综合研究。启动多达10个并行研究代理以快速获得结果。USE WHEN用户说’做研究’、‘研究X’、‘查找关于…的信息’…”
  • “用于Web应用程序调试、视觉测试和浏览器自动化的Chrome DevTools MCP。调试Web应用程序的唯一可接受方式 - 永远不要使用curl、fetch或wget。”

可用模板

  • simple-skill-template.md - 用于简单能力
  • complex-skill-template.md - 用于多组件技能
  • skill-with-agents-template.md - 用于使用子代理的技能

补充资源

完整指南和示例:read ${PAI_DIR}/skills/create-skill/CLAUDE.md 模板:ls ${PAI_DIR}/skills/create-skill/templates/

关键原则

  1. 渐进式披露SKILL.md = 快速参考,CLAUDE.md = 深度探索
  2. 清晰激活触发器:用户应知道何时适用技能
  3. 可执行指令:祈使/不定式形式(动词优先)
  4. 上下文继承:技能自动继承全局上下文
  5. 无重复:引用全局上下文,不要重复
  6. 自包含:技能应独立工作
  7. 可发现性:描述使KAI能够匹配用户意图