技能
写在前面：技能是什么？
技能定义
技能/Skills 是一种模块化、可复用的能力包，用于将专业知识、工作流程和标准实践打包成结构化指令与资源，使 Agent 在相关情境下自动应用这些知识来完成高质量的任务输出。
简单来说：在 markdown 文件内定义了一些工作流程或者规范，以及相关的资源（如：脚本），Agent 会根据对这个技能的描述按需自主调用。
技能与规则的区别是什么？
技能和规则都是自定义 AI 行为的方式，但它们的用途不同：
| 特征 | 技能 | 规则 |
|---|---|---|
| 目的 | 需要支持资源的复杂任务 | 行为准则和偏好 |
| 结构 | 包含 SKILL.md 和资源文件的文件夹 | 单个 .mdr 文件 |
| 调用 | 自动（渐进式披露）或 /指令触发 | 基于规则类型（始终生效 或 手动触发） |
| 适合 | 多步骤工作流程、部署流程、代码审查流程 | 编码风格偏好、项目规范、响应格式 |
技能分类
在 CodeFlicker 中支持以个人维度与项目维度分别创建技能。
1. 个人技能
- 存放位置：
~/.codeflicker/skills/<skill-name>/ - 配置的技能在所有项目内均可使用。
2. 项目技能
- 存放位置：
.codeflicker/skills/<skill-name>/ - 配置的技能仅在创建对应 Skill 的项目内使用。
如何配置技能？
1. 从其他产品导入
支持来自 Claude、Codex、Cursor、OpenCode 的技能。
步骤：在「设置」-「规则 & 技能」中确保该开关为开启状态，即可自动加载，如需手动触发，可在输入框内通过 / 唤起查看。
2. 通过 /指令 创建
插件端在「智能体」tab 下任意模式，IDE 在任意模式下，选择指令中的 /skill manager 后，用自然语言描述想创建的技能，发送后将进行创建。可创建两类技能：个人技能与项目技能，需要在对话中进行确认。
3. 手动对应路径下创建
推荐方式
更推荐使用方式 2，快捷省力。
手动创建 /skills/技能名称 的文件夹，并在该文件夹下创建 SKILL.md。
文件填写示例
注意
--- 中间的内容为文件配置的参数，在实际填写 SKILL.md 文件时请勿删除/修改，若缺失任一参数将无法被读取。
markdown
---
name: skill的名称，最多不超过 64 个字符
description: 对于该技能作用的描述，最多不超过 1024 个字符
---
Skill 的正文内容XXXXXXX参数说明
- name：技能的名称，最多不超过 64 个字符
- description：对于该技能作用的描述，最多不超过 1024 个字符
- 正文内容：详细描述技能的工作流程、使用方法、支持资源等内容