技能

技能是教 Klaus 完成特定任务的说明书;市场安装、作用域、磁盘布局与生效时机。

技能是教 Klaus 完成特定任务的说明书,命中场景时自动加载。

  • 市场档:卡片网格浏览技能市场,一键安装。
  • 已安装档:列表管理已装技能,可启用/禁用;顶部作用域切换在「全局」和各项目之间切换——全局技能所有会话可用,项目技能只在该项目生效。
  • 技能也可由你自己编写,或让 Klaus 帮你创建。

磁盘上的形状与几个容易踩的点:

  • 一个技能就是一个目录,里面必须有 SKILL.md;开头一段 YAML 前置属性声明它的名字、描述、图标、标签、允许用的工具,以及适用系统和依赖(需要哪些命令、哪些环境变量)。描述写得准不准直接决定它会不会在对的时候被用上。
  • 位置:全局 ~/.klaus/skills/<技能名>,项目 <项目>/.klaus/skills/<技能名>(只限已登记的项目根)。项目目录下只有带 SKILL.md 的目录才算技能,不会把仓库里碰巧同名的目录当成技能。
  • 安装:优先从云端市场下压缩包(包 ≤ 256MB、解开后 ≤ 512MB),云端不可达时回退到随应用内置的本地市场直接复制。装过什么、装的哪个版本记在 ~/.klaus/skills/.install-records.json,「有更新」就是拿它比出来的(本地回退装的不记版本,所以不会永远提示有更新)。更新按技能名进行,不指定版本就取最新。
  • 禁用不删文件:只在 settings.db 里记一行「这个技能关着」。所以禁用可逆,重新启用不需要重装;真要删掉才是卸载。
  • 生效时机:技能清单在会话启动那一刻交给引擎,所以装完、改完、启停完都要开一个新会话。