# 调用专精策划并记录 (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 沟通都有完整记录。*