技能触发机制

燕雪AI研学心法 · 在实践中研学，在研学中获得技能

🎯 燕雪研学心法

在办事实践中研学 → 研学中获得技能 → 将技能写成技能导学

❄️ 核心态度

欢迎问题，闻过则喜，每个问题都是研学机会！

🔍 网络查问

欢迎发文发问，针对问题，能找到解决办法，则是问妙！

一、什么是技能触发机制？

技能触发机制是 OpenClaw 的核心能力之一，让 AI 能够根据任务自动识别并加载对应的技能模块。

核心原理：

系统在每个会话开始时，扫描技能目录，根据技能的描述（description）自动匹配用户请求，加载对应的 SKILL.md 文档。

二、技能目录结构

OpenClaw 会扫描以下目录：

~/.openclaw/extensions/.../skills/          # 扩展技能
~/AppData/Roaming/npm/node_modules/openclaw/skills/  # 内置技能
d:\Lenovo\.openclaw\workspace\skills/        # 用户自定义技能 ← 燕雪技能在这里

技能文件结构

skills/yanxue-website/
├── SKILL.md       # 技能文档（核心）
└── _meta.json     # 元数据（描述、版本）

三、_meta.json 配置

每个技能都需要一个 _meta.json 文件，定义技能的基本信息：

{
  "name": "yanxue-website",
  "description": "燕雪AI官网建设技能。用于 yanxue.teci.cn 网站的建设、更新和维护。当用户需要添加友情链接、更新课程页面、部署网站、配置服务器目录时使用此技能。",
  "version": "1.0.0",
  "private": true
}
⚠️ 重要字段说明：
  • name：技能名称，用于识别
  • description：技能描述，用于自动匹配触发
  • version：版本号
  • private：是否私有（不会上传到公开仓库）

四、触发流程

示例：用户说 "帮我添加一个友情链接"

步骤 1：扫描技能列表

系统扫描 <available_skills>，获取所有技能的描述。

步骤 2：描述匹配

Before replying: scan <available_skills> <description> entries.
- If exactly one skill clearly applies: read its SKILL.md
- If multiple could apply: choose the most specific one
- If none clearly apply: do not read any SKILL.md

步骤 3：加载技能

匹配成功后，系统读取 SKILL.md，按照文档执行任务。

五、SKILL.md 编写规范

一个好的 SKILL.md 应该包含：

章节 内容
概述 技能用途和适用场景
配置信息 服务器、API、密钥等
使用流程 详细的操作步骤
常见任务 典型使用场景示例
故障排查 常见问题和解决方案
成功案例 实际应用案例

六、燕雪研学心法实践

❄️ 心法三步

  1. 在办事实践中研学 - 通过实际任务学习
  2. 研学中获得技能 - 总结经验形成方法
  3. 将技能写成技能导学 - 文档化分享传承

本次实践案例

任务：课程页面上线
问题：FTP上传成功但访问404
研学：发现FTP目录 ≠ nginx目录
技能：总结出正确的SSH部署流程
导学：写成 yanxue-website/SKILL.md

实践案例二：添加友情链接

任务：添加友情链接「东爱超能」
流程：编辑 links.html → 部署 → 验证
研学：掌握友情链接添加流程
技能：友情链接添加三步法
导学：更新本章节案例
✅ 友情链接添加三步法：
  1. 编辑文件 - 修改 site/links.html，添加链接
  2. 部署上线 - 运行 python deploy.py
  3. 验证结果 - 检查页面是否包含新链接

七、子会话如何使用技能

所有子会话都能访问 workspace/skills/ 目录下的技能，因为：

✅ 实践验证：

本次会话中，yanxue-website 技能成功帮助完成了课程页面上线任务。

八、技能的传承价值

技能不仅是技术文档，更是研学智慧的传承：

← 返回课程列表 返回首页 →
🔗 朋友圈汇 🔗 友情链接