Skip to main content

技能系统

ℹ️Note

技能是实验性功能。在设置 → 功能 → "启用技能"中启用。

技能（Skills）是用于特定任务的可重用指令集。每个技能打包了详细的指导、工作流程和额外资源，仅在与您的请求相关时才加载。

与规则（始终活动）不同，技能是按需加载的。您可以安装数十个技能而不影响上下文或性能，因为Careti在实际需要之前只显示技能名称和描述。

为什么使用技能？​

想想您如何培训新团队成员：您不会一次性把所有文档都给他们。您会给他们一个简要概述，然后在他们处理特定任务时指向详细指南。

技能的工作方式相同：

  • 启动时: Careti只显示每个技能的简要描述
  • 触发时: 加载该技能的完整指令
  • 按需: 技能中捆绑的额外文件仅在被引用时读取

这种渐进式加载意味着您可以打包广泛的领域知识，而不会在与当前任务无关的信息上消耗上下文tokens。

创建技能​

每个技能都是一个包含SKILL.md文件的目录：

my-skill/
├── SKILL.md          # 必需: 主要指令
├── docs/             # 可选: 额外文档
│   └── advanced.md
└── scripts/          # 可选: 实用脚本
    └── helper.sh

SKILL.md文件由YAML前置元数据和指令两部分组成。

---
name: my-skill
description: 简要描述此技能的作用及使用时机。
---

# My Skill

当此技能被激活时Caret要遵循的详细指令。

## 步骤

1. 首先做这个
2. 然后做那个
3. 高级用法请参见[advanced.md](docs/advanced.md)

必填字段:

  • name: 必须与目录名称完全匹配
  • description: 告诉Careti何时使用此技能（最多1024个字符）

技能存储位置​

技能可以存储在两个位置：

全局技能适用于所有项目：

  • macOS/Linux: ~/Documents/.agents/skills/
  • Windows: C:\Users\USERNAME\Documents\.agents\skills\

项目技能仅适用于当前工作区：

  • .agents/skills/（推荐）

当全局技能和项目技能同名时，全局技能优先。

ℹ️Note

Careti标准化: Careti使用双目录架构。

  • .agents/ - AI用（token优化）
  • .users/ - 人类用（详细说明）

使用/init命令初始化标准结构。详情请参阅高级规则系统和AI-开发者知识同步。

技能管理​

点击聊天输入下方的秤图标打开规则和工作流程面板。启用技能后，您可以在技能选项卡中：

  • 查看所有可用技能
  • 单独开关技能
  • 从模板创建新技能
  • 删除不需要的技能

相关功能​