跳到主要内容

Skills

Skills 是可复用的操作指令，用于处理重复任务。添加 Skill 后，任务匹配时 Agent 会加载它。

在 cosh 中管理 Skills​

/skills
/skills detail <name>
/skills enable <name>
/skills disable <name>

名称冲突时使用 detail 查看最终采用的来源。被禁用的 Skill 不会提供给 Agent。

Skill 的搜索位置​

同名 Skill 按下面的顺序查找，先找到的版本生效：

  1. <workspace>/.copilot-shell/skills/
  2. skills.custom_paths 中的路径
  3. ~/.copilot-shell/skills/
  4. $XDG_DATA_HOME/anolisa/skills/（默认 ~/.local/share/anolisa/skills/）
  5. Extensions 提供的 Skill 目录
  6. /usr/local/share/anolisa/skills/
  7. /usr/share/anolisa/skills/

anolisa install os-skills 的 raw backend 在用户级安装时使用上述用户数据目录， 在系统级安装时使用 /usr/local/share/anolisa/skills/。 XDG_DATA_HOME 未设置、为空、为相对路径或包含 .、.. 路径段时使用上述默认值。 在自定义或 Extension 目录中，同名 Skill 均采用第一个包含该名称的目录，列表与加载结果一致。

使用自定义系统前缀时，应运行安装在同一前缀下的 cosh。 例如，安装在 /opt/x 下的 cosh 会依次搜索 /opt/x/usr/local/share/anolisa/skills/ 和 /opt/x/usr/share/anolisa/skills/，替代宿主机的系统目录； 用户和项目目录的优先级保持不变。若需加载其他前缀下安装的技能， 可使用 skills.custom_paths。

已有目录会被监视，文件变化后自动重新扫描。

创建 Skill​

推荐使用 <skill-name>/SKILL.md 目录布局，也兼容 <name>.md 单文件。

---
name: service-health
description: Inspect a systemd service and summarize actionable evidence
allowedTools:
  - shell
---

# Service health

Inspect status and recent logs before proposing a change. Ask for approval
before restarting the service.

name 和 description 必填。allowedTools 可省略，可以使用 YAML 列表或逗号分隔字符串。

添加共享目录​

使用 skills.custom_paths 搜索团队维护的目录，无需复制文件：

[skills]
custom_paths = ["~/team-skills", "/opt/company/skills"]

路径支持展开 ~、${VAR} 和 $VAR。项目路径以 Core 启动时的工作空间为基准。