# test-skills

**Repository Path**: wangbincode/test-skills

## Basic Information

- **Project Name**: test-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-21
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 对话式自动引导流程 Agent

5 步对话式引导流程，用于资源评估和规格推荐。

## 📋 流程概览

```
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Step 1     │ ──→ │  Step 2     │ ──→ │  Step 3     │
│  导入资源    │     │  资源总结    │     │  计算规格推荐 │
│  + 业务解析  │     │             │     │             │
└─────────────┘     └─────────────┘     └─────────────┘
                                              │
                                              ▼
┌─────────────┐     ┌─────────────┐
│  Step 5     │ ←── │  Step 4     │
│  兼容性评估  │     │  数据库规格  │
│  主机×数据库  │     │  推荐       │
└─────────────┘     └─────────────┘
```

## 🚀 快速开始

### 安装

```bash
npm install conversation-flow-agent
```

### 基础使用

```javascript
const { ConversationFlowAgent } = require('conversation-flow-agent');

const agent = new ConversationFlowAgent();

// 启动流程
const { sessionId, message } = await agent.startFlow('user_123');

// 处理消息
const result = await agent.handleMessage(sessionId, {
  text: '这是我的资源清单...',
  file: csvFile
});
```

## 📁 目录结构

```
conversation-flow-agent/
├── SKILL.md              # 技能说明文档
├── index.js              # 核心实现
├── USAGE_EXAMPLES.md     # 使用示例
└── README.md             # 本文件
```

## 🎯 功能特性

| 特性 | 说明 |
|------|------|
| **5 步引导流程** | 从资源导入到兼容性评估的完整流程 |
| **业务解析** | 自动识别业务场景和需求 |
| **规格推荐** | 基于使用率和增长预测推荐规格 |
| **成本估算** | 提供月度/年度成本预估 |
| **兼容性评估** | 网络/性能/版本/安全多维度评估 |
| **会话管理** | 支持多会话并发和超时处理 |
| **错误处理** | 完善的错误捕获和恢复机制 |

## 📊 步骤详情

### Step 1: 导入资源 + 业务解析

**输入：**
- 资源清单（CSV/Excel/JSON）
- 业务场景描述

**输出：**
- 结构化资源清单
- 业务场景标签
- 关键指标（QPS、存储量、并发数等）

### Step 2: 资源总结

**输入：** Step 1 输出

**输出：**
- 资源总量统计
- 平均使用率
- 识别的问题（过载/闲置/配置不当）
- 初步优化建议

### Step 3: 计算规格推荐

**输入：** Step 2 输出 + 业务上下文

**输出：**
- 推荐实例类型（S6/S7/M6/D6/G6 等）
- 具体规格（CPU/内存/带宽）
- 成本估算
- 备选方案

### Step 4: 数据库规格推荐

**输入：** Step 3 输出 + 业务上下文

**输出：**
- 推荐数据库引擎（MySQL/PostgreSQL/SQL Server/openGauss）
- 实例规格
- 存储配置
- 高可用方案
- 成本估算

### Step 5: 主机和数据库兼容性评估

**输入：** Step 3 + Step 4 输出

**输出：**
- 整体兼容性评分
- 各维度兼容性详情
- 识别的兼容性问题
- 解决建议
- 最终推荐报告

## 🔧 配置选项

```javascript
const agent = new ConversationFlowAgent({
  timeout: 3600,        // 会话超时（秒）
  autoAdvance: false,   // 是否自动推进到下一步
  allowBacktrack: true  // 是否允许返回上一步
});
```

## 📱 集成示例

### 钉钉集成

```javascript
app.post('/dingtalk/message', async (req, res) => {
  const { userId, text, file } = req.body;

  let sessionId = userSessions.get(userId);
  if (!sessionId) {
    const flow = await agent.startFlow(userId);
    sessionId = flow.sessionId;
    userSessions.set(userId, sessionId);
    await sendDingTalkMessage(userId, flow.message);
  }

  const result = await agent.handleMessage(sessionId, { text, file });
  await sendDingTalkMessage(userId, result.message);

  res.json({ success: true });
});
```

### API 接口

```http
# 启动流程
POST /api/flow/start
Content-Type: application/json

{
  "userId": "user_123",
  "metadata": {}
}

# 提交资源
POST /api/flow/{sessionId}/import
Content-Type: multipart/form-data

file: [resource_file]
description: "业务描述"

# 推进流程
POST /api/flow/{sessionId}/next
Content-Type: application/json

{
  "confirm": true
}

# 获取报告
GET /api/flow/{sessionId}/report
```

## 📈 监控指标

| 指标 | 说明 | 告警阈值 |
|------|------|----------|
| 流程完成率 | 完成 5 步的用户比例 | < 60% |
| 平均耗时 | 单会话平均耗时 | > 10 分钟 |
| 步骤流失率 | 各步骤用户流失比例 | > 30% |
| API 错误率 | 接口错误比例 | > 5% |

## ⚠️ 注意事项

1. **会话超时** - 默认 1 小时无操作自动超时
2. **数据隐私** - 资源数据仅用于本次评估
3. **成本估算** - 仅供参考，实际价格以官网为准
4. **兼容性评分** - 低于 70% 建议重新评估配置

## 📝 相关文档

- [技能说明](./SKILL.md)
- [使用示例](./USAGE_EXAMPLES.md)

## 📞 支持

如有问题，请提交 Issue 或联系客服。

---

_版本：1.0.0 | 创建于 2026-03-21_