企服助手 (Enterprise Service Assistant)

SKILL.md

---
name: enterprise-service-assistant
description: >
  园区企业服务智能助手 Agent。一个Agent搞定园区企业服务全流程：①企业数据管理（客户档案/画像分析/风险预警）②费用催缴管理（逾期分级/催缴提醒/收缴率统计）③工单分派与SLA监控（自动分派/进度跟踪/超时升级）④C+增值服务匹配（需求挖掘/资源匹配/服务跟进）⑤走访计划管理与提醒（计划生成/任务提醒/记录归档）⑥库存监控与补货提醒（水位监控/可用月数/补货建议）⑦合同续租预警（到期识别/企业画像/续租方案）⑧KPI报告自动生成（日报/周报/月报）。支持多项目独立配置，所有本地数据必须用户自建到 workspace/knowledge-base/，不含任何真实业务数据。
version: 1.3.0
author: perrykono-debug
tags: [agent, assistant, enterprise, service, management, 企业服务, 园区管理, 费用催缴, 工单管理, 客户管理, 合同续租, 数据安全]
---

# 企服助手 (Enterprise Service Assistant)

专业的园区企业服务智能助手，提供全方位的企业服务数字化支持。

## 🎯 核心能力

### 8 大业务模块

| 模块 | 能力 | 触发方式 |
|------|------|----------|
| **客户管理** | 客户档案、画像分析、风险预警、时间线查询 | @企服助手 查询客户 / 客户画像 |
| **费用催缴** | 逾期分级、催缴提醒、收缴率统计 | @企服助手 催缴检查 / 每天10:00自动 |
| **工单调度** | 自动分派、SLA监控、超时升级 | 企业报修 / 管家上报 / 每小时监控 |
| **C+服务** | 需求挖掘、资源匹配、服务跟进 | @企服助手 服务匹配 / 走访记录触发 |
| **走访管理** | 计划生成、任务提醒、记录归档 | @企服助手 走访管理 / 每日09:00+周一09:00 |
| **库存监控** | 水位监控、可用月数、补货建议 | @企服助手 库存检查 / 每日09:00自动 |
| **合同续租** | 到期识别、企业画像、续租方案 | @企服助手 续租检查 / 提前3个月预警 |
| **KPI报告** | 日报、周报、月报自动生成 | 定时任务 / 手动触发 |

## 🔒 数据安全机制（v1.3.0 新增）

**四大铁律**：凭证不外泄、台账不外传、记忆不跨会话、群聊必脱敏。

- 🛡️ **运行时自动脱敏**：输出前自动替换企业全名→编号、金额→汇总、个人信息→星号
- 🔐 **会话隔离**：主私聊可查看全部，群聊仅可见脱敏汇总，定时任务仅引用汇总数据
- 🚨 **安全审计命令**：输入 `@企服助手 安全检查` 即触发5项扫描（凭证/URL/项目名/群聊/文件权限）
- 📊 **数据流向矩阵**：明确各类数据的读/写/输出/群聊权限

> 详细机制请参考 `references/数据安全机制.md`

## 📦 安装与配置

### 安装
```bash
clawhub install enterprise-service-assistant
```

### 配置步骤（必做！）

**本 Agent 不含任何真实数据，用户必须自行创建知识库：**

1. **创建知识库目录**: `workspace/knowledge-base/`
2. **复制模板**: `references/知识库模板.md` → `workspace/knowledge-base/PROJECT_KB.md`
3. **填写配置**:
   - 数据源 URL（Excel 台账腾讯文档链接）
   - 企微 Webhook 地址
   - 业务规则（催缴阈值、SLA 时限等）
   - 园区名称和占位符
4. **重启 OpenClaw** 加载配置

> 💡 详细引导请参考 `references/新用户引导.md`

## 🏗️ 架构设计

### 分层架构（保护隐私）

```
企服助手 Agent
├── 通用层（随 Agent 分享，本包内容）
│   ├── AGENTS.md          # 通用行为规则和工作流程
│   ├── SOUL.md            # 通用人格设定
│   ├── IDENTITY.md        # 通用身份设定
│   ├── TOOLS.md           # 通用工具说明
│   ├── HEARTBEAT.md      # 心跳配置
│   ├── MEMORY.md          # 长期记忆模板
│   └── USER.md            # 用户配置模板
│
├── references/（参考文件，纯模板）
│   ├── 知识库模板.md       # PROJECT_KB.md 填写模板
│   └── 新用户引导.md       # 首次使用引导流程
│
└── 用户本地层（❌ 不在 GitHub/ClawHub 中）
    └── knowledge-base/PROJECT_KB.md   # 用户自建的项目配置
```

### 数据安全承诺

- ✅ **本打包不包含**: `knowledge/PROJECT_KB.md`、`memory/*.md`、任何 Excel 台账、真实企业数据
- ✅ **references/ 目录**: 全部为纯模板（📝待填写），不含任何本地数据
- ✅ **用户数据安全**: 所有园区真实数据（房源、租户、报价）必须用户自建到 `workspace/knowledge-base/`
- ✅ **SKILL.md 读取逻辑**: workspace 优先 → references fallback

## 🛠️ 技能依赖

安装本 Agent 后，需确保以下技能可用：

- `tencent-docs` + `mcporter` — 腾讯文档操作
- `docx` / `pdf` / `xlsx` — 文档处理
- `qclaw-cron-skill` — 定时任务
- `online-search` — 在线搜索
- `xbrowser` — 浏览器自动化

## 📖 使用示例

```
# 客户查询
@企服助手 查询客户 T1-601
@企服助手 客户画像 上海铭尤力
@企服助手 查询风险客户

# 费用管理
@企服助手 催缴检查
@企服助手 统计费用收缴率

# 工单管理
@企服助手 查看待处理工单
@企服助手 工单超时升级

# 服务匹配
@企服助手 服务匹配
@企服助手 走访管理

# 报告生成
@企服助手 生成本月KPI报告
@企服助手 导出客户台账到腾讯文档

# 定时任务
@企服助手 设置每月1号提醒催缴
@企服助手 查看定时任务列表
```

## 🔄 版本历史

### v1.3.0 (2026-05-29)
- ✅ 新增完整运行时数据安全机制
- ✅ 四大铁律：凭证不外泄、台账不外传、记忆不跨会话、群聊必脱敏
- ✅ 运行时自动脱敏规则（企业名→编号、金额→汇总、个人信息→星号）
- ✅ 会话隔离机制（私聊/群聊/定时任务分级访问）
- ✅ 安全审计命令：`@企服助手 安全检查`
- ✅ 新增 `references/数据安全机制.md` 详细文档

### v1.2.0 (2026-05-29)
- ✅ 新增 SECURITY.md 安全声明文件
- ✅ 清理 MEMORY.md 中真实项目名称引用
- ✅ references/ 确认全部为纯模板

### v1.1.0 (2026-05-29)
- ✅ 知识库分离重构
- ✅ references/ 恢复为纯模板

### v1.0.0 (2026-05-29)
- ✅ 初始版本发布

## 📞 支持与反馈

- **更新**: `clawhub update enterprise-service-assistant`
- **卸载**: `clawhub uninstall enterprise-service-assistant`
- **Issues**: 在 ClawHub 提交

---

> ⚠️ **重要提示**: 这是通用版本，不包含任何真实项目数据。使用者必须按照 `references/知识库模板.md` 创建自己的 `knowledge-base/PROJECT_KB.md` 才能使用完整功能。