技能系统

技能（Skill）是结构化的 Markdown 指令模板，用于增强 AI 的专业能力。通过加载不同的技能，AI 可以获得特定领域的知识和行为指导。

技能是什么

每个技能由一个 SKILL.md 文件定义，包含：

• 技能名称和版本
• 适用场景描述
• 具体的操作步骤和注意事项
• 可选的脚本文件（scripts/）、资源文件（resources/）和模板（templates/）

AI 在对话时会根据当前任务自动选择和使用已加载的技能。

两层技能体系

Tier E — 引擎内置技能

• 随引擎编译，所有用户默认可用
• 约 7 个核心技能（检索策略、执行策略、计划、委派、记忆策略、调查、技能创作）
• 不可编辑、不可卸载
• 可通过 Agent 配置禁用

Tier C — 用户/产品技能

• 通过 .wesskill 包安装，或由产品预装
• 可安装、更新、卸载、回滚
• 支持用户自定义修改
• Wesclaw 预装了个人助手相关的 Tier C 技能

技能包格式

技能以 .wesskill（tar.gz 格式）打包分发，包含：

SKILL.md          # 必需：技能定义（名称和版本从此文件提取）
manifest.json     # 可选：依赖声明
scripts/          # 可选：辅助脚本
templates/        # 可选：模板文件
resources/        # 可选：资源文件
signature.sig     # 可选：Ed25519 签名

安装与管理

安装技能

1. 进入 设置 → 技能 页面
2. 点击"安装"按钮
3. 选择 .wesskill 技能包文件
4. 安装完成后技能立即可用

卸载技能

在技能列表中选择要卸载的技能，点击"卸载"。Tier E 引擎内置技能无法卸载。

版本管理

• 更新：上传新版本的技能包覆盖安装
• 回滚：如果新版本有问题，可回滚到之前的版本
• 版本历史在技能详情页查看

Agent 技能白名单

每个 Agent 可以配置技能白名单，控制哪些技能对该 Agent 生效：

• nil（未配置）：该 Agent 可使用全部已安装技能
• 空列表 []：该 Agent 不使用任何技能
• 指定列表：该 Agent 只使用列表中的技能

白名单与 Cell 级别的 DisabledEngineSkills 配置共同生效（AND 关系）。

预装技能

Wesclaw 桌面版预装了一系列个人助手相关技能，覆盖日常对话、信息整理、知识问答等场景。这些技能在首次启动时自动安装到当前 Cell 中。

启用与禁用

在技能管理页面，可以通过开关快速启用或禁用单个技能，无需卸载。禁用的技能不会被 AI 在对话中使用。