195 lines
5.9 KiB
Markdown
195 lines
5.9 KiB
Markdown
# 调用专精策划并记录 (call-specialist-with-log)
|
||
|
||
**用途：** 调用专精策划 agent 并自动记录沟通到飞书多维表格
|
||
|
||
**当以下情况时使用此 Skill：**
|
||
- 游戏策划总监需要调用任何专精策划（market-researcher, system-designer, numerics-designer, narrative-writer, level-designer, combat-designer, monetization-designer, ui-ux-designer）
|
||
- 需要确保沟通记录被完整保存到飞书多维表格
|
||
|
||
---
|
||
|
||
## 📋 使用方式
|
||
|
||
### 调用步骤
|
||
|
||
**1. 调用前准备**
|
||
|
||
记录以下信息：
|
||
- `agentId`: 要调用的专精策划 ID
|
||
- `taskType`: 任务类型（竞品分析/系统设计/数值设计/叙事设计/关卡设计/战斗设计/商业化设计/UIUX 设计）
|
||
- `message`: 任务描述内容
|
||
- `sessionId`: 当前会话 ID（从会话记录中获取）
|
||
|
||
**2. 调用专精策划**
|
||
|
||
使用 `sessions_send` 工具发送任务：
|
||
|
||
```javascript
|
||
{
|
||
"action": "sessions_send",
|
||
"agentId": "<agentId>",
|
||
"message": "<任务描述>"
|
||
}
|
||
```
|
||
|
||
**3. 创建多维表格记录（调用时）**
|
||
|
||
使用 `feishu_bitable_app_table_record` 创建记录：
|
||
|
||
```javascript
|
||
{
|
||
"action": "create",
|
||
"app_token": "Joc4bhUqEa6wJdsmevFc9YVhnH0",
|
||
"table_id": "tbloPgG6gNmSufOM",
|
||
"fields": {
|
||
"调用时间": <当前时间戳>,
|
||
"调用方": "game-director",
|
||
"被调用方": "<agentId>",
|
||
"任务类型": "<taskType>",
|
||
"会话 ID": "<sessionId>",
|
||
"任务下发时间": <当前时间戳>,
|
||
"任务下发内容": "<message>",
|
||
"调用轮次": 1,
|
||
"状态": "进行中"
|
||
}
|
||
}
|
||
```
|
||
|
||
**注意：** 时间戳格式为毫秒（如 `1773891448933`），飞书会自动格式化为日期。
|
||
|
||
**4. 收到回复后（更新记录）**
|
||
|
||
使用 `feishu_bitable_app_table_record` 更新记录：
|
||
|
||
```javascript
|
||
{
|
||
"action": "update",
|
||
"app_token": "Joc4bhUqEa6wJdsmevFc9YVhnH0",
|
||
"table_id": "tbloPgG6gNmSufOM",
|
||
"record_id": "<上一步创建的 record_id>",
|
||
"fields": {
|
||
"回复时间": <当前时间戳>,
|
||
"回复完整内容": "<agent 返回的完整内容>",
|
||
"返回结果摘要": "<简要总结>",
|
||
"耗时 (秒)": <耗时>,
|
||
"时间线": "<时间线文本>",
|
||
"状态": "已完成"
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 多维表格配置
|
||
|
||
### 表格信息
|
||
|
||
- **空间名称：** 游戏策划工作室
|
||
- **表格名称：** Agent 沟通记录
|
||
- **app_token:** `Joc4bhUqEa6wJdsmevFc9YVhnH0`
|
||
- **table_id:** `tbloPgG6gNmSufOM`
|
||
- **URL:** https://basegames.feishu.cn/base/Joc4bhUqEa6wJdsmevFc9YVhnH0
|
||
|
||
### 字段列表（与表格一致）
|
||
|
||
| 字段名 | 类型 | 必填 | 说明 |
|
||
|--------|------|------|------|
|
||
| 调用时间 | DateTime | ✅ | 调用时的时间 |
|
||
| 调用方 | 文本 | ✅ | 固定为 game-director |
|
||
| 被调用方 | 文本 | ✅ | 专精策划 ID |
|
||
| 任务类型 | 文本 | ✅ | 竞品分析/系统设计等 |
|
||
| 会话 ID | 文本 | ✅ | 关联完整会话 |
|
||
| 任务下发时间 | DateTime | ✅ | 精确到秒 |
|
||
| 任务下发内容 | 文本 | ✅ | 完整任务描述 |
|
||
| 回复时间 | DateTime | ✅ | 精确到秒 |
|
||
| 回复完整内容 | 文本 | ✅ | AI 返回的完整内容 |
|
||
| 返回结果摘要 | 文本 | ✅ | 简要总结 |
|
||
| 耗时 (秒) | 数字 | ✅ | 从下发到回复的时间 |
|
||
| 追问记录 | 文本 | ❌ | 如有追问，记录内容 |
|
||
| 时间线 | 文本 | ✅ | 完整调用过程时间线 |
|
||
| 关联文档 | 附件 | ❌ | 关联的策划文档 |
|
||
| 调用轮次 | 数字 | ✅ | 第几次调用 |
|
||
| 状态 | 文本 | ✅ | 进行中/已完成/超时 |
|
||
|
||
**注意：** 飞书多维表格字段名必须完全匹配，包括空格和标点！
|
||
|
||
---
|
||
|
||
## 🎯 完整调用流程示例
|
||
|
||
```javascript
|
||
// 1. 记录调用开始时间
|
||
const startTime = Date.now();
|
||
const startTimeStr = new Date().toISOString();
|
||
|
||
// 2. 创建多维表格记录（状态：进行中）
|
||
const record = await feishu_bitable_app_table_record({
|
||
action: "create",
|
||
app_token: "Joc4bhUqEa6wJdsmevFc9YVhnH0",
|
||
table_id: "tbloPgG6gNmSufOM",
|
||
fields: {
|
||
"调用时间": startTime,
|
||
"调用方": "game-director",
|
||
"被调用方": "system-designer",
|
||
"任务类型": "系统设计",
|
||
"会话 ID": "5fb8799a-f69a-4017-b02e-01ea6599adf7",
|
||
"任务下发时间": startTime,
|
||
"任务下发内容": "请分析《原神》的核心玩法系统设计...",
|
||
"调用轮次": 1,
|
||
"状态": "进行中"
|
||
}
|
||
});
|
||
|
||
const recordId = record.record_id;
|
||
|
||
// 3. 调用专精策划
|
||
const response = await sessions_send({
|
||
agentId: "system-designer",
|
||
message: "请分析《原神》的核心玩法系统设计..."
|
||
});
|
||
|
||
// 4. 计算耗时
|
||
const endTime = Date.now();
|
||
const duration = Math.round((endTime - startTime) / 1000);
|
||
|
||
// 5. 更新记录（状态：已完成）
|
||
await feishu_bitable_app_table_record({
|
||
action: "update",
|
||
app_token: "Joc4bhUqEa6wJdsmevFc9YVhnH0",
|
||
table_id: "tbloPgG6gNmSufOM",
|
||
record_id: recordId,
|
||
fields: {
|
||
"回复时间": endTime,
|
||
"回复完整内容": response.message,
|
||
"返回结果摘要": "分析了原神的核心玩法循环、元素反应系统、角色养成系统...",
|
||
"耗时 (秒)": duration,
|
||
"状态": "已完成",
|
||
"时间线": `[${startTimeStr}] 开始调用 system-designer\n[${startTimeStr}] 发送任务\n[${new Date().toISOString()}] 收到回复\n总耗时：${duration}秒`
|
||
}
|
||
});
|
||
```
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. **必须记录** - 每次调用专精策划都必须记录，不能遗漏
|
||
2. **分阶段记录** - 调用时创建记录，收到回复后更新记录
|
||
3. **准确计时** - 使用毫秒时间戳，确保耗时准确
|
||
4. **完整内容** - 回复完整内容字段必须包含 AI 返回的全部文本
|
||
5. **会话 ID** - 使用当前会话的 sessionId，方便追溯完整历史
|
||
|
||
---
|
||
|
||
## 🔧 调用限制
|
||
|
||
| 限制项 | 值 | 说明 |
|
||
|--------|-----|------|
|
||
| 每个专精调用次数 | ≤2 次 | 允许一次追问 |
|
||
| 单次任务总调用 | ≤5 次 | 所有专精合计 |
|
||
| 超时时间 | 600 秒 | 10 分钟超时 |
|
||
|
||
---
|
||
|
||
*此 Skill 由游戏策划工作室制定，确保所有 Agent 沟通都有完整记录。*
|