feat: 新增 account 和 plan 目录
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
90
account/admin/skills/skill-creator/SKILL.md
Normal file
90
account/admin/skills/skill-creator/SKILL.md
Normal file
@@ -0,0 +1,90 @@
|
||||
---
|
||||
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 等辅助文件
|
||||
Reference in New Issue
Block a user