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:测试技能
- 用自然语言触发
- 验证正确加载
- 检查所有引用是否有效
- 根据示例验证
技能命名约定
- 小写带连字符:
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/