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