91 lines
3.0 KiB
Markdown
91 lines
3.0 KiB
Markdown
---
|
||
name: openakita/skills@skill-creator
|
||
description: 创建和改进 OpenAkita 技能。当需要：(1) 为重复性任务创建新技能，(2) 改进现有技能，(3) 将临时脚本封装为可复用技能时使用。技能是 OpenAkita 自进化的核心机制。
|
||
---
|
||
|
||
# Skill Creator — OpenAkita 技能创建指南
|
||
|
||
## 技能是什么
|
||
|
||
技能是模块化的、自包含的能力包，通过 SKILL.md 定义，扩展 OpenAkita 的能力。每个技能包含：
|
||
- `SKILL.md`（必需）：YAML frontmatter（name + description）+ Markdown 指令
|
||
- `scripts/`（可选）：可执行脚本（Python/Bash）
|
||
- `references/`（可选）：参考文档
|
||
- `assets/`（可选）：模板、图片等资源文件
|
||
|
||
## 何时创建技能
|
||
|
||
1. 同类操作第二次出现（持久化规则）
|
||
2. 用户明确要求创建技能
|
||
3. 任务涉及复杂多步流程且可能复用
|
||
4. 现有临时脚本需要升级为可复用能力
|
||
|
||
## 创建流程
|
||
|
||
### 1. 确定技能范围
|
||
|
||
明确技能要解决什么问题、触发条件是什么、需要哪些资源。
|
||
|
||
### 2. 创建技能目录
|
||
|
||
在 `skills/` 下创建目录：
|
||
|
||
```
|
||
skills/{skill-name}/
|
||
├── SKILL.md # 必需：技能定义
|
||
├── .openakita-i18n.json # 推荐：中文名和中文描述
|
||
├── scripts/ # 可选：可执行脚本
|
||
├── references/ # 可选：参考文档
|
||
└── assets/ # 可选：模板等资源
|
||
```
|
||
|
||
### 3. 编写 SKILL.md
|
||
|
||
**Frontmatter（必需）**：
|
||
```yaml
|
||
---
|
||
name: skill-name
|
||
description: 清晰描述技能功能和触发条件。description 是触发机制，必须说明"做什么"和"何时用"。
|
||
---
|
||
```
|
||
|
||
### 3.5 创建中文翻译文件（推荐）
|
||
|
||
在技能目录下创建 `.openakita-i18n.json`，提供中文显示名和描述：
|
||
```json
|
||
{
|
||
"zh": {
|
||
"name": "技能中文名（2-6个字）",
|
||
"description": "技能功能的中文描述，简洁通顺。"
|
||
}
|
||
}
|
||
```
|
||
此文件让中文用户在界面上看到友好的中文名称和说明。
|
||
|
||
**正文**：使用 Markdown 编写使用指令。原则：
|
||
- OpenAkita 已经很聪明，只写它不知道的信息
|
||
- 简洁优先，示例优于冗长解释
|
||
- 正文控制在 500 行以内，超出部分拆到 references/
|
||
|
||
### 4. 编写脚本（如需要）
|
||
|
||
将确定性操作封装为 `scripts/` 下的脚本：
|
||
- 脚本必须实际运行测试，确保无 bug
|
||
- 使用 `run_skill_script` 执行
|
||
|
||
### 5. 加载技能
|
||
|
||
创建完成后，使用 `load_skill` 将技能加载到系统中，使其在技能清单中可见。
|
||
|
||
## 改进现有技能
|
||
|
||
1. 使用 `get_skill_info` 查看当前技能内容
|
||
2. 修改 SKILL.md 或脚本文件
|
||
3. 使用 `reload_skill` 重新加载
|
||
|
||
## 关键原则
|
||
|
||
- **上下文窗口是公共资源**：技能与系统提示词、对话历史共享上下文，每一行都要值得其 token 开销
|
||
- **渐进式披露**：frontmatter 始终可见（~100词），正文仅在技能触发后加载，脚本按需执行
|
||
- **不要创建多余文件**：不需要 README.md、CHANGELOG.md 等辅助文件
|