agent-father
# 👨🍼 Agent Father Skill
**创建新 Agent 和员工的完整解决方案**，自动从 openclaw.json 读取飞书配置，包含 JSON 配置、会话管理、群组配置和岗前培训。
## 🚀 快速开始
### 创建单个员工
```bash
# 基本用法
./scripts/create-employee.sh <姓名> <工号> <电话> [描述] [初始用户]
# 示例：创建客服工程师
./scripts/create-employee.sh "客服工程师" "CS-001" "13800138000" "客服团队"
```
### 批量创建员工
```bash
# 使用批量脚本
./scripts/batch-create.sh employees.csv
```
### 删除员工
```bash
./scripts/delete-agent.sh <agent-id>
```
---
## 📋 核心脚本
### 1. create-employee.sh - 创建员工
**用法：**
```bash
./scripts/create-employee.sh <agent-name> <role> <phone> [description] [initial-user]
```
**参数：**
| 参数 | 必填 | 说明 | 示例 |
|------|------|------|------|
| agent-name | ✅ | Agent 显示名称 | `客服工程师` |
| role | ✅ | 工号/角色代码 | `CS-001` |
| phone | ✅ | 联系电话 | `13800138000` |
| description | ❌ | 群组描述 | `客服团队` |
| initial-user | ❌ | 初始成员用户 ID | `ou_xxx` |
**执行流程：**
1. ✅ 创建飞书群组
2. ✅ 创建独立工作区
3. ✅ 生成 agent.json 配置
4. ✅ 创建 IDENTITY.md 和 SOUL.md
5. ✅ 注册到 openclaw
6. ✅ 更新员工名单
---
### 2. delete-agent.sh - 删除员工
**用法：**
```bash
./scripts/delete-agent.sh <agent-id>
```
**功能：**
- 删除 agent 目录
- 删除工作区
- 从 openclaw.json 移除配置
- 从员工名单移除
- 可选：删除飞书群组
---
### 3. create-feishu-chat.sh - 创建飞书群组
**用法：**
```bash
./scripts/create-feishu-chat.sh --name "群名称" --description "描述" --users "ou_xxx,ou_yyy"
```
**参数：**
- `--name`: 群名称（必填）
- `--description`: 群描述（可选）
- `--users`: 初始成员，逗号分隔（可选）
- `--owner`: 群主用户 ID（可选）
- `--type`: 群类型 public/private/group（默认：group）
**配置：**
自动从 `~/.openclaw/openclaw.json` 读取飞书 App ID 和 App Secret
---
### 4. onboarding.sh - 员工入职培训
**用法：**
```bash
./scripts/onboarding.sh <agent-id>
```
**功能：**
- 生成岗前培训材料
- 配置工作流程
- 设置工作规范
---
## 🔧 工具函数
### list-employees - 列出所有员工
```bash
# 查看员工名单
cat ~/.openclaw/workspace/employees.json | jq '.employees[] | {id, name, phone, chatId}'
```
### get-agent-info - 获取 Agent 信息
```bash
# 查看指定 Agent 配置
cat ~/.openclaw/agents/<agent-id>/agent/agent.json | jq .
```
### check-agent-status - 检查 Agent 状态
```bash
# 检查配置是否有效
openclaw agents list --bindings
```
---
## 📁 目录结构
```
agent-father/
├── SKILL.md # 技能文档
├── QUICKSTART.md # 快速开始指南
├── scripts/
│ ├── create-employee.sh # 创建员工（主脚本）
│ ├── delete-agent.sh # 删除员工
│ ├── create-feishu-chat.sh # 创建飞书群组
│ ├── onboarding.sh # 入职培训
│ └── batch-create.sh # 批量创建
├── references/
│ ├── templates/ # 配置模板
│ └── examples/ # 使用示例
└── 修复报告.md # 问题修复记录
```
---
## 🎯 使用场景
### 场景 1: 创建新岗位
```bash
# 创建产品经理
./scripts/create-employee.sh "产品经理" "PM-001" "13900139000" "产品团队"
# 创建测试工程师
./scripts/create-employee.sh "测试工程师" "QA-001" "13700137000" "测试团队"
```
### 场景 2: 员工离职
```bash
# 删除员工（保留数据）
./scripts/delete-agent.sh cs-001
# 删除员工（包含飞书群组）
./scripts/delete-agent.sh cs-001 --delete-chat
```
---
## ⚠️ 注意事项
### 1. 命名规范
- **Agent ID**: 小写字母 + 数字 + 连字符（如：`cs-001`）
- **工号格式**: 大写字母 + 连字符 + 数字（如：`CS-001`）
- **避免使用**: `main` 是保留名称
### 2. 飞书配置
确保 `~/.openclaw/openclaw.json` 包含飞书配置：
```json
{
"channels": {
"feishu": {
"appId": "cli_xxx",
"appSecret": "xxx"
}
}
}
```
---
## 🔍 故障排查
### 问题 1: "main" is reserved
**解决**: 使用其他名称，如 `cs-001`、`dev-001`
### 问题 2: JSON 配置无效
**解决**:
```bash
openclaw status
openclaw doctor --fix
```
### 问题 3: 飞书群组创建失败
**解决**:
```bash
cat ~/.openclaw/openclaw.json | grep -A 2 feishu
openclaw channels login --channel feishu
```
---
_用 AI 赋能团队，让每个岗位都有专属智能助手。_
标签
skill
ai
