feishu-multi-agent

# 飞书多 Agent 系统

## 你要做什么

帮用户搭建「一个飞书 Bot → 多个独立 AI Agent」的系统。每个 Agent 绑定一个飞书群聊，互相独立，可以通信。

## 读取顺序（严格按顺序）

**第一步：理解架构**
```
read("INDEX.md")       # 文档索引
read("01-architecture.md")  # 架构设计
```
读完你会知道：binding、session、agent 间通信的概念。

**第二步：收集用户信息**
```
read("10-setup-wizard.md")
read("examples/PLACEHOLDERS.md")
```
读完按 Phase 1 的问卷向用户收集信息。`PLACEHOLDERS.md` 列出了所有需要用户提供的字段。不要跳过任何问题。

**第三步：执行创建**
用户回答完问题后，运行创建脚本：
```
read("scripts/create_agent.py")
exec("python3 scripts/create_agent.py --agent-id xxx --role xxx ...")
```

**第四步：按需深入**
- 用户问飞书权限 → `read("02-feishu-setup.md")`
- 用户问 Agent 绑定 → `read("03-agent-binding.md")`
- 用户问 Agent 通信 → `read("04-agent-communication.md")`
- 用户问飞书文档 → `read("05-feishu-doc.md")`
- 用户问群聊管理 → `read("06-feishu-chat-management.md")`
- 用户问消息格式 → `read("07-feishu-message-format.md")`
- 用户问 skill 组织 → `read("08-skill-organization.md")`
- 用户问最佳实践 → `read("09-best-practices.md")`

## ⚠️ 关键注意事项

1. **不要一次读所有文件** — 按需读取，节省上下文
2. **不要跳过信息收集** — 缺少 app_id/open_id 后面全部会失败
3. **修改 openclaw.json 必须包含所有 Agent** — agents.list 是整体替换，遗漏 = 丢失
4. **创建群聊后必须注册** — 加 binding + groups 配置 + 重启 gateway
5. **Bot 创建的文档必须授权** — 否则用户看不到

## 🔧 项目维护（仅供维护者）

**如果你要修改项目本身（如添加新 Agent、修改配置格式、更新文档），必须先阅读：**

```
read("skills/maintenance/SKILL.md")
read("skills/maintenance/references/project-maintenance.md")
```

⚠️ **开发原则**（强制遵守）：
- 强制脱敏：模型 ID、内部事故记录、真实路径、API Key 等均为敏感信息，示例中用占位符
- 内容通用性：开源内容面向所有用户，不包含特定团队的内部信息
- 提交前必须运行脱敏检查：`python3 scripts/check_sensitive.py`

违反原则的提交将被拒绝合并。