59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
# skills/ - 技能定义目录
|
||
|
||
存放数字员工的专项技能，**每个技能是一个独立子目录**，内含相关的说明文档、配置和资源文件。
|
||
|
||
## 用途
|
||
|
||
- 定义数字员工具备的专项能力（如数据分析、报表生成、日程管理等）
|
||
- 为 agent 提供结构化的任务执行指引
|
||
- 支持按需加载，只在相关场景下启用特定技能
|
||
- 每个技能目录可包含多个文件，便于组织复杂技能所需的模板、示例和配置
|
||
|
||
## 目录结构规范
|
||
|
||
```
|
||
skills/
|
||
├── data-analysis/ # 数据分析技能
|
||
│ ├── README.md # 技能说明（触发条件、执行流程）
|
||
│ ├── templates/ # 分析模板（SQL、图表模板等）
|
||
│ └── examples/ # 示例输入输出
|
||
├── report-generation/ # 报表生成技能
|
||
│ ├── README.md
|
||
│ └── templates/
|
||
├── schedule-management/ # 日程管理技能
|
||
│ └── README.md
|
||
└── README.md
|
||
```
|
||
|
||
## 技能目录模板
|
||
|
||
每个技能目录下的 `README.md` 建议包含：
|
||
|
||
```markdown
|
||
# 技能名称
|
||
|
||
## 触发条件
|
||
（什么场景下启用此技能）
|
||
|
||
## 执行步骤
|
||
（具体的操作流程）
|
||
|
||
## 依赖工具
|
||
（需要调用的工具列表）
|
||
|
||
## 所需凭证
|
||
（列举此技能运行所需的凭证名称和用途，具体值从 secrets.md 读取）
|
||
|
||
## 输出规范
|
||
（输出格式和存放位置）
|
||
|
||
## 相关文件
|
||
（本目录下的模板、配置等文件说明）
|
||
```
|
||
|
||
## 安全规范
|
||
|
||
- **技能文件中禁止包含实际的密钥、密码、Token 等敏感信息**
|
||
- 技能可以在「所需凭证」章节列举需要提供哪些凭证，但具体值统一存储在 `secrets.md` 中
|
||
- 技能中的脚本如需使用凭证，应通过环境变量注入，不得硬编码
|