# 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` 中
- 技能中的脚本如需使用凭证，应通过环境变量注入，不得硬编码
