59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
# skills/ - 技能定义目录
|
|
|
|
存放数字员工的专项技能,**每个技能是一个独立子目录**,内含相关的说明文档、配置和资源文件。
|
|
|
|
## 用途
|
|
|
|
- 定义数字员工具备的专项能力(如数据分析、报表生成、日程管理等)
|
|
- 为 agent 提供结构化的任务执行指引
|
|
- 支持按需加载,只在相关场景下启用特定技能
|
|
- 每个技能目录可包含多个文件,便于组织复杂技能所需的模板、示例和配置
|
|
|
|
## 目录结构规范
|
|
|
|
```
|
|
skills/
|
|
├── cron-schedule/ # 定时任务技能
|
|
├── feishu-file-sender/ # 飞书文件发送技能
|
|
├── feishu-wiki-access/ # 飞书知识库访问技能
|
|
├── feishu-wiki-content-reader/ # 飞书知识库内容读取技能
|
|
├── find-skills/ # 技能查找技能
|
|
├── self-improving-agent/ # 自我改进技能
|
|
├── skill-builder/ # 技能构建技能
|
|
├── timed-reminder/ # 定时提醒技能
|
|
├── use_vala_skillhub.vala/ # 瓦拉技能中心技能
|
|
└── README.md
|
|
```
|
|
|
|
## 技能目录模板
|
|
|
|
每个技能目录下的 `README.md` 建议包含:
|
|
|
|
```markdown
|
|
# 技能名称
|
|
|
|
## 触发条件
|
|
(什么场景下启用此技能)
|
|
|
|
## 执行步骤
|
|
(具体的操作流程)
|
|
|
|
## 依赖工具
|
|
(需要调用的工具列表)
|
|
|
|
## 所需凭证
|
|
(列举此技能运行所需的凭证名称和用途,具体值从 secrets.md 读取)
|
|
|
|
## 输出规范
|
|
(输出格式和存放位置)
|
|
|
|
## 相关文件
|
|
(本目录下的模板、配置等文件说明)
|
|
```
|
|
|
|
## 安全规范
|
|
|
|
- **技能文件中禁止包含实际的密钥、密码、Token 等敏感信息**
|
|
- 技能可以在「所需凭证」章节列举需要提供哪些凭证,但具体值统一存储在 `secrets.md` 中
|
|
- 技能中的脚本如需使用凭证,应通过环境变量注入,不得硬编码
|