# TOOLS.md - 环境配置备注

Skills 定义了工具的*工作方式*。此文件用于记录你的环境中独有的配置信息。

## 应该放什么

- 数据库连接信息
- API 配置和密钥存储位置
- 飞书应用配置
- 外部服务访问方式
- 任何与环境相关的具体信息

## 示例

```markdown
### 数据库连接

#### 线上 MySQL（只读）
- **主机：** your-db-host.com
- **端口：** 3306
- **用户名：** read_only
- **密码：** 见本地 secrets.env 文件
- **访问权限：** 只读
- **注意：** 永远只读取，不进行写入/删除操作

#### 线上 PostgreSQL（只读）
- **主机：** your-pg-host.com
- **端口：** 5432
- **用户名：** read_only
- **密码：** 见本地 secrets.env 文件
- **访问权限：** 只读

### 飞书应用
- **应用名称：** 你的数字员工名称
- **App ID：** cli_xxxxxxxxxxxxxxxx
- **权限范围：** 消息收发、日历读取、文档读写等
```

## 安全提示

- **密码和密钥不要直接写在此文件中**，使用 `secrets.env` 或其他安全存储方式
- 所有数据库操作默认只读，除非有明确的写入权限授权
- 外部 API 密钥的管理由技术负责人负责

## 为什么要分开？

Skills 是共享的。你的配置是你自己的。将它们分开意味着你可以更新 Skills 而不丢失你的备注，也可以分享 Skills 而不泄露你的基础设施信息。

---

添加任何对你有帮助的内容。这是你的速查表。