前言：
当代码复用率低、重复性工作占据大量时间，你是否也感到疲惫？在AI编程工具快速迭代的今天，真正的趋势已不仅是“生成代码”，而是 “沉淀智慧”。Comate Skills 正是为此而来——将团队经验与高频场景封装为可一键调用的技能包，让AI从“临时助手”变为“专属专家”。 无需重复造轮、从头引导，每一次协作都在为团队提效。这是你的AI，更懂你的习惯。
优质Skills案例，快到碗里来，有福利!!!
微信扫码进群，分享你用Comate写的好玩、实用的Skills案例（完整Comate编码截图+项目Github链接），小编会精选5个优质案例发出Comate个人专业版权益、手冲咖啡壶套装、移动电源（充电器充电宝二合一版）、小度智能蓝牙音箱（炫彩版）、无线鼠标（品牌定制系列） 等精美礼品！
1. 什么是Skills？
Skills是一个可移植、支持版本控制的包，用于让 Agent 学会如何执行特定领域的任务。技能可以包含脚本、模板和参考资料，Agent可以使用其工具对这些内容进行操作。
1.可移植
Skills适用于任何支持 Agent Skills 标准的 Agent。
2.受版本控制
Skills以文件形式存储，可以在你的代码仓库中追踪其变更
3.可操作
Skills可以包含脚本、模板和参考资料，Agent 使用其工具对这些内容进行处理。
4.渐进式
Skills按需加载资源，使上下文使用更加高效。
2. Skills的工作原理
Comate启动时，会自动从Skills目录中发现并加载Skills，并将它们提供给Agent使用。 Agent会看到所有可用Skills，并根据当前上下文决定何时调用它们。 你也可以在Agent对话中输入 / 并搜索技能名称来手动调用技能。
3. Skills基础及进阶用法
3.1 基础用法
3.1.1 导入或生成Skills
基于/create-skill生成Skills
Comate内置了系统级别的Skills /create-skill，可以一键创建项目级或个人级别的Skills。
温馨提醒
请注意，使用 /create-skill创建Skills的时候，请采用明确的话术告知Agent是创建个人级还是项目级的Skills，会显著提升识别的准确率，例如：
- 创建项目级： /create-skill在当前仓库创建xxxxx的Skills，以解决xxxx问题
- 创建个人级： /create-skill创建一个个人级的Skill，以解决xxxx问题
3.1.2 基于/find-skills搜索Skills
Comate内置了系统级别的Skill/find-skills，当本地已安装的skills都不适合处理用户问题时，自动从远端Skills中心搜索、推荐并安装最匹配的新Skills， 支持安装到当前项目（.comate/skills/<skill_name>/）或全局个人目录（~/.comate/skills/<skill_name>/）。
精选了一批超实用、超好玩的Skills，试试对Comate说：
| 分类 | 你可以说 | Skill | 效果 |
|---|---|---|---|
| 提效狠活 | "有没有能用自然语言查数据库的skill？我想查最近7天的异常订单" | database-helper | 不用手写SQL，说人话就能查数据 |
| "有没有专门做Go代码性能分析的skill？这段代码跑得太慢了" | go-code-analyzer | 41项检查帮你揪出性能瓶颈 | |
| "有没有能自动清理AB实验代码的skill？实验结束了想把实验分支删干净" | experiment-code-cleanup | 自动识别实验分支，干净利落删干净 | |
| 信息投喂 | "有没有能聚合今天AI热点新闻的skill？" | hot-news-skill-manus | 19家信息源聚合，3分钟看完一天热点 |
| "有没有能搜arXiv论文的skill？想找几篇RAG优化相关的" | arxiv-search | arXiv论文即搜即得，带摘要 | |
| 整点花活 | "有没有能根据PRD自动生成技术方案的skill？" | prd-to-tech-design | 产品文档直出技术设计，先搭框架再填细节 |
| "有没有什么skill能在我写代码累的时候给我打打气" | programmer-cheerleader | 程序员专属啦啦队，负责给你打气续命 |
3.2 进阶用法
3.2.1 兼容其他Agent工具
Comate 还会从 Claude、Codex、Cursor等20多个Agent工具的目录加载技能，包括但不限于：.claude/skills/、.codex/skills/、~/.claude/skills/ 和 ~/.codex/skills/等。加载的外部Agent工具的将会被有效标示出来，在实际使用过程中和Comate原生的Skills没有任何区别。
3.2.2 将Rules迁移到Skills
通过内置的/create-skill还可以帮助你现有的Rules转换为Skills。 迁移步骤如下：
- 在 Agent 聊天中输入 /create-skill
- 输入迁移的诉求，如：转换当前仓库的Rules为Skills，你要先识别哪些可以转换并供我确认，我确认后再转换
- 在 .comate/skills/ 中查看生成的技能
- 具有 alwaysApply: true 或特定 globs 模式的规则一般不会被迁移（这并非强制），因为它们有与技能行为不同的显式触发条件。用
- 户规则也不会被迁移，因为它们不存储在文件系统中。
4. Skills的基本构成
4.1 Skills目录
Skills技能会从以下位置自动加载：
| 位置 | 作用域 |
|---|---|
| .agents/skills/ | 项目级 |
| .comate/skills/ | 项目级 |
| ~/.comate/skills/ | 用户级（全局） |
Comate提供的create-rule、create-skill、create-subagent三个系统级的Skills也在~/.comate/skills/目录下。
每个技能应为一个包含 SKILL.md 文件的文件夹：
.comate/
└── skills/
└── my-skill/
└── SKILL.md
技能还可以包含脚本、参考文件和资源等可选目录：
.comate/
└── skills/
└── deploy-app/
├── SKILL.md
├── scripts/
│ ├── deploy.sh
│ └── validate.py
├── references/
│ └── REFERENCE.md
└── assets/
└── config-template.json
4.2 SKILL.md 文件格式
每个 Skills 都在带有 YAML 前置信息（frontmatter）的 SKILL.md 文件中定义（功能、使用时机等）：
---
name: my-skill
description: 简要描述此技能的功能及使用时机。
---
# 我的技能
为 Agent 提供的详细指令。
## 使用时机
- 在以下情况使用此技能...
- 此技能适用于...
## 指令
- 为 Agent 提供的分步指导
- 特定领域的约定
- 最佳实践和模式
- 如需向用户澄清需求,请使用提问工具
4.3 Frontmatter字段
| 字段 | 必填 | 说明 |
|---|---|---|
| name | Yes | 技能标识符。仅限小写字母、数字和连字符。必须与父文件夹名称一致 |
| description | Yes | 描述技能的作用及其使用场景。由Agent用于判断相关性。 |
4.4 在Skills中包含脚本
Skills可以包含 scripts/ 目录，内含可由代理运行的可执行代码。 在 SKILL.md 文件中使用相对于Skills根目录的相对路径引用这些脚本。
---
name: deploy-app
description: 将应用部署到预发布或生产环境。在部署代码时使用,或当用户提及部署、发布或环境时使用。
---
# Deploy App
Deploy the application using the provided scripts.
## Usage
Run the deployment script: `scripts/deploy.sh <environment>`
Where `<environment>` is either `staging` or `production`.
## Pre-deployment Validation
Before deploying, run the validation script: `python scripts/validate.py`
当Skills被调用时，Agent 会读取这些指令并执行引用的脚本。脚本可以使用任何语言编写，例如 Bash、Python、JavaScript，或 Agent 实现所支持的任何其他可执行格式。
4.5 可选目录
Skills支持以下可选目录：
| 目录 | 描述 |
|---|---|
| scripts/ | Agents 可以运行的可执行代码 |
| references/ | 按需加载的附加文档 |
| assets/ | 模板、图片或数据文件等静态资源 |
请让主 SKILL.md 文件保持简洁，将详细参考资料放在单独的文件中。 这样可以更高效地利用上下文，因为 Agent 会按需逐步加载资源——只在需要时才加载。
想要解锁Comate超能力，玩转 Comate Skills，一键更新Comate ，感受AI编程的神奇吧～
更新途径一： 百度搜索“文心快码”，官网下载Comate AI IDE最新版；
更新途径二： Comate AI IDE 界面点击 “重启以更新”；
更新途径三： VS Code 或者 Jetbrains 系列 IDE 搜索文心快码插件，点击“安装”或“更新”。
